mcpField
O
observability-edot-dotnet-instrument

observability-edot-dotnet-instrument

github.com/elastic云与 DevOps6022.7k 次安装今天更新
代码仓库

关于 observability-edot-dotnet-instrument

用于为 .NET 应用配置 Elastic Distribution of OpenTelemetry（EDOT）监测的技能，涵盖 NuGet 包、启动注册和 OTLP 参数，无需手动配置 Provider。

主要功能

  1. 01添加 EDOT NuGet 包
  2. 02在启动时注册 EDOT
  3. 03设置必需的 OTLP 环境变量
  4. 04使用托管 OTLP 端点或 EDOT Collector
  5. 05避免同时使用传统 APM 和 EDOT

适用场景

  1. 01为 ASP.NET Core 应用添加监测
  2. 02配置 .NET 服务的遥测导出

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/observability-edot-dotnet-instrument确认已加载。

详细介绍

EDOT .NET 仪表化

进行更改前，请先阅读设置指南：

指南

  1. 添加 NuGet 包：Elastic.OpenTelemetry 和 OpenTelemetry.Instrumentation.AspNetCore（用于 ASP.NET Core 应用）
  2. 在启动时注册 EDOT：在 IHostApplicationBuilder 上调用 builder.AddElasticOpenTelemetry()（位于 Program.cs 或等效文件中）。如果没有这一步，就不会收集遥测数据
  3. 恰好设置以下三个必需的环境变量：
    • OTEL_SERVICE_NAME
    • OTEL_EXPORTER_OTLP_ENDPOINT — 必须是托管 OTLP 端点或 EDOT Collector URL。切勿使用 APM Server URL（不得包含 apm-server、:8200 或 /intake/v2/events）
    • OTEL_EXPORTER_OTLP_HEADERS — "Authorization=ApiKey <key>" 或 "Authorization=Bearer <token>"
  4. 不要设置 OTEL_TRACES_EXPORTER、OTEL_METRICS_EXPORTER 或 OTEL_LOGS_EXPORTER — 默认值已经正确
  5. 不要手动配置 TracerProvider 或 MeterProvider — AddElasticOpenTelemetry() 会处理所有配置
  6. 切勿在同一应用中同时运行经典 Elastic APM Agent（Elastic.Apm.*）和 EDOT

示例

完整示例请参阅 EDOT .NET 设置指南。

评论

支持 Markdown