otel-telemetry-emissions — скилл для Claude Code: как установить
Справочник телеметрии OpenTelemetry по конкретным версиям компонентов. Помогает проверить спаны, метрики, логи и атрибуты перед обновлением SDK или коллектора.
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a claude-codeЧто делает otel-telemetry-emissions
Скилл ищет зафиксированные списки телеметрии для компонентов OpenTelemetry Collector и пакетов SDK. Внутри хранятся файлы разметки по путям репозиториев и версиям, например opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md. Агент сверяется с index.md, находит точную версию или берёт ближайшую младшую, если точного совпадения нет.
В файлах собраны таблицы по сигналам: спаны с типами и атрибутами, метрики с единицами измерения, а также события логов. Параметр scope_name привязывает телеметрию к области инструментирования компонента, а в поле Notes указаны экспериментальные флаги и условия включения.
Данные собраны с помощью LLM-анализа исходного кода upstream-репозиториев, поэтому перед критичными изменениями их нужно перепроверять по официальной документации.
Какие задачи решает
- Узнать состав метрик и спанов конкретной версии компонента OpenTelemetry
- Проверить изменения в атрибутах телеметрии перед обновлением пакета SDK
- Найти точный scope_name для сопоставления логов с компонентом
- Определить метрики, скрытые за экспериментальными флагами конфигурации
Примеры запросов агенту
- Покажи метрики и спаны, которые отдаёт kafkareceiver в версии v0.158.0
- Какие атрибуты изменились в телеметрии при переходе на новую версию SDK?
- Проверь по index.md, есть ли данные по экспортеру otlpexporter
Как установить otel-telemetry-emissions
1Через Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a claude-code2Вручную: положить файлы
~/.claude/skills/otel-telemetry-emissions/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/otel-telemetry-emissions/
1Через Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a codex2Вручную: положить файлы
.agents/skills/otel-telemetry-emissions/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a cursor2Вручную: положить файлы
.cursor/skills/otel-telemetry-emissions/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ollygarden/opentelemetry-agent-skills otel-telemetry-emissions2Вручную: положить файлы
.github/skills/otel-telemetry-emissions/SKILL.md1Через Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a gemini-cli2Командой платформы
gemini skills install https://github.com/ollygarden/opentelemetry-agent-skills --path skills/otel-telemetry-emissionsВручную: положить файлы
.devin/skills/otel-telemetry-emissions/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о otel-telemetry-emissions
Как установить otel-telemetry-emissions в Claude Code?
Выполните команду npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a claude-code в терминале.
Зачем нужен скилл otel-telemetry-emissions?
Он даёт агенту каталог сигналов OpenTelemetry с привязкой к релизам. Это помогает проверять структуру метрик, логов и трейсов перед обновлением коллектора.
Откуда берутся данные о телеметрии в этом каталоге?
Файлы сформированы на основе LLM-анализа исходного кода upstream-проектов. Из-за этого сведения могут содержать неточности, и важные параметры стоит сверять с кодом upstream.
Исходный текст
SKILL.md · Apache-2.0
--- name: otel-telemetry-emissions description: Version-pinned inventory of the telemetry (spans, metrics, logs, attributes) emitted by OpenTelemetry collector components and SDK instrumentation packages. Use when working with a covered component — what it emits at a given version, or how emission changed across versions — and when upgrading a component or SDK version, to see the telemetry after the change. --- # Telemetry Emissions A registry of what telemetry OpenTelemetry components actually emit, pinned to upstream versions. > **Note:** The telemetry emissions in these files were detected by LLM > analysis of the upstream source and may contain errors. Verify against the > component's source or docs before relying on a row for critical decisions. ## Layout ``` <repo basename>/<path in repo>/v<version>.md ``` Example: `opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md` One file per scanned version. The files in a component directory are its telemetry history; `index.md` lists every file — start there to see what is covered. ## Looking up a component at a version 1. Find the component's directory (or its row in `index.md`). 2. Pick the file matching the target version exactly. 3. If there is no exact match, use the file with the highest version below the target and say the exact version is unverified. 4. If the component or version is not covered at all, say so — do not infer telemetry from semantic conventions. ## What a data file contains Frontmatter (`repo`, `path`, `version`, `scope_name`, `commit_sha`, `last_verified`), then per-signal tables: - **Traces** — span name, kind, attributes, notes - **Metrics** — metric name, instrument type, unit, attributes, notes - **Logs** — log/event name, attributes, notes `scope_name` is the component's instrumentation scope — the anchor for matching runtime telemetry back to the component. When helper or pipeline telemetry uses another scope, its rows name that scope in `Notes`. `last_verified: null` means the historical verification date could not be substantiated; recheck the pinned source before presenting its rows as verified. Absent signals are omitted entirely. `Notes` marks conditional emission (feature gates, opt-in config, experimental semconv). `Sources` lists the upstream files the data came from.
© ollygarden · Apache-2.0 · ollygarden/opentelemetry-agent-skills