EDOT Java Migration
Read the migration guide before making changes:
Migration guide
EDOT Java setup
EDOT Java configuration
Guidelines
Remove ALL classic APM references:
elastic-apm-agent.jar
,
elasticapm.properties
, all
ELASTIC_APM_*
env vars,
and any
co.elastic.apm
Maven/Gradle dependencies
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
(replaces
ELASTIC_APM_SERVICE_NAME
)
OTEL_EXPORTER_OTLP_ENDPOINT
— must be the
managed OTLP endpoint
or
EDOT Collector
URL. Do NOT reuse the
old
ELASTIC_APM_SERVER_URL
value. Never use an APM Server URL (no
apm-server
, no
:8200
, no
/intake/v2/events
)
OTEL_EXPORTER_OTLP_HEADERS
—
"Authorization=ApiKey
observability-edot-java-migrate
安装
npx skills add https://github.com/elastic/agent-skills --skill observability-edot-java-migrate