OpenTelemetry 集成于 .NET 应用中的方法与步骤解析

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 中集成简单，自动化程度高，配合现代可观测性工具链能大幅提升问题排查效率。不复杂但容易忽略的是确保服务名称正确设置和网络可达性。

本文转载于：互联网 如有侵犯，请联系zhengruancom@outlook.com删除。
免责声明：正软商城发布此文仅为传递信息，不代表正软商城认同其观点或证实其描述。