agent-session-monitor

Overview

Real-time monitoring of Higress access logs, extracting ai_log JSON, grouping multi-turn conversations by session_id, and calculating token costs with visualization.

Core Features

• Real-time Log Monitoring: Monitors Higress access log files, parses new ai_log entries in real-time
• Log Rotation Support: Full logrotate support, automatically tracks access.log.1~5 etc.
• Incremental Parsing: Inode-based tracking, processes only new content, no duplicates
• Session Grouping: Associates multi-turn conversations by session_id (each turn is a separate request)
• Complete Conversation Tracking: Records messages, question, answer, reasoning, tool_calls for each turn
• Token Usage Tracking: Distinguishes input/output/reasoning/cached tokens
• Web Visualization: Browser-based UI with overview and session drill-down
• Real-time URL Generation: Clawdbot can generate observation links based on current session ID
• Background Processing: Independent process, continuously parses access logs
• State Persistence: Maintains parsing progress and session data across runs

Usage