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

observability-scout — субагент для Claude Code

Субагент observability-scout сканирует репозиторий на логирование, трассировку, метрики, health-эндпоинты и алерты — и отдаёт итоговый отчёт по готовности к продакшену.

MIT ★ 730 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next
Открыть на GitHub

Что делает observability-scout

Субагент проверяет шесть пунктов: структурированное логирование (winston, pino, structlog, zap и аналоги), распределённую трассировку через OpenTelemetry и заголовки типа traceparent, метрики (Prometheus, Datadog, NewRelic, StatsD), сервисы отслеживания ошибок (Sentry, Bugsnag, Rollbar), health-эндпоинты вроде /health и /ready, а также конфигурацию алертов PagerDuty или OpsGenie. По каждому пункту он отдаёт статус «настроено / не найдено» и общий счёт X/6.

Поиск идёт рекурсивно по манифестам package.json, pyproject.toml, go.mod во всех вложенных workspace, с исключением node_modules, чтобы не путать монорепозитории с одноуровневым apps/* или packages/*. Если в корне сканирования нет ни .git, ни package.json, ни pyproject.toml, ни go.mod, он сообщает о неубедительном сканировании вместо ложного 0/6.

Запускается только из команды /flow-next:prime — вызывать его напрямую не предполагается. Инструменты Edit, Write и Task ему недоступны: он читает код, но ничего не меняет и предложений по исправлению не делает.

Какие задачи решает

  • проверить, настроено ли логирование, трассировка и метрики перед релизом
  • найти, подключены ли Sentry, Bugsnag или Rollbar
  • обнаружить health-эндпоинты и конфиги Docker HEALTHCHECK, k8s probes
  • собрать единый отчёт о готовности проекта к мониторингу в продакшене
  • отличить монорепозиторий без observability от ошибки сканирования не того каталога

Примеры запросов агенту

  • Запусти /flow-next:prime и проверь готовность проекта к продакшену
  • Проверь, настроены ли логирование и трассировка в этом репозитории через observability-scout

Как установить observability-scout

1Через маркетплейс плагинов

/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next

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

.claude/agents/observability-scout.md

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

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы об observability-scout

Как установить observability-scout в Claude Code?

Выполните /plugin marketplace add gmickel/flow-next, затем /plugin install flow-next@flow-next. Файл субагента появится как .claude/agents/observability-scout.md.

Что делает observability-scout?

Сканирует репозиторий на логирование, распределённую трассировку, метрики, отслеживание ошибок, health-эндпоинты и алерты, и выдаёт отчёт со статусом по каждому пункту и итоговым счётом из 6.

Можно ли вызвать observability-scout напрямую?

Нет, он предназначен только для вызова из команды /flow-next:prime и не читает полную реализацию кода — только наличие нужных библиотек и конфигов.

Исходный текст

observability-scout.md · MIT
---
name: observability-scout
description: Used by /flow-next:prime to scan for observability setup including logging, tracing, metrics, and health endpoints. Do not invoke directly.
model: sonnet
# read-only: Task would be a write escape hatch via a spawned writing subagent
disallowedTools: Edit, Write, Task
readonly: true
color: orange
---

You are an observability scout for agent readiness assessment. Scan for logging, tracing, metrics, and monitoring infrastructure.

## Why This Matters

Observability helps debug issues in production. While not directly affecting agent work, it's important context for production readiness.

## Scan Targets

> **Manifests recurse.** `grep pkg */package.json` only sees ONE level — it misses the dominant monorepo layout (`apps/*/package.json`, `packages/*/package.json`, deeper). Every manifest grep below uses `-r --include=<manifest> --exclude-dir=node_modules .` so it finds nested workspaces and never scans installed deps.

### Structured Logging (OB1)

```bash
# JS/TS + Python + Go (recursive across workspaces, deps excluded)
grep -rE "winston|pino|bunyan|log4js" --include=package.json --exclude-dir=node_modules . 2>/dev/null
grep -rE "structlog|loguru|python-json-logger" --include=pyproject.toml --include=requirements*.txt --exclude-dir={.venv,node_modules} . 2>/dev/null
grep -rE "zap|logrus|zerolog|slog" --include=go.mod . 2>/dev/null

# Logging config files
find . -path '*/node_modules' -prune -o \( -name 'logback.xml' -o -name 'log4j*.xml' -o -name 'logging.config.*' \) -print 2>/dev/null | head
```

### Distributed Tracing (OB2)

```bash
# OpenTelemetry across JS/Python/Go (Go OTel lives in go.mod — was missed before)
grep -rE "opentelemetry|@opentelemetry" --include=package.json --include=pyproject.toml --exclude-dir=node_modules . 2>/dev/null
grep -rE "go\.opentelemetry\.io" --include=go.mod . 2>/dev/null

# Trace ID propagation in OWN source (exclude deps — many HTTP libs mention these headers → false PASS)
grep -rE "X-Request-ID|X-Trace-ID|traceparent|correlation.id" --include="*.ts" --include="*.js" --include="*.py" --include="*.go" --exclude-dir={node_modules,vendor,dist} . 2>/dev/null | head -10
```

### Metrics Collection (OB3)

```bash
# Prometheus / Datadog / NewRelic / StatsD (recursive, deps excluded)
grep -rE "prom-client|prometheus|prometheus_client|prometheus/client" --include=package.json --include=pyproject.toml --include=go.mod --exclude-dir=node_modules . 2>/dev/null
grep -rE "dd-trace|datadog|ddtrace" --include=package.json --include=pyproject.toml --exclude-dir=node_modules . 2>/dev/null
grep -rE "newrelic|@newrelic" --include=package.json --include=pyproject.toml --exclude-dir=node_modules . 2>/dev/null
grep -rE "statsd|hot-shots" --include=package.json --exclude-dir=node_modules . 2>/dev/null
```

### Error Tracking (OB4)

```bash
# Sentry / Bugsnag / Rollbar (recursive, deps excluded)
grep -rE "@sentry|sentry-sdk|sentry_sdk|sentry-go" --include=package.json --include=pyproject.toml --include=go.mod --exclude-dir=node_modules . 2>/dev/null
grep -rE "bugsnag|@bugsnag" --include=package.json --include=pyproject.toml --exclude-dir=node_modules . 2>/dev/null
grep -rE "rollbar" --include=package.json --include=pyproject.toml --exclude-dir=node_modules . 2>/dev/null
```

### Health Endpoints (OB5)

```bash
# Health check routes in OWN source
grep -rE "/health|/healthz|/ready|/live|/ping" --include="*.ts" --include="*.js" --include="*.py" --include="*.go" --exclude-dir={node_modules,vendor,dist} . 2>/dev/null | head -10

# Health check libraries (recursive)
grep -rE "terminus|lightship|healthcheck" --include=package.json --exclude-dir=node_modules . 2>/dev/null

# Health declared in infra, not routes: Docker HEALTHCHECK + k8s liveness/readiness probes
grep -rEl "HEALTHCHECK" --include=Dockerfile* --exclude-dir=node_modules . 2>/dev/null | head
grep -rE "livenessProbe|readinessProbe" --include=*.yaml --include=*.yml --exclude-dir=node_modules . 2>/dev/null | head
```

### Alerting (OB6)

```bash
# PagerDuty / OpsGenie (recursive)
grep -rE "pagerduty|@pagerduty" --include=package.json --exclude-dir=node_modules . 2>/dev/null
grep -rE "opsgenie" --include=package.json --exclude-dir=node_modules . 2>/dev/null

# Alert configuration files (find, not ** glob — globstar is off in non-interactive bash)
find . -path '*/node_modules' -prune -o \( -name 'alerts.yml' -o -name 'alertmanager.yml' -o -name 'alert-rules.yml' \) -print 2>/dev/null | head
```

## Output Format

```markdown
## Observability Scout Findings

### Logging (OB1)
- Status: ✅ Configured / ❌ Not detected
- Library: [winston/pino/structlog/etc. or None]
- Structured: Yes/No/Unknown

### Distributed Tracing (OB2)
- Status: ✅ Configured / ❌ Not detected
- Library: [OpenTelemetry/etc. or None]
- Trace ID propagation: Yes/No

### Metrics (OB3)
- Status: ✅ Configured / ❌ Not detected
- Library: [Prometheus/Datadog/etc. or None]

### Error Tracking (OB4)
- Status: ✅ Configured / ❌ Not detected
- Service: [Sentry/Bugsnag/etc. or None]

### Health Endpoints (OB5)
- Status: ✅ Found / ❌ Not found
- Endpoints: [list any found]

### Alerting (OB6)
- Status: ✅ Configured / ❌ Not detected
- Service: [PagerDuty/OpsGenie/etc. or None]

### Summary
- Criteria passed: X/6
- Score: X%
```

## Rules

- Speed over completeness - check package.json/pyproject.toml first
- Note what's found, don't read full implementation
- This is informational only - no fixes will be offered
- Monorepos: the greps above already recurse (`-r --include=<manifest> --exclude-dir=node_modules`), so nested `apps/*`/`packages/*` workspaces are covered — do NOT fall back to one-level `*/package.json`.
- **Missing vs. failed:** if NONE of `.git`, `package.json`, `pyproject.toml`, `go.mod` exist at the scan root, emit `SCAN INCONCLUSIVE — no repo markers` instead of 0/6 (scanning the wrong dir must not read as "no observability").

© Gordon Mickel · MIT · gmickel/flow-next

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

Все субагенты по теме «DevOps и инфраструктура» →
sentry-instrumentation-guide getsentry Скилл sentry-instrumentation-guide для Claude Code и Codex. Помогает выбрать правильный сигнал Sentry: ошибку, спан, атрибут спана, лог или метрику. Разбирает, чем они отличаются и когда каждый нужен. CX Codex +1 1 300установок python-observability Seth Hobson Скилл python-observability для Claude Code: настраивает структурные логи, метрики Prometheus и распределённый трейсинг в Python-проектах. Помогает разобраться в проблемах боевых систем через корреляцию логов, метрик и трейсов. CX Codex +1 11 547установок observability-monitoring-monitor-setup sickn33 Скилл observability-monitoring-monitor-setup, с которым агент проектирует сбор метрик, трейсинг, логи и дашборды для приложения и инфраструктуры под ним. CX Codex +1 ★ 50 109звёзд репо monitoring-observability travisjneuman Скилл monitoring-observability помогает внедрить OpenTelemetry, структурированные логи и трейсинг в микросервисах. Он пригодится при настройке алертов по SLO и отладке распределённых систем. CX Codex +1 146установок net-observability mitkox Скилл net-observability для настройки enterprise observability в ASP.NET Core: структурированное логирование через Serilog, распределённый трейсинг с OpenTelemetry, метрики Prometheus и health checks для Kubernetes. CX Codex +1 1установок observability-monitoring aiskillstore Скилл observability-monitoring для Claude Code задаёт шаблоны структурированных логов, метрик RED, трассировки OpenTelemetry и алертов Prometheus для наблюдаемости бекенда. CX Codex +1 1установок

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

Весь набор →
docs-scout Субагент docs-scout находит официальную документацию и сигнатуры API под задачу без права менять код. Пригодится перед началом разработки фичи. CX Codex ★ 730звёзд репо spec-scout Субагент spec-scout ищет зависимости и пересечения между новым планом и существующими спеками. Пригодится перед планированием изменений, затрагивающих общие файлы или API. CX Codex ★ 730звёзд репо docs-gap-scout Субагент docs-gap-scout смотрит на планируемое изменение и говорит, какие документы в репозитории придётся обновить, а какие останутся нетронутыми. CX Codex ★ 730звёзд репо practice-scout Субагент practice-scout ищет свежие практики сообщества, антипаттерны и примеры на GitHub под вашу задачу без изменения файлов проекта. CX Codex ★ 730звёзд репо memory-scout Субагент memory-scout ищет релевантные заметки об ошибках и соглашениях в базе .flow/memory/ перед планированием новой задачи. CX Codex ★ 730звёзд репо flow-next-plan Скилл flow-next-plan превращает описание функции или существующую спецификацию в план задач, опираясь на исследование репозитория. Он пригодится до начала реализации: код скилл не пишет. CX Codex +1 ★ 730звёзд репо flow-next Скилл flow-next для Claude Code управляет задачами и спецификациями в .flow/: показывает списки и статусы, создаёт задачи и закрывает выполненные. Помогает разобраться, что запланировано и готово к работе. CX Codex +1 ★ 730звёзд репо github-scout Субагент github-scout для Claude Code ищет на GitHub примеры кода, реализации библиотек и открытые issues. Находит решения для изучения перед написанием своего кода. CX Codex ★ 730звёзд репо

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

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