usage-trends

1# Usage Trends
2 
3Analyze usage patterns and trends from the Agent Monitor analytics data.
4 
5## Input
6 
7The user provides: **$ARGUMENTS**
8 
9Options: "last 7 days", "last 30 days", "last quarter", "peak hours", "tool trends", "model usage".
10 
11## Data Sources
12 
13| Endpoint | Returns |
14|----------|---------|
15| `GET /api/analytics` | Comprehensive analytics object (see schema below) |
16| `GET /api/stats` | `{ total_sessions, active_sessions, active_agents, total_agents, total_events, events_today, ws_connections, agents_by_status, sessions_by_status }` |
17| `GET /api/sessions?limit=200` | Full session records with timestamps and metadata |
18 
19### Analytics response schema (`GET /api/analytics`)
20 
21```json
22{
23  "overview": { "total_sessions", "active_sessions", "active_agents", "total_agents", "total_events" },
24  "tokens": {
25    "total_input": N, "total_output": N,
26    "total_cache_read": N, "total_cache_write": N
27  },
28  "tool_usage": [{ "tool_name": "...", "count": N }],  // top 20
29  "daily_events": [{ "date": "YYYY-MM-DD", "count": N }],  // 365 days
30  "daily_sessions": [{ "date": "YYYY-MM-DD", "count": N }],  // 365 days
31  "agent_types": [{ "subagent_type": "task"|"explore"|null, "count": N }],
32  "event_types": [{ "event_type": "PreToolUse"|"PostToolUse"|..., "count": N }],
33  "avg_events_per_session": N,
34  "total_subagents": N,
35  "sessions_by_status": { "active": N, "completed": N, "error": N, "abandoned": N },
36  "agents_by_status": { "working": N, "completed": N, "error": N, ... }
37}
38```
39…