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

distributed-tracing · sickn33 — скилл для Claude Code: как установить

Скилл distributed-tracing для Claude Code помогает настроить сквозную трассировку микросервисов через OpenTelemetry, Jaeger и Tempo, связать спаны между сервисами и избежать утечки секретов в трейсы.

MIT ★ 50 109 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sickn33/agentic-awesome-skills --skill distributed-tracing -a claude-code
Открыть на GitHub

Что делает distributed-tracing

Скилл даёт агенту инструкции по настройке OpenTelemetry SDK и OTLP-экспортёров для межсервисных запросов. Внутри лежат пошаговые сценарии для сквозной передачи контекста по HTTP и асинхронным очередям, проверки сброса буферов при завершении работы и защиты от сбоев экспортёра.

Бэкенд трассировки этот набор не разворачивает. Серверы Jaeger или Tempo уже должны быть настроены, а версии библиотек придётся сопоставлять по документации до выбора API.

Какие задачи решает

  • связать цепочку спанов между HTTP-сервисами и асинхронными очередями
  • исключить токены и тела запросов из атрибутов трейсинга
  • проверить поведение приложения при недоступности OTLP-коллектора
  • настроить правила семплирования на основе накладных расходов

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

  • Спланируй настройку OpenTelemetry и Jaeger для пути оформления заказа через микросервисы
  • Проверь сквозную передачу контекста трассировки через очереди сообщений
  • Настрой OTLP-экспортёр так, чтобы сбой отправки не ломал обработку запросов

Как установить distributed-tracing

1Через Skills CLI (Vercel)

npx skills add sickn33/agentic-awesome-skills --skill distributed-tracing -a claude-code

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

~/.claude/skills/distributed-tracing/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о distributed-tracing

Как установить distributed-tracing в Claude Code?

Выполните команду npx skills add sickn33/agentic-awesome-skills --skill distributed-tracing -a claude-code. Файл навыка сохранится в ~/.claude/skills/distributed-tracing/SKILL.md.

Что делает скилл distributed-tracing?

Он направляет ИИ-ассистента при интеграции OpenTelemetry SDK, подключении Jaeger или Tempo и настройке безопасной передачи контекста между сервисами.

Разворачивает ли этот скилл Jaeger или Tempo?

Нет, скилл не содержит скриптов установки бэкенда трассировки. Кластер Jaeger, Tempo или OpenTelemetry Collector должен быть подготовлен заранее.

Исходный текст

SKILL.md · MIT
---
name: distributed-tracing
description: "Implement distributed tracing with Jaeger and Tempo for request flow visibility across microservices."
risk: critical
source: community
date_added: "2026-02-27"
---

# Distributed Tracing

## When to Use

Trace a request across services, diagnose latency and error propagation, or add observable boundaries to a new integration.

## Inputs and prerequisites

Record installed SDK and backend versions, permitted collector endpoints, the service graph and a staging request. Inspect the installed version's primary documentation before selecting exporter APIs or deployment configuration. This bundle does not install a tracing backend.

## Procedure

1. Read `resources/implementation-playbook.md` and identify one user journey.
2. Configure the matching OpenTelemetry SDK and OTLP exporter before loading instrumented frameworks. Use `references/instrumentation.md` for propagation, shutdown and privacy checks.
3. Configure Jaeger using `references/jaeger-setup.md`, or the existing Tempo/collector deployment's supported configuration. Review listeners, authentication, transport protection, storage and retention before any deployment.
4. Propagate context over HTTP and asynchronous messages. Use stable operation names and allowlisted attributes. Do not log credentials, raw request bodies or sensitive query values.
5. Send successful and failing staging requests and verify connected spans in the backend. Record service identity, parentage, duration units and exporter errors.
6. Measure queue loss and overhead. Select sampling based on those observations; no fixed percentage guarantees coverage or performance.

## Example

A checkout calls inventory and payment. Verify that the root request and both downstream operations share a trace, that a simulated payment timeout is recorded, and that no card data is present. Repeat with exporter connectivity unavailable: request handling must retain the application's defined behavior.

## Verification

- Actual trace evidence for each exercised boundary, including queue consumers.
- Allowed fields only; bounded attribute cardinality.
- Shutdown flush and exporter failure behavior observed.
- Access, storage and retention checked independently from UI availability.

