Migrate a .NET application from the classic Elastic APM .NET agent to the EDOT .NET SDK. Use when switching from Elastic.Apm.* packages to Elastic.OpenTelemetry.
Read the migration guide before making changes:
Elastic.Apm.* NuGet packages (including Elastic.Apm.NetCoreAll),
UseAllElasticApm() / AddAllElasticApm() calls, the section from , and all
env varsElasticApmappsettings.jsonELASTIC_APM_*Elastic.OpenTelemetry and OpenTelemetry.Instrumentation.AspNetCore (for ASP.NET Core apps)builder.AddElasticOpenTelemetry() on the IHostApplicationBuilder (in Program.cs
or equivalent). Without this, no telemetry is collectedOTEL_SERVICE_NAME (replaces ELASTIC_APM_SERVICE_NAME / ElasticApm:ServiceName)OTEL_EXPORTER_OTLP_ENDPOINT — must be the managed OTLP endpoint or EDOT Collector URL. Do NOT reuse the
old ELASTIC_APM_SERVER_URLS 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)OTEL_TRACES_EXPORTER, OTEL_METRICS_EXPORTER, or OTEL_LOGS_EXPORTER — the defaults are already
correctElastic.Apm.*) and EDOT on the same applicationSee the EDOT .NET migration guide for complete examples.