OpenTelemetry Skill
High-quality, ubiquitous, and portable telemetry to enable effective observability.
Ecosystem Graph
graph LR
opentelemetry["OpenTelemetry"]
opentelemetry -- "publishes to" --> jaeger
opentelemetry -- "publishes to" --> prometheus
Quick Start
OpenTelemetry (OTel) provides a vendor-neutral standard for instrumenting code. You instrument once, and route telemetry data to Datadog, Jaeger, or Honeycomb interchangeably via the OTel Collector.
npm install @opentelemetry/api @opentelemetry/sdk-node
Production Patterns
The Collector Architecture
Never send telemetry directly from your application to a backend vendor (e.g., sending traces directly to Honeycomb). Always send data to a local OpenTelemetry Collector (running as a sidecar or daemonset), which batches, compresses, and forwards the data securely.
Architecture & Scaling
Context Propagation
For distributed tracing to work, the unique trace_id must be passed between microservices. OTel achieves this automatically by injecting W3C Trace Context headers into outgoing HTTP/gRPC requests.
Error Recovery
Telemetry SDKs are designed to fail silently. If the Collector goes down, the application will drop traces rather than crashing. Ensure you have infrastructure-level alerts tracking Collector health.
Security Notes
Be extremely careful not to trace raw SQL queries containing PII, or log full HTTP request bodies containing passwords. Utilize OTel Collector processors to redact sensitive fields before data leaves your network.
Relationships
References
Why use this skill
Use this when your agent works with opentelemetry — structured patterns beat pasted docs and prevent common hallucinations.
AI pitfalls
- Using outdated SDK or API versions from training data
- Inventing environment variable names
- Omitting error handling and retry logic
Production checklist
- Secrets in environment variables, not source code
- Error handling and logging in place
- Rate limits and timeouts configured
Related skills
jaeger— publishes toprometheus— publishes to
Last Verified: 2026-07-02