agent-session-monitor

Real-time agent conversation monitoring - monitors Higress access logs, aggregates conversations by session, tracks token usage. Supports web interface for viewing complete conversation history and costs. Use when users ask about current session token consumption, conversation history, or cost statistics.

1. Zainstaluj umiejętność w swoim środowisku agenta Claude, klonując repozytorium Alibaba Higress i umieszczając folder agent-session-monitor w katalogu skills.

2. Uruchom monitoring w tle, wskazując ścieżkę do logów dostępu Higress: python3 main.py --log-path /var/log/proxy/access.log --output-dir ./sessions. Narzędzie automatycznie będzie parsować nowe wpisy ai_log, obsługiwać rotację logów (access.log.1~5) i przechowywać dane sesji.

3. Skonfiguruj zadanie cron do ciągłego parsowania logów co minutę, aby zapewnić rzeczywisty monitoring: * * * * * python3 /path/to/main.py --log-path /var/log/proxy/access.log --output-dir /var/lib/sessions.

4. Uruchom interfejs webowy, aby wyświetlić wizualizację sesji i statystyki kosztów tokenów. Interfejs umożliwia przeglądanie przeglądu wszystkich sesji oraz drążenie w dół do szczegółów każdej rozmowy.

5. Gdy użytkownik pyta o zużycie tokenów w bieżącej sesji, historię rozmów lub statystyki kosztów, agent automatycznie generuje linki obserwacji na podstawie identyfikatora sesji i wyświetla dane z interfejsu webowego.

6. Opcjonalnie filtruj logi po konkretnym identyfikatorze sesji: python3 main.py --log-path /var/log/proxy/access.log --session-key u003csession-idu003e, aby analizować pojedyncze sesje.