🇺🇸English

EDOT Java Migration

Read the migration guide before making changes:

• Migration guide
• EDOT Java setup
• EDOT Java configuration

Guidelines

1. Remove ALL classic APM references: elastic-apm-agent.jar, elasticapm.properties, all ELASTIC_APM_* env vars, and any co.elastic.apm Maven/Gradle dependencies
2. Use elastic-otel-javaagent.jar (download from GitHub releases, not a Maven/Gradle dependency)
3. 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
4. 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 <key>" or "Authorization=Bearer <token>" (replaces / )
5. Do NOT set OTEL_TRACES_EXPORTER, OTEL_METRICS_EXPORTER, or OTEL_LOGS_EXPORTER — the defaults are already correct
6. Never run both classic Elastic APM agent and EDOT agent on the same JVM

Examples

See the EDOT Java migration guide for complete examples.

Weekly Installs

89

Repository

elastic/agent-skills

GitHub Stars

89

First Seen

8 days ago

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

cursor83

opencode76

gemini-cli76

github-copilot76

codex76

amp76