observability-edot-java-migrate

>

INSTALLATION
npx skills add https://github.com/elastic/agent-skills --skill observability-edot-java-migrate
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

EDOT Java Migration

Read the migration guide before making changes:

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

Maven Central, not a Maven/Gradle

compile 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 <key>" or "Authorization=Bearer <token>" (replaces

ELASTIC_APM_SECRET_TOKEN / API_KEY)

  • 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 migration guide for

complete examples.

BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card