Agent-skills observability-edot-python-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-python-migrate" ~/.claude/skills/elastic-agent-skills-observability-edot-python-migrate && rm -rf "$T"

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

source content

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

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