SKILL.md
EDOT Python Migration
Read the migration guide before making changes:
Guidelines
- Remove ALL classic APM references:
elastic-apmfrom requirements,ElasticAPM(app)/elasticapm.contrib.*from
application code, app.config['ELASTIC_APM'] blocks, and all ELASTIC_APM_* env vars
- Install
elastic-opentelemetryvia pip (add torequirements.txtor equivalent)
- Run
edot-bootstrap --action=installduring 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(replacesELASTIC_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, orOTEL_LOGS_EXPORTER— the defaults are already
correct
- Never run both classic
elastic-apmand EDOT on the same application
Examples
See the EDOT Python migration guide
for complete examples.