C# Academy · 课时

分布式跟踪

Q: 「分布式跟踪」这节课中我会学到什么？

使用 Activity 跨服务跟踪请求。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

使用 Activity 跨服务跟踪请求。

分布式跟踪 是 CoddyKit 上的免费 C# Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 4 节课。

什么是分布式追踪

分布式追踪会跟踪一个请求在各个服务和组件之间的传递过程。每个工作单元都会成为一个跨度，相互连接的跨度会形成一条追踪，并以嵌套操作的时间线呈现。

跨度与追踪

一个跨度包含名称、开始和结束时间、属性及状态。跨度可以嵌套：一个 parent 跨度（HTTP 请求）包含 child 跨度（数据库查询、出站调用）。整棵树共享一个追踪标识。

Activity 是 .NET 的跨度

在 .NET 中，System.Diagnostics.Activity 类是 OpenTelemetry 跨度的实现。您可以通过 ActivitySource 创建活动。

using System.Diagnostics;

private static readonly ActivitySource Source =
    new("Checkout.Orders");

启动 Activity

StartActivity 会开始一个跨度。请将它放在 using 中，以便代码块退出时结束跨度（记录其持续时间）。

using Activity activity = Source.StartActivity("PlaceOrder");
// work happens here; span ends when disposed

向跨度添加标签

标签（属性）会将键值形式的上下文附加到跨度上，例如订单标识或金额，使追踪更易于搜索，也更有意义。

activity?.SetTag("order.id", orderId);
activity?.SetTag("order.amount", amount);

记录事件与状态

使用 AddEvent 记录特定时间点的注释，并使用 SetStatus 标记成功或失败，这样错误就会显示在追踪后端中。

activity?.AddEvent(new ActivityEvent("inventory.reserved"));
activity?.SetStatus(ActivityStatusCode.Error, "Payment declined");

注册 ActivitySource

OpenTelemetry 只会收集通过 AddSource 注册的来源中的活动，因此请将您的 ActivitySource 名称告知追踪器。

builder.Services.AddOpenTelemetry()
    .WithTracing(tracing => tracing
        .AddSource("Checkout.Orders"));

自动插桩

内置插桩会自动为传入的 ASP.NET Core 请求和传出的 HttpClient 调用创建跨度，因此无需编写代码就能获得基础追踪数据。

tracing
    .AddAspNetCoreInstrumentation()
    .AddHttpClientInstrumentation();

上下文传播

要让一条追踪跨越多个服务，追踪标识必须在服务之间传递。OpenTelemetry 会将它注入传出的 HTTP 标头（W3C traceparent），并在接收端读取它，从而自动将各个跨度拼接成一条追踪。

parent 与 child 关系

当您在另一个活动仍处于当前状态时启动一个活动，新活动会通过 Activity.Current 成为它的 child。这种嵌套关系无需手动连接即可构建追踪树。

using var parent = Source.StartActivity("PlaceOrder");
using var child = Source.StartActivity("ChargeCard");
// child is nested under parent automatically

采样

跟踪每个请求可能成本很高。采样只记录其中一部分请求（例如 10%），在控制成本的同时保留具有代表性的数据。

快速检查

测试分布式追踪。

回顾

分布式追踪会跟随一个请求，并将共享追踪标识的跨度连接起来。在 .NET 中，Activity 就是跨度，它通过已注册的 ActivitySource 和 StartActivity 创建（使用 using 来结束它）。使用 SetTag、AddEvent 和 SetStatus 添加上下文。自动插桩结合 W3C 上下文传播，可以将跨服务的追踪拼接起来；采样则用于控制成本。

常见问题解答

「分布式跟踪」课时是免费的吗？

是的 — 「分布式跟踪」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 4 节课。

「分布式跟踪」这节课中我会学到什么？

使用 Activity 跨服务跟踪请求。你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 C# Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「分布式跟踪」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 C# Academy 课中编写并运行代码吗？

能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 C# Academy