可观测性的三大支柱
了解跟踪、指标和日志。
可观测性的三大支柱 是 CoddyKit 上的免费 C# Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 4 节课。
什么是可观测性
可观测性是指通过系统发出的数据了解其内部状态的能力。对于运行中的服务，它可以回答以下问题：服务是否健康、为什么变慢、哪里发生了故障？可观测性建立在三个支柱之上：跟踪、指标和日志。
什么是 OpenTelemetry
OpenTelemetry（OTel）是用于生成和导出遥测数据的、与厂商无关的标准和库集合。通过一次埋点，您可以将数据发送到 Jaeger、Prometheus 或 Grafana 等多个后端系统。
dotnet add package OpenTelemetry.Extensions.Hosting第一大支柱：日志
日志是带时间戳的离散事件记录（“用户 42 已登录”，“支付失败”）。日志提供详细且易于人阅读的上下文，但单独使用时可能噪声较多，也难以进行聚合。
logger.LogInformation("Order {OrderId} placed by {UserId}", orderId, userId);第二大支柱：指标
指标是随时间聚合的数值测量结果（请求数、错误率、延迟百分位数、CPU 使用率）。指标存储成本低，非常适合用于仪表板和告警。
第三大支柱：跟踪
跟踪会跟随单个请求在各项服务中的流转，并将其拆分为带有时间信息的跨度。它可以显示时间消耗在哪里，以及哪个依赖项导致了变慢。
三大支柱如何相互补充
指标告诉您是否出了问题（错误率突然升高）。跟踪告诉您哪里出了问题（支付服务）。日志告诉您为什么出了问题（某个特定订单发生了空引用）。三者结合起来，就能形成完整的调试线索。
关联是关键
真正的力量来自关联。在日志和跨度中附加共享的跟踪标识后，您可以从指标告警跳转到某个失败请求的确切跟踪及其日志。
OpenTelemetry 中的信号
OpenTelemetry 将这些支柱称为信号。 .NET 将它们映射为熟悉的基本构件：跟踪使用 Activity/ActivitySource，指标使用 Meter，日志使用 ILogger。
向宿主添加 OpenTelemetry
通过 AddOpenTelemetry() 启用这些信号，并配置跟踪和指标。接下来的课程会分别详细介绍它们。
builder.Services.AddOpenTelemetry()
.WithTracing(tracing => { })
.WithMetrics(metrics => { });资源属性
资源描述产生遥测数据的实体（服务名称、版本、环境）。一致地设置资源，可让后端正确地对数据进行分组和筛选。
builder.Services.AddOpenTelemetry()
.ConfigureResource(r => r.AddService(
serviceName: "checkout-api",
serviceVersion: "1.4.0"));自动插桩与手动插桩
OpenTelemetry 为 ASP.NET Core、HttpClient 等提供自动插桩，也支持在需要业务特定洞察时添加自定义跨度和指标的手动插桩。
快速检查
测试这三大支柱。
回顾
可观测性建立在三大支柱之上：日志（事件，说明原因）、指标（聚合数值，说明事实）和追踪（每个请求的跨度，说明位置）。OpenTelemetry 是与厂商无关的标准，可将这三者作为信号发出，并在 .NET 中分别映射到 Activity、Meter 和 ILogger。通过追踪标识进行关联，并正确设置资源，就能将它们联系起来。
常见问题解答
「可观测性的三大支柱」课时是免费的吗？
是的 — 「可观测性的三大支柱」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 4 节课。
「可观测性的三大支柱」这节课中我会学到什么？
了解跟踪、指标和日志。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 C# Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「可观测性的三大支柱」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 C# Academy 课中编写并运行代码吗？
能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。