EDOT Java Instrumentation

• EDOT Java setup
• OpenTelemetry Java agent
• EDOT Java configuration

Guidelines

1. Use

   elastic-otel-javaagent.jar

   (download from GitHub releases, not a Maven/Gradle dependency)
2. Attach via

   -javaagent:/path/to/elastic-otel-javaagent.jar

   or

   JAVA_TOOL_OPTIONS="-javaagent:/path/to/elastic-otel-javaagent.jar"

   — without this the agent does nothing
3. Set exactly three required environment variables:

   • OTEL_SERVICE_NAME

   • OTEL_EXPORTER_OTLP_ENDPOINT

     — must be the managed OTLP endpoint or EDOT Collector URL. Never use an APM Server URL (no

     apm-server

     , no

     :8200

     , no

     /intake/v2/events

     )

   • OTEL_EXPORTER_OTLP_HEADERS

     —

     "Authorization=ApiKey <key>"

     or

     "Authorization=Bearer <token>"

4. Do NOT set

   OTEL_TRACES_EXPORTER

   ,

   OTEL_METRICS_EXPORTER

   , or

   OTEL_LOGS_EXPORTER

   — the defaults are already correct
5. Never run both classic Elastic APM agent and EDOT agent on the same JVM

Examples