由 dawei 在现代分布式系统中，一次请求可能跨越多个服务节点，从用户发起到最终响应，涉及数十个微服务调用。传统的日志排查方式已难以定位问题根源，此时分布式追踪（Distributed Tracing）成为不可或缺的利器。ASP.NET Core 作为主流开发框架，提供了强大的集成能力，让分布式追踪变得触手可及。
实现分布式追踪的核心在于“上下文传播”。每个请求在跨服务传递时，必须携带唯一的跟踪标识（Trace ID）和上下文信息。ASP.NET Core 中可通过 `Activity` 类实现基础追踪，它会自动创建并管理当前请求的执行上下文，确保链路完整可追溯。
推荐使用 OpenTelemetry 作为统一的追踪标准。通过 NuGet 安装 `OpenTelemetry.Exporter.Console`、`OpenTelemetry.Trace` 等包，即可快速接入。在 `Program.cs` 中配置如下：
“`csharp
builder.Services.AddOpenTelemetryTracing(tracerProviderBuilder =>
{
tracerProviderBuilder.AddSource(\”MyApp\”);
tracerProviderBuilder.AddConsoleExporter();
});
“`
这样，所有带有 `ActivitySource` 的代码段都会被自动记录。
AI生成的趋势图，仅供参考
在实际应用中，需在每个服务入口处注入追踪上下文。例如，在控制器或中间件中添加：
“`csharp
var activity = new Activity(\”HttpServer\”);
activity.Start();
“`
同时，利用 `Activity.Current?.Id` 获取当前追踪上下文，并在调用下游服务时通过 HTTP Header 传递 `traceparent`，确保链路连贯。
对于跨服务调用，如使用 HttpClient，应启用 `ActivityPropagation`。在 `HttpClientFactory` 配置中加入：
“`csharp
services.AddHttpClient(\”ServiceA\”, client =>
{
client.BaseAddress = new Uri(\”https://api.servicea.com\”);
}).AddHttpMessageHandler();
“`
自定义 `TracingHandler` 可以自动注入追踪头信息，实现无侵入式追踪。
•建议将追踪数据发送至集中式平台，如 Jaeger、Prometheus + Tempo。通过可视化界面，开发者可清晰查看请求链路耗时、错误节点与依赖关系，大幅缩短故障排查时间。
分布式追踪不仅是技术工具，更是一种工程思维。掌握它，意味着你能在复杂系统中精准“导航”，让每一次请求都透明可见。