OpenTelemetry在.NET中通过集成SDK实现追踪、指标和日志的统一采集，使用NuGet包如OpenTelemetry.Extensions.Hosting和Instrumentation组件，在Program.cs中配置ASP.NET Core和HttpClient的自动监控，并通过OTLP导出数据；结合Jaeger等后端可查看调用链，需确保服务名设置正确且网络通畅。
OpenTelemetry 是一个开源的观测性框架，用于统一采集应用的追踪（Tracing）、指标（Metrics）和日志（Logs）。它帮助开发者监控分布式系统中的请求流程，定位性能瓶颈，并了解服务间的调用关系。在 .NET 应用中集成 OpenTelemetry，可以轻松实现对 HTTP 请求、数据库调用、依赖服务等操作的自动遥测数据收集。
安装必要的 NuGet 包
要在 .NET 应用中启用 OpenTelemetry，需要引入相关 SDK 和扩展包。以下是最常用的几个包：
- OpenTelemetry：核心库
- OpenTelemetry.Extensions.Hosting：与 ASP.NET Core 集成
- OpenTelemetry.Instrumentation.AspNetCore：自动收集 ASP.NET Core 请求信息
- OpenTelemetry.Instrumentation.Http：跟踪 HttpClient 调用
- OpenTelemetry.Exporter.Otlp：将数据导出到 OTLP 支持的后端（如 Jaeger、Prometheus、Tempo 等）
通过命令行或 Visual Studio 安装这些包：
dotnet add package OpenTelemetry.Extensions.Hosting dotnet add package OpenTelemetry.Instrumentation.AspNetCore dotnet add package OpenTelemetry.Instrumentation.Http dotnet add package OpenTelemetry.Exporter.Otlp配置 OpenTelemetry 在 Program.cs 中
在 .NET 6+ 的 Minimal API 模型中，可以在 Program.cs 中配置 OpenTelemetry。以下是一个典型配置示例：
var builder = WebApplication.CreateBuilder(args); // 添加 OpenTelemetry 服务 builder.Services.AddOpenTelemetry() .WithTracing(tracing => tracing .AddAspNetCoreInstrumentation() // 监控 ASP.NET Core 请求 .AddHttpClientInstrumentation() // 监控 HttpClient 调用 .AddOtlpExporter()); // 导出到 OTLP 接收器 var app = builder.Build(); app.MapGet("/", () => "Hello World!"); app.Run();这段代码启用了对 Web 请求和外部 HTTP 调用的自动追踪，并通过 OTLP 协议将追踪数据发送出去，默认会发往本地运行的 OpenTelemetry Collector 或兼容后端（如 http://localhost:4317）。
自定义追踪与添加上下文标签
除了自动收集，你还可以手动创建跨度（Span）来记录特定逻辑块的执行情况：
using var activity = MyActivitySource.StartActivity("BusinessOperation"); activity?.SetTag("user.id", "123"); // 执行业务逻辑要使用自定义 Activity，需先定义 ActivitySource：
public static class MyActivitySource { public static readonly ActivitySource Instance = new ActivitySource("MyApp"); }
别忘了在项目中引用 System.Diagnostics.DiagnosticSource。
查看追踪数据
要看到收集的数据，你需要一个后端观测平台。常见选择包括：
- Jaeger：启动 Jaeger All-in-One 容器接收 OTLP 数据
- Zipkin：支持 Zipkin 格式导出（可替换 OtlpExporter 为 ZipkinExporter）
- OpenTelemetry Collector：作为中间代理，转发数据到多种后端
例如，使用 Docker 启动 Jaeger：
docker run -d --name jaeger \ -e COLLECTOR_OTLP_ENABLED=true \ -p 16686:16686 \ -p 4317:4317 \ jaegertracing/all-in-one然后访问 http://localhost:16686 查看追踪界面。
基本上就这些。OpenTelemetry 在 .NET 中集成简单，自动化程度高，配合现代可观测性工具链能大幅提升问题排查效率。不复杂但容易忽略的是确保服务名称正确设置和网络可达性。
