OpenTelemetry Skill
Скилл настраивает OpenTelemetry: коллектор, выборку, безопасность и поток телеметрии из ИИ-агентов, не засоряя контекст.
- 54 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Скилл дает справочные знания, но сгенерированные конфигурации коллектора надо проверять перед выкаткой.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/opentelemetry-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл дает справочные знания, но сгенерированные конфигурации коллектора надо проверять перед выкаткой.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`OpenTelemetry Skill` учит агента думать о наблюдаемости до того, как он напишет конфигурацию. `SKILL.md` работает как маршрутизатор: он заставляет сначала оценить пропускную способность, кардинальность и отказоустойчивость, а подробные справочники подгружает только по теме. Среди них архитектура, коллектор, инструментирование, безопасность, выборка, язык преобразований `OTTL` и совместимость. Есть руководства по развертыванию для `Kubernetes`, `ECS`, `Docker` и виртуальных машин, правила защиты от взрыва метрик, удаление персональных данных и настройка `TLS.` Отдельный справочник описывает мониторинг самих ИИ-агентов: `Claude Code`, `Gemini` CLI, `Codex`, `GitHub Copilot` и других. Скилл тестируется на 20 с лишним сценариях.
Для кого. Инженерам `SRE` и разработчикам, которые разворачивают `OpenTelemetry Collector` и хотят, чтобы агент выдавал рабочие конфигурации вместо выдуманных.
Подходит, если
- Шлюз для `tail sampling` разворачивают в `Kubernetes` с балансировкой по `traceID`.
- В метриках растет кардинальность, и нужно ограничить стоимость.
- Из логов и трасс убирают персональные данные до отправки в хранилище.
- Телеметрию `Claude Code` или `Codex` отправляют в общий коллектор.
Не подходит, если
- Нужен готовый продукт мониторинга, а не знания об `OpenTelemetry.`
- Используется стек без `OpenTelemetry.`
- Конфигурацию собираются выкатывать без проверки на тестовой среде.
Пример запроса к агенту
Нужен шлюз `OpenTelemetry` в `Kubernetes` для `tail sampling` с политиками по ошибкам и задержке. Спроси про пропускную способность, подбери число реплик и дай команды проверки.Ограничения
Для установки через `npx skills add` нужны `Node.js` 22.20 или новее и `npm.` Пространство имен `gen_ai.*` в `OpenTelemetry` пока экспериментальное, названия атрибутов могут измениться. Покрытие трасс у ИИ-агентов разное: `Claude Code` выдает логи и метрики, а трассы пока в бета-режиме, версию нужно проверять. `Tail sampling` расходует память по числу трасс в обработке, регулярные выражения `OTTL` влияют на задержку `p99.` Проверяйте конфигурации на тестовой нагрузке.
Как отключить. Удалите каталог скилла из `.claude/skills/` или `.agents/skills/`. Сгенерированные конфигурации коллектора остаются в вашем репозитории и удаляются отдельно.
Частые вопросы
Как проверить без установки?
Выполните `npx skills add o11y-dev/opentelemetry-skill --list`: установщик покажет найденный скилл и ничего не поставит.
Что такое прогрессивная загрузка?
`SKILL.md` остается короткой инструкцией, а подробные справочники подгружаются только когда тема их вызывает. Так контекст не засоряется документацией целиком.
Какие платформы развертывания описаны?
`Kubernetes` с выбором `DaemonSet`, шлюза или `sidecar`, `ECS` на `EC2` и `Fargate`, `Docker Compose` и обычные виртуальные машины.
Покрывает ли он ИИ-агентов?
Да. Справочник `references/ai-agents.md` описывает, как собирать телеметрию `Claude Code`, `Gemini` CLI, `Codex`, `GitHub Copilot` и других, с оговоркой о неполном покрытии трасс.
Какие сценарии проверяются?
В README заявлены тестовая методика в духе `TDD` и более 20 сценариев оценки. Запуск тестов описан в отдельном разделе о проверке.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыOpenTelemetry Agent Skills помогает подключать телеметрию, настраивать Collector и проверять версии по первичным источникам.
Четыре скилла по OpenTelemetry: инструментирование приложений, семантические конвенции, Collector и язык OTTL.
Скилл KubeShark: агент сначала ищет режим отказа, потом пишет манифесты, Helm и Kustomize по официальным практикам и возвращает план проверки и отката
Официальный набор скиллов Grafana: PromQL, Loki, Tempo, Alloy, k6, дашборды и алертинг для Claude Code, Cursor и Codex
Большая база скиллов по DevOps, безопасности, инфраструктуре и комплаенсу для AI-агентов
31 скилл для DevOps в Claude Code и Codex: генераторы конфигов, валидаторы и отладчик Kubernetes для Terraform, Helm, CI и Docker
Коротко о README
В README изложены принцип маршрутизатора, структуру скилла, справочники, руководства по платформам, примеры запросов, проверку и известные ограничения. Репозиторий опубликован как плитка `Tessl` и в каталоге `skills.sh.`