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

183-java-observability-tracing-opentelemetry — скилл для Claude Code

Скилл 183-java-observability-tracing-opentelemetry настраивает распределённую трассировку OpenTelemetry в Java-приложениях, контекст вызовов и экспорт через OTLP.

Apache-2.0 253 установок ★ 465 обновлён 2026-10-21

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

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

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

~/.claude/skills/183-java-observability-tracing-opentelemetry/SKILL.md

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

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

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

Все скиллы по теме «Бэкенд и API» →
golang-observability-opentelemetry Claude MPM Team Скилл golang-observability-opentelemetry для Claude Code, Codex, Cursor и других платформ, который обучает агента инструментировать Go-сервисы через OpenTelemetry, Prometheus и slog. CX Codex +1 430установок otel-java ollygarden Скилл otel-java настраивает OpenTelemetry в Java-сервисах: конфигурирует Javaagent, Spring Boot Starter и скрывает чувствительные данные из трейсов. CX Codex +1 ★ 126звёзд репо opentelemetry grafana Скилл opentelemetry для Claude Code настраивает сбор метрик, логов и трейсов в Grafana Cloud или локальные Mimir, Loki и Tempo. Подключается при настройке OTLP-экспорта и отладке пропадающих спанов. CX Codex +1 6 900установок opentelemetry-net-instrumentation Aaronontheweb Скилл opentelemetry-net-instrumentation для Claude Code расставляет трассировку, метрики и логи в .NET-коде по спецификации OpenTelemetry. Покрывает телеметрией библиотеку или приложение. CX Codex +1 442установок azure-monitor-opentelemetry-exporter-java Microsoft Скилл помогает настроить отправку трассировок, метрик и логов Java-приложения в Azure Monitor и Application Insights через OpenTelemetry. Пакет экспортёра устарел, поэтому рекомендуется перейти на autoconfigure. CX Codex +1 ★ 3 232звёзд репо opentelemetry-expert 0xfurai Субагент opentelemetry-expert настраивает сбор трейсов, метрик и логов через OpenTelemetry, прокидывает контекст между сервисами и подбирает стратегии сэмплинга. CX Codex ★ 1 029звёзд репо

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

Весь набор →
415-frameworks-quarkus-mongodb Скилл для работы с MongoDB в Quarkus-проектах: Panache сущности и репозитории, дизайн документов, индексы, транзакции и обработка ошибок. Срабатывает на запросы о добавлении MongoDB, проверке архитектуры и оптимизации работы с данными. CX Codex +1 279установок 514-frameworks-micronaut-kafka Скилл 514-frameworks-micronaut-kafka настраивает обмен сообщениями через Apache Kafka в приложениях на Micronaut. Помогает писать клиенты, слушатели, сериализаторы и тесты с TestPropertyProvider. CX Codex +1 275установок 515-frameworks-micronaut-mongodb Скилл 515-frameworks-micronaut-mongodb помогает настроить и проверить работу MongoDB в Micronaut: от моделей документов и репозиториев до индексов и обработки ошибок. CX Codex +1 272установок 123-java-design-patterns Скилл 123-java-design-patterns помогает выбирать, проверять и внедрять паттерны Java для API, Kafka, баз данных и интеграций. CX Codex +1 267установок 305-frameworks-spring-boot-modulith Скилл 305-frameworks-spring-boot-modulith для Claude Code проектирует и проверяет модульные монолиты на Spring Modulith в приложениях Spring Boot. Помогает задавать границы модулей, работать с событиями и тестировать архитектуру. CX Codex +1 245установок 704-technologies-sql Скилл 704-technologies-sql для Claude Code проектирует SQL-схемы, запросы и миграции. Включается в ревью базы и подготовку изменений. CX Codex +1 227установок 300-frameworks-spring-boot-create-project Скилл 300-frameworks-spring-boot-create-project для Claude Code создаёт Maven-проект на Spring Boot 4.0.x и Java 25 через Spring Boot CLI и SDKMAN. Генерирует основу нового сервиса без ручной настройки окружения. CX Codex +1 225установок 706-technologies-containers-docker Скилл 706-technologies-containers-docker помогает проверять и настраивать Docker-образы Java-проектов: от Dockerfile и jlink до безопасности и воспроизводимости сборки. CX Codex +1 225установок

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

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