К основному содержанию
скилл CX Codex

otel-telemetry-emissions — скилл для Claude Code: как установить

Справочник телеметрии OpenTelemetry по конкретным версиям компонентов. Помогает проверить спаны, метрики, логи и атрибуты перед обновлением SDK или коллектора.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a claude-code
Открыть на GitHub

Что делает 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-code

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

~/.claude/skills/otel-telemetry-emissions/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/otel-telemetry-emissions/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
wizard Matt Pocock Скилл создаёт интерактивный bash-скрипт для ручных шагов: настройки сервисов, секретов CI и разовых миграций. 553 369установок hyperframes-cli heygen-com Управляет проектами HyperFrames через терминал: собирает таймлайн, проверяет контраст кадров, запускает предпросмотр и рендерит видео локально или в облаке. CX Codex +1 1 300 000установок setup-pre-commit Matt Pocock Скилл настраивает pre-commit для JavaScript-репозитория: Husky запускает форматирование, проверку типов и тесты перед коммитом. 489 289установок using-git-worktrees Jesse Vincent Готовит изолированное рабочее дерево перед доработкой или выполнением плана. Проверяет текущий репозиторий, выбирает нативные средства платформы либо Git. CX Codex 217 153установок finishing-a-development-branch Jesse Vincent Скилл проверяет тесты и помогает выбрать, как завершить работу в ветке: слить её, открыть Pull Request или оставить как есть. CX Codex 214 439установок orca-cli stablyai Скилл даёт агенту доступ к worktree, терминалам, артефактам и встроенному браузеру Orca через CLI. Пригодится, когда работа идёт в окружении Orca. CX Codex +1 354 000установок

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

otel-component-telemetry Сканирует один компонент OpenTelemetry на закреплённых версиях и записывает его спаны, метрики и логи в файлы изменений. CX Codex +1 ★ 116звёзд репо otel-weaver Настраивает реестры OpenTelemetry Weaver, генерацию кода и CI-проверки. Помогает описать семантические конвенции компании без ручных констант. CX Codex +1 ★ 116звёзд репо otel-upgrade Скилл оценивает обновления OpenTelemetry и предлагает путь перехода с учётом версий, совместимости и проверок в репозитории. Пригодится перед обновлением SDK, Collector или связанных компонентов. CX Codex +1 ★ 116звёзд репо otel-telemetrygen Собирает безопасные команды telemetrygen с привязкой к версии, чтобы гнать синтетические OTLP-трейсы, метрики и логи в коллектор. CX Codex +1 ★ 116звёзд репо otel-span-events-to-logs-migration Помогает перенести события и исключения OpenTelemetry со Span Events на Logs API, сохранив связь записей с активным спаном. Пригодится для миграции и проверки старых вызовов. CX Codex +1 ★ 116звёзд репо otel-semantic-conventions Скилл подтягивает вышедшие семантические конвенции OpenTelemetry: имена групп, атрибуты и правила именования спанов. Пригодится, когда агент придумывает ключи вместо готовых. CX Codex +1 ★ 116звёзд репо otel-sdk-versions Ищет актуальные релизы OpenTelemetry SDK, компонентов Collector, схем конфигурации и семантических конвенций. Пригодится при настройке телеметрии в проекте. CX Codex +1 ★ 116звёзд репо otel-ruby Помогает агенту настраивать и проверять OpenTelemetry в Ruby-приложениях. Пригодится для трассировки, метрик, логов и инструментирования Rails и других библиотек. CX Codex +1 ★ 116звёзд репо

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

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