## Limitations

Head sampling can discard errors before tail sampling sees them. In-memory demos do not prove durable storage. Context propagation and cross-service clocks need actual integration tests; this guide is not a runnable multi-service application.

## Sources

- [OpenTelemetry exporter documentation](https://opentelemetry.io/docs/languages/python/exporters/) — use the installed SDK's matching documentation.

© sickn33 · MIT · sickn33/agentic-awesome-skills

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

Все скиллы по теме «Бэкенд и API» →

Сначала — distributed-tracing от других авторов.

distributed-tracing Seth Hobson Скилл distributed-tracing для Claude Code настраивает распределённую трассировку через Jaeger и Tempo. Помогает искать задержки и ошибки в микросервисах. CX Codex +1 10 700установок observability-guidelines Mindrally Скилл observability-guidelines учит агента внедрять OpenTelemetry, трассировку и структурированные логи в распределённые сервисы. Пригодится при настройке мониторинга и метрик. CX Codex +1 826установок 183-java-observability-tracing-opentelemetry Juan Antonio Breña Moral Скилл 183-java-observability-tracing-opentelemetry настраивает распределённую трассировку OpenTelemetry в Java-приложениях, контекст вызовов и экспорт через OTLP. CX Codex +1 253установок distributed-debugging Seth Hobson Плагин distributed-debugging для трассировки и отладки распределённых систем: помогает разбираться, что происходит между микросервисами. CX Codex ★ 42 780звёзд репо agentlens-tracing-instrument wandb Скилл agentlens-tracing-instrument для Claude Code и Cursor добавляет трассировку Forge AgentLens в агентов на Python или TypeScript. Запускается при запросе на отслеживание шагов агента, вызовов моделей, инструментов или субагентов. CX Codex +1 200установок langchain-agent-tracing langchain-ai Скилл langchain-agent-tracing для Claude Code помогает настроить трассировку агентов и приложений на LangSmith. Он подключается при добавлении или проверке сбора трасс и их маршрутизации. CX Codex +1 298установок tempo grafana tempo — скилл для Claude Code, который помогает развернуть Grafana Tempo и писать запросы TraceQL. Он подключается при настройке трассировки, поиске медленных запросов и разборе пустого Explore. CX Codex +1 5 300установок

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

Весь набор →
varlock-claude-skill Скилл varlock-claude-skill задаёт проверки для работы с переменными окружения и снижает риск утечки секретов в сессии, логах и коммитах. CX Codex +1 ★ 50 109звёзд репо secrets-management Скилл secrets-management проводит агента по работе с секретами в CI/CD: выбор хранилища, короткоживущие identity, ротация и проверка, что значения не утекли в логи и артефакты. CX Codex +1 ★ 50 109звёзд репо security-scanning-security-sast Скилл security-scanning-security-sast для Claude Code и Codex: статический анализ кода (SAST) выявляет уязвимости, захардкодированные секреты и нарушения политик безопасности во множестве языков и фреймворков. CX Codex +1 ★ 50 109звёзд репо distributed-debugging-debug-trace Скилл distributed-debugging-debug-trace помогает настроить отладку и распределённую трассировку: границы трейсов, ключевые спаны, корреляционные ID и проверка покрытия запроса. CX Codex +1 ★ 50 109звёзд репо observability-monitoring-slo-implement Скилл observability-monitoring-slo-implement для Claude Code помогает определить SLI и SLO, настроить бюджеты ошибок и мониторинг надёжности сервиса. Связывает цели надёжности с развитием продукта. CX Codex +1 ★ 50 109звёзд репо create-pr Скилл create-pr для Claude Code и других агентов перенаправляет запросы на создание или обновление pull request в канонический процесс pr-writer. CX Codex +1 ★ 50 109звёзд репо observability-monitoring-monitor-setup Скилл observability-monitoring-monitor-setup, с которым агент проектирует сбор метрик, трейсинг, логи и дашборды для приложения и инфраструктуры под ним. CX Codex +1 ★ 50 109звёзд репо analytics-tracking Скилл analytics-tracking помогает спроектировать, проверить и навести порядок в событиях аналитики без мусорных кликов и метрик тщеславия. Пригодится перед запуском воронок или ревизией трекинга. CX Codex +1 ★ 50 109звёзд репо

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

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