EDOT Java Instrumentation

Read the setup guide before making changes:

• EDOT Java setup

• OpenTelemetry Java agent

• EDOT Java configuration

Guidelines

• Use elastic-otel-javaagent.jar (download from GitHub releases, not a Maven/Gradle dependency)

• 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

• 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>"

• Do NOT set OTEL_TRACES_EXPORTER , OTEL_METRICS_EXPORTER , or OTEL_LOGS_EXPORTER — the defaults are already correct

• Never run both classic Elastic APM agent and EDOT agent on the same JVM

Examples

See the EDOT Java setup guide for complete Dockerfile and docker-compose examples.