OpenTelemetry为.NET应用提供统一可观测性，支持分布式追踪、指标采集和日志关联。通过ActivitySource实现请求路径跟踪，Meter记录性能数据如请求延迟，ILogger集成结构化日志并关联TraceId。使用AddOpenTelemetry配置OTLP导出至Jaeger、Prometheus等后端，推荐结合OpenTelemetry Collector进行数据聚合与分发，开发环境可启用控制台输出验证，生产环境需配置采样策略平衡性能与观测精度。上下文传播与采样设置是关键实践点。
在现代分布式系统中，尤其是基于微服务架构的应用，排查问题和监控性能变得越来越复杂。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 或其他监控系统。
示例：记录请求处理时间
var meter = new Meter("MyApp", "1.0");
var requestDuration = meter.CreateHistogram("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();
});
统一导出与后端集成
OpenTelemetry 支持通过 OTLP（OpenTelemetry Protocol）将跟踪、度量和日志发送到统一的后端，如 Jaeger、Prometheus、Grafana Tempo、OpenTelemetry Collector 等。
推荐实践：
- 使用 OpenTelemetry Collector 作为中间代理，接收、处理并转发数据到多个后端。
- 在开发环境使用控制台输出快速验证，在生产环境切换为 OTLP 导出。
- 设置采样策略，避免产生过多数据影响性能。
基本上就这些。通过 OpenTelemetry，.NET 应用可以实现开箱即用的可观测性，无需绑定特定厂商工具，灵活适配各种监控体系。不复杂但容易忽略的是上下文传播和数据采样配置，合理设置才能发挥最大价值。
