183-java-observability-tracing-opentelemetry — скилл для Claude Code
Скилл 183-java-observability-tracing-opentelemetry настраивает распределённую трассировку OpenTelemetry в Java-приложениях, контекст вызовов и экспорт через OTLP.
Apache-2.0 253 установок ★ 465 обновлён 2026-10-21
npx skills add jabrena/plinth --skill 183-java-observability-tracing-opentelemetry -a claude-codeЧто делает 183-java-observability-tracing-opentelemetry
Скилл задаёт правила внедрения OpenTelemetry в бэкенд на Java. Он помогает выстроить иерархию спанов, настроить передачу контекста через HTTP, очереди сообщений и асинхронные задачи на базе Executor. Инструкции фокусируются на стабильных именах атрибутов по семантическим конвенциям и фиксации статусов ошибок.
Процесс разбит на четыре шага: проектирование модели спанов, проброс контекста, очистка атрибутов от персональных данных и сквозная верификация. Скилл требует строго исключать токены, пароли и сырые пейлоады из спанов, а также избегать параметров с высокой кардинальностью, чтобы не раздувать траты на сбор телеметрии.
Для проверки корректности изменений скилл требует запускать сборку через ./mvnw clean verify или mvn clean verify.
Какие задачи решает
- пробросить контекст трассировки через потоки и очереди сообщений
- разметить бизнес-операции спанами OpenTelemetry по семантическим конвенциям
- исключить секреты и персональные данные из атрибутов трейсинга
- настроить политику сэмплирования телеметрии без потери критичных ошибок
Примеры запросов агенту
- Добавь OpenTelemetry спаны для обработки заказов и проверь проброс контекста в асинхронных задачах
- Настрой трассировку входящих HTTP-запросов и исходящих вызовов к базе данных по конвенциям OpenTelemetry
- Проверь атрибуты спанов на наличие персональных данных и исключи токены авторизации
Как установить 183-java-observability-tracing-opentelemetry
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 183-java-observability-tracing-opentelemetry -a claude-code2Вручную: положить файлы
~/.claude/skills/183-java-observability-tracing-opentelemetry/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/183-java-observability-tracing-opentelemetry/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 183-java-observability-tracing-opentelemetry -a codex2Вручную: положить файлы
.agents/skills/183-java-observability-tracing-opentelemetry/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 183-java-observability-tracing-opentelemetry -a cursor2Вручную: положить файлы
.cursor/skills/183-java-observability-tracing-opentelemetry/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jabrena/plinth skills/183-java-observability-tracing-opentelemetry2Вручную: положить файлы
.github/skills/183-java-observability-tracing-opentelemetry/SKILL.md1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 183-java-observability-tracing-opentelemetry -a gemini-cli2Командой платформы
gemini skills install https://github.com/jabrena/plinth --path skills/183-java-observability-tracing-opentelemetryВручную: положить файлы
.devin/skills/183-java-observability-tracing-opentelemetry/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 183-java-observability-tracing-opentelemetry -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о 183-java-observability-tracing-opentelemetry
Как установить 183-java-observability-tracing-opentelemetry в Claude Code?
Выполните команду npx skills add jabrena/plinth --skill 183-java-observability-tracing-opentelemetry -a claude-code.
Что делает этот скилл?
Он направляет ИИ-агента при внедрении распределённой трассировки OpenTelemetry в Java, следя за передачей контекста, безопасностью данных и семантическими стандартами.
Как проверить проект после внедрения рекомендаций?
После внесения изменений запустите ./mvnw clean verify или стандартный mvn clean verify для проверки тестов и сборки.
Исходный текст
SKILL.md · Apache-2.0
--- name: 183-java-observability-tracing-opentelemetry description: Use when you need to implement or improve distributed tracing with OpenTelemetry in Java — including trace/span modeling, context propagation, semantic conventions, span attributes/events/status, sampling strategy, baggage usage, privacy safeguards, and backend integration with OTLP collectors. This should trigger for requests such as Improve tracing; Apply OpenTelemetry tracing; Add distributed tracing; Refactor tracing instrumentation; Instrument Java services with OpenTelemetry spans. Part of Plinth Toolkit license: Apache-2.0 metadata: author: Juan Antonio Breña Moral version: 0.19.0 --- # Java Distributed Tracing with OpenTelemetry Implement robust distributed tracing in Java with OpenTelemetry by modeling meaningful spans, preserving context propagation, and instrumenting critical business and infrastructure paths with low-overhead, privacy-safe telemetry. **What is covered in this Skill?** - OpenTelemetry tracing fundamentals for Java services - Span design: boundaries, parent/child relationships, and operation naming - Context propagation across HTTP, messaging, async tasks, and thread boundaries - Semantic conventions and stable attribute naming - Error/status/event recording best practices - Sampling strategy and performance/cost trade-offs - Privacy and security controls for trace attributes - Testing and verification of trace propagation and span correctness **Scope:** Distributed tracing quality in application and integration layers, focused on diagnosability, consistency, and operational safety. ## Constraints Tracing instrumentation must preserve context correctly and avoid leaking sensitive data. Over-instrumentation and high-cardinality attributes can harm cost and signal quality. - **PROPAGATION FIRST**: Ensure context propagation across all sync/async boundaries before adding extra span detail - **NO SENSITIVE DATA**: Never store secrets, credentials, tokens, raw payloads, or PII in span attributes/events - **LOW CARDINALITY ATTRIBUTES**: Avoid unbounded values in attributes that are used for aggregation/search - **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` after applying tracing changes ## When to use this skill - Improve tracing - Apply OpenTelemetry tracing - Add distributed tracing - Refactor tracing instrumentation - Instrument Java services with OpenTelemetry spans ## Workflow 1. **Define trace model and critical flows** Identify high-value request and async flows, define operation boundaries, and choose span names/attributes aligned with semantic conventions. 2. **Instrument and propagate context** Add OpenTelemetry spans to key boundaries and ensure trace context is propagated across HTTP clients/servers, messaging, and executor-based async work. 3. **Harden span data and sampling** Record status/errors/events consistently, remove sensitive data, control attribute cardinality, and configure sampling/exporters according to environment needs. 4. **Validate traces end-to-end** Verify parent-child relationships, propagation continuity, and backend visibility through tests and runtime checks. ## Reference For detailed guidance, examples, and constraints, see [references/183-java-observability-tracing-opentelemetry.md](references/183-java-observability-tracing-opentelemetry.md).
© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth