Elastic Distribution of OpenTelemetry Java

The Elastic Distribution of OpenTelemetry Java (EDOT Java) is a customized version of the OpenTelemetry Java instrumentation. Use EDOT Java to start the OpenTelemetry SDK with your Java application, and automatically capture tracing data, performance metrics, and logs. Traces, metrics, and logs can be sent to any OpenTelemetry Protocol (OTLP) collector you choose.

With EDOT Java you have access to all the features and supported technologies of the OpenTelemetry Java instrumentation agent plus:

• additional features, for example:
  • Inferred spans
  • Span stacktrace
  • Elastic universal profiling integration
  • ...
• additional supported technologies

We welcome your feedback! You can reach us by opening a GitHub issue or starting a discussion thread on the Elastic Discuss forum.

Download

Latest release:

Latest snapshot:

Run

Use the -javaagent: JVM argument with the path to agent jar.

java -javaagent:/path/to/agent.jar \
-jar myapp.jar

Using the JAVA_TOOL_OPTIONS environment variable can be used when modifying the JVM command line is not possible.

Read the docs

• EDOT Java
• EDOT Java configuration
• EDOT Java migration from the Elastic APM Java agent

Build and Test

Execute ./gradlew assemble, the agent binary will be in ./agent/build/libs/elastic-otel-javaagent-${VERSION}.jar where ${VERSION} is the current project version set in version.properties.

You can run the tests locally using ./gradlew test. You can optionally specify the

• Java Version to test on, e.g. -PtestJavaVersion=8
• Java implementation to run on (hotspot or openJ9): -PtestJavaVM=openj9

You don't need to have a corresponding JVM installed, gradle automatically will download a matching one.

License

The Elastic Distribution of OpenTelemetry Java is licensed under Apache License, Version 2.0.