The OpenTelemetry Specification repository serves as the authoritative cross-language specification document for all OpenTelemetry implementations. Hosted at opentelemetry.io/docs/specs/otel with Markdown sources maintained in the specification directory, this repository defines the requirements and expectations that guide how observability tools and libraries should implement OpenTelemetry across different programming languages and platforms. The specification covers critical areas including distributed tracing, metrics collection, logging, and the APIs and SDKs that enable these capabilities.
The repository is classified across multiple observability and standardization domains, including instrumentation, metrics, logging, APIs, telemetry, observability frameworks, distributed systems, performance monitoring, and distributed tracing. This broad classification reflects the specification's role as a foundational document that touches nearly every aspect of the OpenTelemetry ecosystem. The primary language used in the repository is Makefile, indicating that the specification is built and maintained through automated processes rather than being a traditional code repository.
This interconnection demonstrates how the specification serves as a central reference point for multiple implementation projects across the ecosystem.
The specification follows Semantic Versioning 2.0 for changes, with versions and descriptions documented in CHANGELOG.md. The repository includes a specification compliance matrix that tracks how different language implementations conform to the specification requirements. Development is organized through regular meetings held every Tuesday at 8 AM Pacific time for EU and US timezones, with additional APAC-friendly meetings available on request. Technical escalations are handled through the OpenTelemetry Technical Committee, which maintains meeting notes and oversees major specification decisions.
The project is governed by a Technical Committee that includes maintainers from major organizations, with Robert Pająk from Splunk and Josh Suereth from Google listed as primary maintainers. A broader set of specification sponsors from companies including Honeycomb, Dynatrace, Microsoft, Google, Oracle, and Grafana Labs serve as approvers. All contributions are licensed under the Apache 2.0 License, and the repository maintains detailed contribution guidelines in CONTRIBUTING.md that outline the process for proposing changes to the specification.
