Migrate a Java application from the classic Elastic APM Java agent to the EDOT Java agent.
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.This is the skill's description: the text your AI reads to decide when the skill applies.
elastic-edot-java-migrate/SKILL.md
---
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)