用途:为 .NET 应用接入 Elastic Distribution of OpenTelemetry(EDOT).NET SDK,自动采集追踪、指标与日志。使用前应先阅读 EDOT .NET 安装与配置指南以及 OpenTelemetry .NET 插桩文档。
主要能力与用法:添加 NuGet 包 Elastic.OpenTelemetry,ASP.NET Core 应用还需添加 OpenTelemetry.Instrumentation.AspNetCore;在启动时(Program.cs 或等价位置)对 IHostApplicationBuilder 调用 builder.AddElasticOpenTelemetry(),否则不会采集任何遥测数据。需设置三个必需环境变量:OTEL_SERVICE_NAME;OTEL_EXPORTER_OTLP_ENDPOINT,必须为托管 OTLP 端点或 EDOT Collector 地址,不可使用 APM Server URL(不得含 apm-server、:8200 或 /intake/v2/events);OTEL_EXPORTER_OTLP_HEADERS,格式为 "Authorization=ApiKey <key>" 或 "Authorization=Bearer <token>"。
限制与注意事项:不要设置 OTEL_TRACES_EXPORTER、OTEL_METRICS_EXPORTER、OTEL_LOGS_EXPORTER,默认值已正确;不要手动配置 TracerProvider 或 MeterProvider,AddElasticOpenTelemetry() 已处理;切勿在同一应用上同时运行经典 Elastic APM 代理(Elastic.Apm.*)与 EDOT。完整示例见 EDOT .NET 安装指南。