opentelemetry-expert — Claude Code subagent setup
opentelemetry-expert configures OpenTelemetry tracing, metrics, and logs while handling context propagation and sampling strategies.
MIT ★ 1,029 updated 2025-10-15
.claude/agents/opentelemetry-expert.mdWhat opentelemetry-expert 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.
What it helps with
- 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 for the agent
- 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
How to install opentelemetry-expert
Manually: put the files in place
.claude/agents/opentelemetry-expert.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/opentelemetry-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/opentelemetry-expert.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about opentelemetry-expert
How to install opentelemetry-expert in Claude Code?
Place the subagent definition into .claude/agents/opentelemetry-expert.md in your project repository.
What does opentelemetry-expert do?
It guides OpenTelemetry architecture, context propagation, span setup, metrics aggregation, and sampling configuration.
Which model powers opentelemetry-expert?
The subagent specifies claude-sonnet-4-20250514 in its frontmatter configuration.
Source text
opentelemetry-expert.md · MIT
--- 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
© 0xfurai · MIT · 0xfurai/claude-code-subagents