/opentelemetry-java

OpenTelemetry Java SDK

Primary LanguageJavaApache License 2.0Apache-2.0

OpenTelemetry

Gitter chat Build Status Coverage Status Maven Central

We hold regular meetings. See details at community page.

Overview

OpenTelemetry is the merging of OpenCensus and OpenTracing into one project.

This project contains the following top level components:

  • OpenTelemetry API:
    • tracing api includes Tracer, Span and SpanContext.
    • baggage api defines a collection of entries in the form of key-value pairs of data that can be propagated to provide contextual information.
    • context api defines the in-process and inter-process propagation layer.
    • metrics api.
  • extensions define additional API extensions, which are not part of the core API.
  • sdk define the reference implementation complying to the OpenTelemetry API.
  • sdk extensions define additional SDK extensions, which are not part of the core SDK.
  • OpenTracing shim defines a bridge layer from OpenTracing to the OpenTelemetry API.
  • examples on how to use the APIs, SDK, and standard exporters.

We would love to hear from the larger community: please provide feedback proactively.

Note about extensions

Both API and SDK extensions consist of various additional components which are excluded from the core artifacts to keep them from growing too large. We still aim to provide the same level of quality and guarantee for them as for the core components. Please don't hesitate to use them if you find them useful.

Project setup and contribute

Please refer to the contribution guide on how to setup and contribute!

Quick Start

Please refer to the quick start guide on how use the OpenTelemetry API.

Published Releases

Published releases are available on maven central.

Maven

  <dependencies>
    <dependency>
      <groupId>io.opentelemetry</groupId>
      <artifactId>opentelemetry-api</artifactId>
      <version>0.8.0</version>
    </dependency>
  </dependencies>

Gradle

dependencies {
	compile('io.opentelemetry:opentelemetry-api:0.8.0')
}

Snapshots

Snapshots based out the master branch are available for opentelemetry-api, opentelemetry-sdk and the rest of the artifacts:

Maven

  <repositories>
    <repository>
      <id>oss.sonatype.org-snapshot</id>
      <url>https://oss.jfrog.org/artifactory/oss-snapshot-local</url>
    </repository>
  </repositories>

  <dependencies>
    <dependency>
      <groupId>io.opentelemetry</groupId>
      <artifactId>opentelemetry-api</artifactId>
      <version>0.9.0-SNAPSHOT</version>
    </dependency>
  </dependencies>

Gradle

repositories {
	maven { url 'https://oss.jfrog.org/artifactory/oss-snapshot-local' }
}

dependencies {
	compile('io.opentelemetry:opentelemetry-api:0.8.0-SNAPSHOT')
}

Libraries will usually only need opentelemetry-api, while applications may want to use opentelemetry-sdk.

Releases

OpenTelemetry Java is under active development. Releases aren't guaranteed to conform to a specific version of the specification. Future releases will not attempt to maintain backwards compatibility with previous releases.

The latest version of the libraries were released on September 1st, 2020. See the v0.8.0 beta release.

This is a current feature status list:

Component Version
Tracing API v0.8.0
Tracing SDK v0.8.0
Metrics API v0.8.0
Metrics SDK v0.8.0
OTLP Exporter v0.8.0
Jaeger Trace Exporter v0.8.0
Zipkin Trace Exporter v0.8.0
Prometheus Metrics Exporter v0.8.0
Context Propagation v0.8.0
OpenTracing Bridge v0.8.0
OpenCensus Bridge N/A

See the project milestones for details on upcoming releases. The dates and features described in issues and milestones are estimates, and subject to change.

Summary

We plan to merge projects and pave the path for future improvements as a unified community of tracing vendors, users and library authors who wants apps be managed better. We are open to feedback and suggestions from all of you!

Contributing

See CONTRIBUTING.md

Approvers (@open-telemetry/java-approvers):

Find more about the approver role in community repository.

Maintainers (@open-telemetry/java-maintainers):

Find more about the maintainer role in community repository.

Thanks to all the people who have contributed

contributors