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

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

source content

EDOT .NET Migration

Read the migration guide before making changes:

Guidelines

Remove ALL classic APM references:

Elastic.Apm.*

NuGet packages (including

Elastic.Apm.NetCoreAll

UseAllElasticApm()

AddAllElasticApm()

calls, the

ElasticApm

section from

appsettings.json

, and all

ELASTIC_APM_*

env vars

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

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

"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 agent (
```
Elastic.Apm.*
```
) and EDOT on the same application

Examples

See the EDOT .NET migration guide for complete examples.