Migrate a Java application from the classic Elastic APM Java agent to the EDOT Java agent. Use when switching from elastic-apm-agent.jar to elastic-otel-javaagent.jar.
---
name: observability-edot-java-migrate
description: >
Migrate a Java application from the classic Elastic APM Java agent to the EDOT Java
agent. Use when switching from elastic-apm-agent.jar to elastic-otel-javaagent.jar.
metadata:
author: elastic
version: 0.1.1
---
# EDOT Java Migration
Read the migration guide before making changes:
- [Migration guide](https://www.elastic.co/docs/reference/opentelemetry/edot-sdks/java/migration)
- [EDOT Java setup](https://www.elastic.co/docs/reference/opentelemetry/edot-sdks/java/setup)
- [EDOT Java configuration](https://www.elastic.co/docs/reference/opentelemetry/edot-sdks/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
1. Use `elastic-otel-javaagent.jar` (download from
[Maven Central](https://mvnrepository.com/artifact/co.elastic.otel/elastic-otel-javaagent/latest), not a Maven/Gradle
compile dependency)… install to load the full skillIn any Claude conversation, say:
Install the Observability Edot Java Migrate skill
It activates automatically in your next session.
Not connected yet? Connect your AI first →
MCP endpoint
https://skillme.dev/api/mcp