opentelemetry.io/content/en/docs/languages/java/_index.md

title	description	aliases	cascade	weight
Java	<img width="35" class="img-initial" src="/img/logos/32x32/Java_SDK.svg" alt="Java"> A language-specific implementation of OpenTelemetry in Java.	/java /java/metrics /java/tracing	vers instrumentation otel semconv 2.2.0 1.36.0 1.23.1	18

{{% docs/languages/index-intro java /%}}

Repositories

OpenTelemetry Java consists of the following repositories:

• opentelemetry-java: Components for manual instrumentation including API and SDK as well as extensions, the OpenTracing shim.
• opentelemetry-java-docs: Manual instrumentation examples.
• opentelemetry-java-instrumentation: Built on top of opentelemetry-java and provides a Java agent JAR that can be attached to any Java 8+ application and dynamically injects bytecode to capture telemetry from a number of popular libraries and frameworks.
• opentelemetry-java-contrib: Provides helpful libraries and standalone OpenTelemetry-based utilities that don't fit the express scope of the OpenTelemetry Java or Java Instrumentation projects. For example, JMX metric gathering.
• semantic-conventions-java: Java implementation of OpenTelemetry Semantic Conventions. For example, ResourceAttributes.SERVICE_NAME.
• opentelemetry-proto-java: Java bindings for the OpenTelemetry Protocol (OTLP).

Components

See components for a complete list of published components.

Releases

Published releases are available on maven central. We strongly recommend using our BOM to keep the versions of the various components in sync.

Maven

<project>
  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>io.opentelemetry</groupId>
        <artifactId>opentelemetry-bom</artifactId>
        <version>{{% param vers.otel %}}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>io.opentelemetry</groupId>
      <artifactId>opentelemetry-api</artifactId>
    </dependency>
  </dependencies>
</project>

Gradle

dependencies {
  implementation(platform("io.opentelemetry:opentelemetry-bom:{{% param vers.otel %}}"))
  implementation("io.opentelemetry:opentelemetry-api")
}