observability-edot-python-migrate

Original：🇺🇸 English

Translated

Migrate a Python application from the classic Elastic APM Python agent to the EDOT Python agent. Use when switching from elastic-apm to elastic-opentelemetry.

2installs

Sourceelastic/agent-skills

Added on2026-03-17

NPX Install

npx skill4agent add elastic/agent-skills observability-edot-python-migrate

SKILL.md Content

View Translation Comparison →

EDOT Python Migration

Read the migration guide before making changes:

Guidelines

Remove ALL classic APM references:
```
elastic-apm
```
from requirements,
```
ElasticAPM(app)
```
/
```
elasticapm.contrib.*
```
from application code,
```
app.config['ELASTIC_APM']
```
blocks, and all
```
ELASTIC_APM_*
```
env vars
Install
```
elastic-opentelemetry
```
via pip (add to
```
requirements.txt
```
or equivalent)
Run
```
edot-bootstrap --action=install
```
during image build to install auto-instrumentation packages for detected libraries
Wrap the application entrypoint with
```
opentelemetry-instrument
```
— e.g.
```
opentelemetry-instrument gunicorn app:app
```
. Without this, no telemetry is collected

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

)

Do NOT set

OTEL_TRACES_EXPORTER

,

OTEL_METRICS_EXPORTER

, or

OTEL_LOGS_EXPORTER

— the defaults are already correct

Never run both classic
```
elastic-apm
```
and EDOT on the same application

Examples

See the EDOT Python migration guide for complete examples.