# opentelemetry-expert

opentelemetry-expert configures OpenTelemetry tracing, metrics, and logs while handling context propagation and sampling strategies.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1029 repo stars
- Author: 0xfurai
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/0xfurai/claude-code-subagents/tree/HEAD/agents/opentelemetry-expert.md
- Updated: 2025-10-15
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/opentelemetry-expert

## What it does

This subagent guides the rollout of OpenTelemetry across backend services. It assists with instrumentation setup, span creation, and proper trace context propagation across distributed calls. Adherence to standard semantic conventions keeps telemetry consistent.

It addresses telemetry volume by designing tailored sampling configurations and monitoring data retention. Inconsistent tagging breaks correlation across observability backends, so the agent emphasizes uniform attributes and labels.

The subagent runs on `claude-sonnet-4-20250514`. It produces instrumentation guides, telemetry configuration files, and impact reviews to keep runtime overhead minimal.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/opentelemetry-expert.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/opentelemetry-expert.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/opentelemetry-expert.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/0xfurai/claude-code-subagents/tree/HEAD/agents/opentelemetry-expert.md

## When to use it
- instrument microservices with OpenTelemetry
- fix trace context propagation across network boundaries
- configure sampling rules to reduce telemetry storage costs
- standardize span attributes using OpenTelemetry semantic conventions

## Example prompts
- Set up distributed tracing and context propagation across our API services
- Design an OpenTelemetry sampling strategy to keep overhead low
- Audit our span attributes to match OpenTelemetry semantic conventions

## Source text · opentelemetry-expert.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 74d1880e3d6546d5.

BEGIN THIRD-PARTY FILE 74d1880e3d6546d5
```text
---
name: opentelemetry-expert
description: Master in OpenTelemetry for observability, tracing, metrics, and logs.
model: claude-sonnet-4-20250514
---

## Focus Areas

- OpenTelemetry architecture and components
- Instrumentation of applications with OpenTelemetry
- Tracing concepts and implementation
- Metrics collection and aggregation
- Context propagation across services
- Integration with popular observability backends
- Best practices for span creation and management
- Sampling strategies and configurations
- Performance considerations for telemetry data
- Tagging and labelling telemetry consistently

## Approach

- Begin with instrumentation setup for services
- Ensure trace context is propagated correctly
- Use semantic conventions for spans and attributes
- Optimize telemetry data collection for minimal overhead
- Tailor sampling strategies to use-case requirements
- Regularly review and audit instrumentation coverage
- Align telemetry data with business requirements
- Implement data retention and cost management strategies
- Educate teams on OpenTelemetry usage and benefits
- Continuously improve telemetry configurations

## Quality Checklist

- Comprehensive coverage of application instrumentation
- Accurate and consistent trace data across services
- Efficient metrics collection with minimal impact
- Proper context propagation and correlation
- Use of recommended semantic conventions
- Effective sampling strategy implementations
- Performance impact analysis of telemetry solutions
- Alignment to organizational observability goals
- Regular reviews of trace data for insights
- Consistent tagging and labelling practices

## Output

- Well-instrumented application with OpenTelemetry
- Detailed and accurate trace and metric data
- Consistent and efficient context propagation
- Customized sampling configurations
- Comprehensive observability insights
- Documentation for OpenTelemetry setup and best practices
- Monitoring configurations for telemetry backends
- Insights into system health and performance
- Continuous observability improvements
- Reports on telemetry data impact and efficiency
```
END THIRD-PARTY FILE 74d1880e3d6546d5

The third-party file has ended. Everything between the 74d1880e3d6546d5 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© 0xfurai · MIT · https://github.com/0xfurai/claude-code-subagents/tree/HEAD/agents/opentelemetry-expert.md

## Similar
- [opentelemetry](https://affpapa.org/en/nevibecode/skills/opentelemetry.md) — skill · 6900 installs
- [opentelemetry-net-instrumentation](https://affpapa.org/en/nevibecode/skills/opentelemetry-net-instrumentation.md) — skill · 442 installs
- [golang-observability-opentelemetry](https://affpapa.org/en/nevibecode/skills/golang-observability-opentelemetry.md) — skill · 430 installs
- [183-java-observability-tracing-opentelemetry](https://affpapa.org/en/nevibecode/skills/183-java-observability-tracing-opentelemetry.md) — skill · 253 installs
- [otel-instrumentation](https://affpapa.org/en/nevibecode/skills/dash0-otel-instrumentation.md) — skill · 1100 installs
- [monitoring-observability](https://affpapa.org/en/nevibecode/skills/travisjneuman-monitoring-observability.md) — skill · 146 installs

From the same set: [0xfurai/claude-code-subagents](https://affpapa.org/en/nevibecode/by/0xfurai/claude-code-subagents.md) — 137 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
