К основному содержанию
субагент CX Codex

db-inspector — субагент для Claude Code: проверка данных Agent Monitor

Субагент db-inspector сверяет данные дашборда Agent Monitor между собой: ищет осиротевшие события, сессии без субагентов и зависшие active-сессии. Ничего не меняет, только отчитывается.

MIT ★ 1 198 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-devtools@claude-code-agent-monitor-plugins
Открыть на GitHub

Что делает 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-plugins

2Вручную: положить файлы

.claude/agents/db-inspector.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты 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

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
ops-inspector TencentCloudBase Скилл ops-inspector для проверки здоровья CloudBase-окружения: анализирует логи, интерпретирует алармы (нормальна ли CPU, какой пик QPS), подбирает сценарии для ошибок 429, timeout, 404, ACCESS_TOKEN_INVALID и нулевых вызовов. CX Codex +1 175установок bmad-run-inspector tronghieu Скилл bmad-run-inspector читает артефакты bmad-loop из .bmad-loop/runs/ — логи, журналы, состояние задач. Помогает понять, что происходит в живом цикле агента и почему прошлый запуск сломался. CX Codex +1 ★ 117звёзд репо hormuz-strait himself65 Скилл hormuz-strait для Claude Code проверяет статус Ормузского пролива и данные о судоходстве, нефти и рисках. Включается на вопросы о Персидском заливе, морских маршрутах и перебоях поставок. CX Codex +1 3 600установок x-twitter-scraper Xquik Скилл x-twitter-scraper получает данные из X через Xquik: ищет посты, находит пользователей, скачивает медиа и выполняет подтверждённые действия. CX Codex +1 124установок posthog-cost-tuning Jeremy Longshore Скилл posthog-cost-tuning считает, за что PostHog выставляет счёт, и режет шум в захвате событий, не теряя данные, нужные для решений. CX Codex +1 1установок skill-inspector NVIDIA Скилл skill-inspector проверяет скилл перед установкой на предмет уязвимостей, избыточных прав и скрытого поведения. Использует статический анализ NVIDIA SkillSpector и семантическую проверку агента. CX Codex +1 2 500установок

Из того же набора155

Весь набор →
reliability-engineer Субагент reliability-engineer проверяет надёжность сессий Claude Code через Agent Monitor: считает SLO, ищет сбои инструментов и моделей, а также проблемы с хуками. CX Codex ★ 1 198звёзд репо file-headers Скилл file-headers для Claude Code добавляет в каждый создаваемый или изменяемый файл заголовок с описанием и автором, поддерживая единый формат копирайта в репозитории. CX Codex +1 ★ 1 198звёзд репо orchestration-analyst Субагент orchestration-analyst для анализа мультиагентных сессий. Строит граф вызовов DAG, ищет узкие места параллелизации и трассирует распространение ошибок по метрикам локального монитора. CX Codex ★ 1 198звёзд репо session-investigator Субагент session-investigator для Claude Code, Codex и Cursor разбирает сессию по данным Agent Monitor: стоимость, дерево агентов, события, транскрипт и аномалии. Ищет причины сбоев. CX Codex ★ 1 198звёзд репо token-economist Субагент token-economist анализирует расходы токенов и кэш в Claude Code через дашборд Agent Monitor, переводя метрики сессий в понятные расчёты экономии в долларах. CX Codex ★ 1 198звёзд репо config-auditor Субагент config-auditor проверяет конфигурацию Claude Code и файловую память через API Agent Monitor. Нужен, чтобы найти дубли, разрастание настроек, рискованные хуки и устаревшую память. CX Codex ★ 1 198звёзд репо budget-sentinel Субагент budget-sentinel сравнивает реальные траты Claude с заданным бюджетом, прогнозирует конец месяца и показывает, какие сессии тянут расход вверх. CX Codex ★ 1 198звёзд репо wiki-i18n Правило wiki-i18n контролирует переводы статической вики на китайский, вьетнамский, корейский и испанский языки при правках HTML и скриптов проекта. CX Codex +1 ★ 1 198звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой