# observability-engineer

Субагент observability-engineer настраивает метрики, логи и трейсы через OpenTelemetry, строит дашборды и чистит алерты от шума.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 489 у репозитория
- Автор: josstei
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/josstei/maestro-orchestrate/tree/HEAD/antigravity/src/agents/observability-engineer.md
- Обновлён: 2026-10-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/observability-engineer

## Что делает

Субагент берёт на себя задачи по observability: инструментирует сервис через OpenTelemetry SDK, настраивает коллектор, строит дашборды в Grafana, Datadog, Cloud Monitoring или New Relic по пользовательским сценариям, а не по командам. Для алертов использует burn-rate пороги вместо срабатывания по одному отклонению и требует привязку каждого алерта к SLO и раннбуку.

Методология строится на RED-метриках (rate, errors, duration) как главном сигнале, а инфраструктурные метрики по USE-методу идут вторым слоем для диагностики насыщения. Логи субагент держит низкокардинальными, а детальный контекст переносит в трейсы со связкой exemplar-метрика-трейс. Для сэмплирования трейсов по умолчанию предлагает tail-based с уклоном в сторону ошибок для продакшена и head-based — для edge-слоёв с низкой стоимостью.

Есть жёсткие ограничения: не добавлять user ID или request ID как метки метрик, не отправлять PII во внешние системы телеметрии без слоя редакции, не вводить алерты без раннбука и привязки к SLO. При росте кардинальности метрик больше 10% в неделю субагент сигнализирует — это обычно значит, что в коде появилась неограниченная метка.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/observability-engineer.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/observability-engineer.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/observability-engineer.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/josstei/maestro-orchestrate/tree/HEAD/antigravity/src/agents/observability-engineer.md

## Когда брать
- инструментировать сервис через OpenTelemetry SDK и коллектор
- собрать дашборд в Grafana или Datadog по пользовательским сценариям
- перенастроить алерты с burn-rate порогами и привязкой к SLO
- разобрать причину шторма алертов и убрать дублирующие правила
- выбрать стратегию сэмплирования трейсов между head-based и tail-based

## Примеры запросов агенту
- Добавь OpenTelemetry трейсинг и метрики в order service
- Проведи аудит алертов: за неделю было 140 пейджей по одному инциденту
- Спроектируй SLO-дашборд по RED-метрикам для сервиса оплат

## Похожие
- [observability-cloud-planning](https://affpapa.org/nevibecode/skills/observability-cloud-planning.md) — скилл · ★ 85 у репозитория
- [observability-service-reliability](https://affpapa.org/nevibecode/skills/observability-service-reliability.md) — скилл · 1500 установок
- [app-observability](https://affpapa.org/nevibecode/skills/app-observability.md) — скилл · 4800 установок
- [observability-setup](https://affpapa.org/nevibecode/skills/observability-setup.md) — скилл · 289 установок
- [observability-sre](https://affpapa.org/nevibecode/skills/observability-sre.md) — скилл · 165 установок
- [application-performance-observability-engineer](https://affpapa.org/nevibecode/agents/application-performance-observability-engineer.md) — субагент · ★ 42780 у репозитория

Из того же набора: [josstei/maestro-orchestrate](https://affpapa.org/nevibecode/by/josstei/maestro-orchestrate.md) — 40 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
