OpenTelemetry in .NET：实现分布式跟踪、度量和日志记录-C#.Net教程-PHP中文网

OpenTelemetry in .NET：实现分布式跟踪、度量和日志记录

幻夢星雲

发布： 2025-12-02 19:42:10

原创

979人浏览过

OpenTelemetry为.NET应用提供统一可观测性，支持分布式追踪、指标采集和日志关联。通过ActivitySource实现请求路径跟踪，Meter记录性能数据如请求延迟，ILogger集成结构化日志并关联TraceId。使用AddOpenTelemetry配置OTLP导出至Jaeger、Prometheus等后端，推荐结合OpenTelemetry Collector进行数据聚合与分发，开发环境可启用控制台输出验证，生产环境需配置采样策略平衡性能与观测精度。上下文传播与采样设置是关键实践点。

opentelemetry in .net：实现分布式跟踪、度量和日志记录

在现代分布式系统中，尤其是基于微服务架构的应用，排查问题和监控性能变得越来越复杂。OpenTelemetry 是一个开源的、跨平台的可观测性框架，能够统一采集分布式追踪（Tracing）、指标（Metrics）和日志（Logs）。在 .NET 生态中，OpenTelemetry 提供了原生支持，帮助开发者轻松实现应用的全面可观测性。

分布式跟踪：追踪请求的完整路径

分布式跟踪用于记录一个请求在多个服务之间的流转过程。通过 OpenTelemetry，.NET 应用可以自动或手动创建跨度（Span），标记操作的开始与结束。

实现方式：

使用 ActivitySource 创建自定义跨度。.NET 的 System.Diagnostics.Activity 是 OpenTelemetry 跟踪的核心 API。
集成 ASP.NET Core 中间件，自动收集 HTTP 请求的跟踪信息。
通过 AddOpenTelemetry() 配置跟踪导出器，例如导出到 Jaeger、Zipkin 或 OTLP 后端。

示例代码：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddOpenTelemetry()
    .WithTracing(tracerProviderBuilder =>
    {
        tracerProviderBuilder
            .AddAspNetCoreInstrumentation()
            .AddHttpClientInstrumentation()
            .AddOtlpExporter(); // 发送到 OTLP 兼容后端
    });

登录后复制

度量（Metrics）：收集应用性能数据

度量用于记录随时间变化的数据，如请求数、响应延迟、CPU 使用率等。OpenTelemetry 提供了强大的指标 API，支持多种聚合方式。

关键组件：

Meter：用于创建指标，如计数器（Counter）、直方图（Histogram）。
通过 AddMeter() 注册感兴趣的 Meter 名称，启用自动采集。
使用 PeriodicExportingMetricReader 定期将指标导出到 Prometheus 或其他监控系统。

示例：记录请求处理时间

青泥AI

青泥学术AI写作辅助平台

302

查看详情

var meter = new Meter("MyApp", "1.0");
var requestDuration = meter.CreateHistogram<double>("request.duration", "ms");

// 在中间件中记录
requestDuration.Record(elapsed.TotalMilliseconds);

登录后复制

日志记录：结构化日志与上下文关联

OpenTelemetry 支持将日志与追踪上下文关联，使得日志能与特定请求的 TraceId 关联，便于调试。

集成方式：

使用 ILogger 记录日志，并启用 OpenTelemetry 日志集成。
通过 AddOpenTelemetry() 配置日志导出，将结构化日志发送到后端（如 Loki、OTLP）。
确保日志包含 TraceId 和 SpanId，实现跨系统日志追踪。

配置示例：

builder.Logging.AddOpenTelemetry(options =>
{
    options.IncludeFormattedMessage = true;
    options.IncludeScopes = true;
    options.ParseStateValues = true;
    options.AddOtlpExporter();
});

登录后复制