Agent-skills observability-edot-java-migrate

install

source · Clone the upstream repo

git clone https://github.com/elastic/agent-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/elastic/agent-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/observability/edot-java-migrate" ~/.claude/skills/elastic-agent-skills-observability-edot-java-migrate && rm -rf "$T"

manifest: skills/observability/edot-java-migrate/SKILL.md

source content

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

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

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