EDOT .NET 迁移指南：从 Elastic APM 迁移到 OpenTelemetry 的完整步骤

observability-edot-dotnet-migrate by elastic/agent-skills

111 周安装量

136 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/elastic/agent-skills --skill observability-edot-dotnet-migrate

可观测性 .NET 监控

🇨🇳中文介绍

EDOT .NET 迁移指南

在进行更改前，请先阅读迁移指南：

指导原则

移除所有经典 APM 引用：移除 Elastic.Apm.* NuGet 包（包括 Elastic.Apm.NetCoreAll）、移除 UseAllElasticApm() / AddAllElasticApm() 调用、从 appsettings.json 中移除 ElasticApm 配置节，以及所有 ELASTIC_APM_* 环境变量。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

🇺🇸English

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>" or (replaces )
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.

Weekly Installs

111

Repository

elastic/agent-skills

GitHub Stars

136

First Seen

9 days ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

cursor103

opencode97

gemini-cli97

github-copilot97

codex97

amp96