AIKraft/AI/Войти
AIKraft/Skills/golang-observability

golang-observability

Наблюдаемость Go-сервисов: структурированное логирование (slog), метрики (Prometheus), трассировка (OpenTelemetry), профилирование (pprof/Pyroscope) и дашборды Grafana. Применяется для настройки мониторинга, алертинга, миграции логгеров и GDPR-совместимого трекинга.

samber official Разработка ★ 3.4k

Что делает навык

Skill обеспечивает наблюдаемость Go-сервисов через структурированное логирование (slog), метрики (Prometheus), трассировку (OpenTelemetry), профилирование (pprof/Pyroscope) и RUM. Он позволяет добавлять инструменты мониторинга в код, проверять их наличие в PR и проводить аудит покрытия сигналами.

Когда применять

  • Добавление наблюдаемости в новые или существующие Go-сервисы (инструментация)
  • Проверка pull request на наличие корректных метрик, спанов и структурированных логов
  • Аудит покрытия кодовой базы сигналами наблюдаемости с использованием параллельных субагентов
  • Настройка профилирования и дашбордов для диагностики производительности
  • Миграция логгеров и обеспечение GDPR-совместимого трекинга

Как работает

  1. Определить режим работы: Coding (добавление инструментов), Review (проверка PR) или Audit (аудит покрытия)
  2. В режиме Coding последовательно объявлять метрики, добавлять спаны, настраивать структурированное логирование и подключать pprof
  3. В режиме Review последовательно проверять, что новые коды экспортируют ожидаемые сигналы (метрики, спаны, логи)
  4. В режиме Audit запустить до 5 параллельных субагентов для проверки покрытия метриками, логированием, трассировкой, профилированием и RUM
  5. Собрать и объединить результаты проверки покрытия сигналами
  6. При использовании библиотек обращаться к официальной документации для актуальных сигнатур API

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

Добавь наблюдаемость в этот Go-сервис: настрой slog, Prometheus метрики и OpenTelemetry трассировку.
Проверь этот PR на наличие корректной инструментации: объявлены ли метрики, закрываются ли спаны и консистентны ли поля логов.
Проведи аудит покрытия кодовой базы сигналами наблюдаемости, запустив параллельные проверки для метрик, логов, трассировки, профилирования и RUM.

Что понадобится

  • Для режима Audit на Claude Code требуется использование ultracode для явного выбора многоагентной оркестрации

Описание составлено по SKILL.md навыка, сверено 07.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «golang-observability» из репозитория: # https://github.com/samber/cc-skills-golang
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r golang-observability/ ~/.claude/skills/golang-observability/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.