OpenTelemetry Java is the official Java implementation of the OpenTelemetry API and SDK, providing a comprehensive framework for recording and managing telemetry data across Java applications. The repository serves as the central hub for Java-based observability, enabling developers to instrument their applications with metrics, traces, logs, and context propagation capabilities. It is maintained by the OpenTelemetry project and published to Maven Central with a consistent monthly release cadence for minor versions and patch releases as needed.
The repository publishes a wide range of artifacts organized into several key categories. The API layer includes the core OpenTelemetry API for recording telemetry, the Context API for managing execution context, and an API Incubator containing experimental features like the Event API and extended tracer functionality. API Extensions provide specialized implementations such as a Kotlin extension for coroutine context support and trace propagators for standards like B3, Jaeger, and OT Trace. The SDK layer encompasses separate implementations for metrics, traces, logs, and profiles, along with shared SDK components and testing utilities designed to help developers validate their instrumentation. Bills of Materials are provided to ensure version synchronization across related artifacts, with both stable and alpha variants available.
The project maintains broad Java compatibility, supporting Java 8 and higher across all published artifacts, with special considerations for Android applications requiring library desugaring. The repository explicitly seeks additional contributors and maintains active community engagement through its help wanted initiative.
The repository's scope extends across the full observability spectrum, encompassing distributed tracing, metrics collection, logging integration, and context propagation mechanisms essential for modern distributed systems. The SDK Testing component specifically addresses the needs of instrumentation developers by providing reusable testing utilities. The comprehensive documentation referenced in the README directs users to detailed guides covering the Java ecosystem, component specifications, instrumentation patterns, and working code examples, positioning the repository as both a production-ready implementation and an educational resource for Java observability practices.
