什么是 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 安装这些包：

配置 OpenTelemetry 在 Program.cs 中

在 .NET 6+ 的 Minimal API 模型中，可以在 Program.cs 中配置 OpenTelemetry。以下是一个典型配置示例：

这段代码启用了对 Web 请求和外部 HTTP 调用的自动追踪，并通过 OTLP 协议将追踪数据发送出去，默认会发往本地运行的 OpenTelemetry Collector 或兼容后端（如 http://localhost:4317）。

自定义追踪与添加上下文标签

除了自动收集，你还可以手动创建跨度（Span）来记录特定逻辑块的执行情况：

要使用自定义 Activity，需先定义 ActivitySource：

PPT.CN,PPTCN,PPT.CN是什么,PPT.CN官网,PPT.CN如何使用

一键操作，智能生成专业级PPT

37

查看详情

别忘了在项目中引用 System.Diagnostics.DiagnosticSource。

查看追踪数据

要看到收集的数据，你需要一个后端观测平台。常见选择包括：

• Jaeger：启动 Jaeger All-in-One 容器接收 OTLP 数据
• Zipkin：支持 Zipkin 格式导出（可替换 OtlpExporter 为 ZipkinExporter）
• OpenTelemetry Collector：作为中间代理，转发数据到多种后端

例如，使用 Docker 启动 Jaeger：

然后访问 http://localhost:16686 查看追踪界面。

基本上就这些。OpenTelemetry 在 .NET 中集成简单，自动化程度高，配合现代可观测性工具链能大幅提升问题排查效率。不复杂但容易忽略的是确保服务名称正确设置和网络可达性。

以上就是什么是 OpenTelemetry，如何集成到 .NET 应用中？的详细内容，更多请关注php中文网其它相关文章！