o11y-dev/opentelemetry-skill
Expert OpenTelemetry guidance for collector configuration, pipeline design, and production telemetry instrumentation. Use when configuring collectors, designing pipelines, instrumenting applications, implementing sampling, managing cardinality, securing telemetry, writing OTTL transformations, or setting up AI coding agent observability (Claude Code, Codex, Gemini CLI, GitHub Copilot).
93
97%
Does it follow best practices?
Impact
85%
7.08xAverage score across 4 eval scenarios
Passed
No known issues
compatibility.mdreferences/
Compatibility Reference
Use this document for version-sensitive guidance that changes more frequently than the core routing logic in SKILL.md.
Baseline version floors
- OpenTelemetry Collector: v0.150.0+
- Semantic Conventions: v1.40.0+
- Kubernetes: v1.24+ for native sidecar support
- Go SDK: v1.24.0+
- Python SDK: v1.41.0+
AI agent telemetry compatibility
- Claude Code: current release emits metrics plus logs/events, not traces
- Gemini CLI: v0.34.0+ emits traces, metrics, and logs with GenAI semantic conventions
- GitHub Copilot: latest stable / Insiders builds expose traces, metrics, and events with GenAI semantic conventions
- Codex CLI: v0.105.0+ emits traces and logs in interactive mode, with gaps in
exec/mcp-server
Maintenance guidance
- Treat these version floors as fast-moving compatibility notes rather than hard-coded architectural rules.
- Pin collector components to released versions and verify stability levels before using non-stable features in production.
- Re-check upstream release notes whenever updating examples that depend on AI agent telemetry support or evolving semantic conventions.
docs
evals
cardinality-protection
claude-code-telemetry
collector-memory-limiter
scenario-1
scenario-2
scenario-3
scenario-4
tail-sampling-setup
references