SKILL.md
EDOT Java Migration
Read the migration guide before making changes:
Guidelines
- Remove ALL classic APM references:
elastic-apm-agent.jar,elasticapm.properties, allELASTIC_APM_*env vars,
and any co.elastic.apm Maven/Gradle dependencies
- Use
elastic-otel-javaagent.jar(download from
Maven Central, not a Maven/Gradle
compile dependency)
- Attach via
-javaagent:/path/to/elastic-otel-javaagent.jaror
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(replacesELASTIC_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 <key>"or"Authorization=Bearer <token>"(replaces
ELASTIC_APM_SECRET_TOKEN / API_KEY)
- Do NOT set
OTEL_TRACES_EXPORTER,OTEL_METRICS_EXPORTER, orOTEL_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 migration guide for
complete examples.