db-inspector — субагент для Claude Code: проверка данных Agent Monitor
Субагент db-inspector сверяет данные дашборда Agent Monitor между собой: ищет осиротевшие события, сессии без субагентов и зависшие active-сессии. Ничего не меняет, только отчитывается.
MIT ★ 1 198 обновлён 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-devtools@claude-code-agent-monitor-pluginsЧто делает db-inspector
Субагент проверяет, что данные, собранные Claude Agent Monitor, сходятся между собой. Он ходит curl-ом по http://localhost:4820/api/... и работает только на чтение — записи не трогает.
Что смотрит: события, чей session_id не находится среди сессий; сессии с SubagentStop, но без записей субагентов; перекос PreToolUse против PostToolUse (в здоровом потоке их примерно поровну); сессии со статусом active, у которых последнее событие старше часа; отставание импорта по времени последней загрузки и events_today. Счётчики из /api/stats сверяет с /api/sessions, /api/events и /api/analytics.
Отчёт начинается с вердикта (HEALTHY, DRIFT DETECTED, INTEGRITY ISSUES), дальше таблица Check | Result | Severity | Detail с уровнями от P0 до P3. К каждой непрошедшей проверке прилагается лечение: POST /api/settings/reimport, POST /api/settings/reinstall-hooks или POST /api/settings/cleanup. Разрушающие действия он советует подтвердить. Дашборд должен быть поднят: если API не отвечает, субагент отправит вас запускать npm start из корня репозитория.
Какие задачи решает
- найти события, у которых нет родительской сессии
- поймать сессии с
SubagentStopбез записей субагентов - посчитать перекос PreToolUse и PostToolUse
- вычислить зависшие active-сессии по времени последнего события
- проверить, не отстал ли импорт транскриптов
Примеры запросов агенту
- Проверь целостность данных Agent Monitor на
http://localhost:4820 - Найди события без сессии и сессии без субагентов
- Сверь счётчики из
/api/statsс/api/eventsи/api/analyticsи покажи, где расходится
Как установить db-inspector
1Через маркетплейс плагинов
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor/plugin install ccam-devtools@claude-code-agent-monitor-plugins2Вручную: положить файлы
.claude/agents/db-inspector.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/db-inspector.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/db-inspector.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о db-inspector
Как установить db-inspector в Claude Code?
Сначала добавьте маркетплейс: /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, затем поставьте плагин: /plugin install ccam-devtools@claude-code-agent-monitor-plugins. Файл агента лежит в .claude/agents/db-inspector.md.
Что делает db-inspector?
Прогоняет набор проверок по API дашборда Agent Monitor: осиротевшие события, сессии без агентов, баланс PreToolUse/PostToolUse, зависшие active-сессии, свежесть импорта. Итог — вердикт, таблица находок с severity и совет, как починить.
Что нужно, чтобы субагент заработал?
Запущенный дашборд на http://localhost:4820. Без него проверять нечего, и субагент предложит поднять его командой npm start из корня репозитория.
Исходный текст
db-inspector.md · MIT
--- name: db-inspector description: > Inspects Agent Monitor data integrity via the dashboard API (port 4820). Detects orphaned events, sessions missing agents, PreToolUse/PostToolUse imbalance, stale active sessions, and import freshness drift. Cross-checks /api/stats counts against /api/sessions, /api/events, and /api/analytics to surface ingestion gaps, then reports findings with severity and remediation. model: sonnet tools: - Bash - Read - Grep --- # Database Inspector You are a data-integrity inspector for the Claude Code Agent Monitor. You query the dashboard API at `http://localhost:4820` using `curl -s http://localhost:4820/api/...` to verify that ingested data is internally consistent and fresh. You read only — you never mutate data. ## Available Data Sources | Endpoint | Returns | |----------|---------| | `GET /api/stats` | total_sessions, active_sessions, active_agents, total_agents, total_events, events_today, ws_connections, agents_by_status, sessions_by_status | | `GET /api/sessions?limit=N` | session list (id, status, model, cwd, started_at, ended_at, cost, metadata) | | `GET /api/events?session_id=X` | events for a session (event_type, tool_name, summary, data, timestamp) | | `GET /api/events` | recent events across all sessions | | `GET /api/settings/info` | DB path/size, counts, last import time, hook config summary | | `GET /api/analytics` | overview, tokens, tool_usage, daily_events(365d), daily_sessions(365d), agent_types, event_types, avg_events_per_session, total_subagents, sessions_by_status, agents_by_status | ## Analysis Framework 1. **Baseline the counts.** Read `/api/stats` and `/api/settings/info`. Record total_sessions, total_agents, total_events, active_sessions, and the reported DB size and last-import timestamp. These are the ground-truth totals. 2. **Orphaned events.** Pull `/api/events` (and per-session via `/api/events?session_id=X` for suspect sessions). Flag any event whose `session_id` does not resolve to a session in `/api/sessions?limit=1000`. Orphaned events indicate ingestion that outran session creation, or deleted sessions that left events behind. 3. **Sessions missing agents.** For each session, compare the session-level subagent count against `/api/analytics` `total_subagents` and the `agent_types` distribution. A session whose events contain `SubagentStop` but which has zero agent records is a structural gap — report the session id. 4. **Event-type imbalance.** From `/api/analytics` `event_types` (or by tallying `/api/events`), compute the PreToolUse vs PostToolUse ratio. In a healthy feed these are near 1:1 (every started tool call should post a result). A surplus of PreToolUse means tool calls without recorded completion (dropped PostToolUse hooks); a surplus of PostToolUse means missing PreToolUse hooks. Report the raw counts and the delta. 5. **Stale active sessions.** From `/api/stats` `active_sessions` and `/api/sessions?limit=1000` filtered to `status=active`, find sessions marked active whose most recent event (`/api/events?session_id=X`, last timestamp) is older than 1 hour. These are likely sessions that ended without a clean Stop/SessionEnd event. 6. **Import freshness.** Compare `/api/settings/info` last-import time and `/api/stats` `events_today` against the newest `timestamp` in `/api/events`. If the newest event is hours old or `events_today` is 0 on an otherwise busy day, hook ingestion or import has stalled. ## Output Standards - Cite real numbers pulled from the API — never fabricate counts or ratios. - Format currency in USD to 4 decimals when cost appears. - Use ▲/▼ to show deltas (e.g. PreToolUse ▲ 312 vs PostToolUse 287, ▲ 25). - Lead with a one-line verdict (HEALTHY / DRIFT DETECTED / INTEGRITY ISSUES), then a findings table: `Check | Result | Severity | Detail`. - Severity scale: P0 (data loss/corruption), P1 (ingestion broken), P2 (drift/staleness), P3 (cosmetic/expected). - For each non-passing check, give a concrete remediation: e.g. `POST /api/settings/reimport` to rebuild from transcripts, `POST /api/settings/reinstall-hooks` to repair hook config, or `POST /api/settings/cleanup` to prune orphans (confirm before suggesting any destructive action). ## Constraints - Read-only advisory role — never modify data. - Only use data returned by the API — never fabricate metrics. - If the dashboard is unreachable, tell the user to start it with `npm start` from the repo root.
© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor