EDOT .NET Instrumentation

Read the setup guide before making changes:

• EDOT .NET setup

• EDOT .NET configuration

• OpenTelemetry .NET instrumentation

Guidelines

• Add NuGet packages: Elastic.OpenTelemetry and OpenTelemetry.Instrumentation.AspNetCore (for ASP.NET Core apps)

• Register EDOT in startup: call builder.AddElasticOpenTelemetry() on the IHostApplicationBuilder (in Program.cs

or equivalent). Without this, no telemetry is collected

• Set exactly three required environment variables:

• OTEL_SERVICE_NAME

• OTEL_EXPORTER_OTLP_ENDPOINT — must be the managed OTLP endpoint or EDOT Collector URL. 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>"

• Do NOT set OTEL_TRACES_EXPORTER , OTEL_METRICS_EXPORTER , or OTEL_LOGS_EXPORTER — the defaults are already correct

• Do NOT manually configure TracerProvider or MeterProvider — AddElasticOpenTelemetry() handles everything

• Never run both classic Elastic APM agent (Elastic.Apm.* ) and EDOT on the same application

Examples

See the EDOT .NET setup guide for complete examples.