opentelemetry · bobmatnyc — скилл для Claude Code: трассировка и OTLP
Скилл с паттернами OpenTelemetry: трейсы, метрики, логи, проброс контекста и пайплайны Collector. Пригодится, когда сервис пора инструментировать, а не гадать по логам.
npx skills add bobmatnyc/claude-mpm-skills --skill opentelemetry -a claude-codeЧто делает opentelemetry
Скилл описывает, как инструментировать сервис через OpenTelemetry и вывозить OTLP-трейсы, метрики и логи через Collector. Внутри три справочника: references/concepts.md про сигналы, проброс контекста, сэмплирование и семантические конвенции, references/collector-and-otlp.md про пайплайны, процессоры и tail sampling, references/instrumentation-and-troubleshooting.md про ручные спаны, ловушки проброса, кардинальность и отладку.
Быстрый старт состоит из пяти шагов: задать service.name, подключить автоинструментирование, настроить экспорт OTLP, развернуть Collector и связать логи с trace ID. Ресурсные атрибуты советует стандартизировать сразу — service.name, service.version, deployment.environment, иначе потом не свести данные по окружениям. Ручные спаны и корреляция логов идут после автоинструментирования, не вместо него.
Скилл не вызывается пользователем: user-invocable: false и disable-model-invocation: true, так что как слэш-команду его не запустить — он подхватывается агентом по контексту задачи. Входная точка занимает около 150 токенов, полный текст — примерно 9000, при лимите контекста 900. Дополнительных инструментов не требует.
Какие задачи решает
- разложить трейсы, метрики и логи по одному сервису
- настроить экспорт OTLP через Collector вместо привязки к вендору
- связать строки логов с trace ID при разборе инцидента
- выбрать сэмплирование и не утонуть в кардинальности метрик
- найти ошибку в пробросе контекста между сервисами
Примеры запросов агенту
- добавь автоинструментирование OpenTelemetry в этот сервис и настрой экспорт OTLP
- почему в логах нет trace ID — проверь проброс контекста по references/concepts.md
- собери пайплайн Collector с tail sampling для этих сервисов
Как установить opentelemetry
1Через Skills CLI (Vercel)
npx skills add bobmatnyc/claude-mpm-skills --skill opentelemetry -a claude-code2Вручную: положить файлы
~/.claude/skills/opentelemetry/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/opentelemetry/
1Через Skills CLI (Vercel)
npx skills add bobmatnyc/claude-mpm-skills --skill opentelemetry -a codex2Вручную: положить файлы
.agents/skills/opentelemetry/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add bobmatnyc/claude-mpm-skills --skill opentelemetry -a cursor2Вручную: положить файлы
.cursor/skills/opentelemetry/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install bobmatnyc/claude-mpm-skills opentelemetry2Вручную: положить файлы
.github/skills/opentelemetry/SKILL.md1Через Skills CLI (Vercel)
npx skills add bobmatnyc/claude-mpm-skills --skill opentelemetry -a gemini-cli2Командой платформы
gemini skills install https://github.com/bobmatnyc/claude-mpm-skills --path universal/observability/opentelemetryВручную: положить файлы
.devin/skills/opentelemetry/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add bobmatnyc/claude-mpm-skills --skill opentelemetry -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о opentelemetry
Как установить opentelemetry в Claude?
Выполните npx skills add bobmatnyc/claude-mpm-skills --skill opentelemetry -a claude-code. Скилл появится по пути ~/.claude/skills/opentelemetry/SKILL.md.
Что делает скилл opentelemetry?
Даёт паттерны инструментирования сервисов: трейсы, метрики, логи, проброс контекста, экспорт OTLP и пайплайны Collector. Плюс отдельный справочник по отладке.
Можно вызвать его как слэш-команду?
Нет. В описании стоит user-invocable: false и disable-model-invocation: true, поэтому скилл подключается по контексту задачи, а не по команде.
Исходный текст
SKILL.md · MIT
---
name: opentelemetry
description: "OpenTelemetry observability patterns: traces, metrics, logs, context propagation, OTLP export, Collector pipelines, and troubleshooting"
user-invocable: false
disable-model-invocation: true
version: 1.0.0
category: universal
author: Claude MPM Team
license: MIT
progressive_disclosure:
entry_point:
summary: "Instrument services with OpenTelemetry and export OTLP traces/metrics/logs through a Collector for correlation and troubleshooting"
when_to_use: "When building production observability, adding tracing to distributed systems, or standardizing telemetry across languages"
quick_start: "1. Set service.name 2. Add auto-instrumentation 3. Export OTLP 4. Deploy Collector 5. Correlate logs with trace IDs"
token_estimate:
entry: 150
full: 9000
context_limit: 900
tags:
- observability
- opentelemetry
- tracing
- metrics
- logs
- otlp
requires_tools: []
---
# OpenTelemetry
## Quick Start (signal design)
- Export OTLP via an OpenTelemetry Collector (vendor-neutral endpoint).
- Standardize resource attributes: `service.name`, `service.version`, `deployment.environment`.
- Start with auto-instrumentation, then add manual spans and log correlation.
## Load Next (References)
- `references/concepts.md` — traces/metrics/logs, context propagation, sampling, semantic conventions
- `references/collector-and-otlp.md` — Collector pipelines, processors, deployment patterns, tail sampling
- `references/instrumentation-and-troubleshooting.md` — manual spans, propagation pitfalls, cardinality, debugging
© Claude MPM Team · MIT · bobmatnyc/claude-mpm-skills
Похожие скиллы
Всё по теме «DevOps и инфраструктура» →Сначала — opentelemetry от других авторов.
