elastic/agent-skills1.7k installs

observability-edot-java-migrate

Q: How do I install this agent skill?

Run npx skills add https://github.com/elastic/agent-skills --skill observability-edot-java-migrate.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

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.

How do I install this agent skill?

npx skills add https://github.com/elastic/agent-skills --skill observability-edot-java-migrate

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
The skill provides legitimate migration instructions for transitioning from the legacy Elastic APM Java agent to the newer Elastic Distribution of OpenTelemetry (EDOT) agent. It references official documentation and standard software distribution channels.
Socketpass
No alerts
Snykpass
Risk: LOW · No issues
Runlayerwarn
1/1 file flagged

What does this agent skill do?

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.

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/elastic/agent-skills/observability-edot-java-migrate">View observability-edot-java-migrate on skillZs</a>