导出到后端
将遥测数据发送到 OTLP 收集器和工具。
导出到后端 是 CoddyKit 上的免费 C# Academy 课时。 这是第 4 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 C# Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 4 节课。
导出遥测数据
生成追踪和指标只是工作的一半;您还必须将它们导出到能够存储、查询和可视化数据的后端。OpenTelemetry 使用导出器完成这项工作。
导出器
导出器会将遥测数据发送到目标位置。不同导出器面向不同系统:控制台(用于开发)、OTLP(标准协议)以及特定厂商的导出器。
控制台导出器
控制台导出器会将遥测数据打印到终端,非常适合在开发期间验证插桩是否正常工作。
builder.Services.AddOpenTelemetry()
.WithTracing(t => t.AddConsoleExporter())
.WithMetrics(m => m.AddConsoleExporter());什么是 OTLP
OTLP(OpenTelemetry 协议)是用于传输遥测数据的、与厂商无关的线路格式。通过 OTLP 导出,您可以将数据发送到任何兼容 OTLP 的后端,而无需修改应用代码。
dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol配置 OTLP 导出器
添加 AddOtlpExporter,并将其指向您的收集器或后端端点。
builder.Services.AddOpenTelemetry()
.WithTracing(t => t.AddOtlpExporter(o =>
{
o.Endpoint = new Uri("http://localhost:4317");
}))
.WithMetrics(m => m.AddOtlpExporter());OpenTelemetry 收集器
收集器是一个独立进程,负责接收遥测数据、处理数据(批处理、筛选、补充信息),然后将数据转发到一个或多个后端。它可以将应用与特定厂商解耦。
为什么使用收集器
直接将数据发送给某个厂商会使应用与该厂商紧密绑定。收集器可以让您切换到其他后端或将数据分发到多个后端,在中央位置执行采样和脱敏,并减轻服务的负载。
常见后端
追踪通常发送到 Jaeger 或 Tempo,指标发送到 Prometheus,仪表板发送到 Grafana。日志可以流入 Loki 或 ELK 堆栈。所有这些系统都可以通过收集器接收 OTLP。
连接所有组件
典型设置会在同一个代码块中配置资源、来源、仪表和 OTLP 导出器,让追踪和指标流向您的收集器。
builder.Services.AddOpenTelemetry()
.ConfigureResource(r => r.AddService("checkout-api"))
.WithTracing(t => t
.AddAspNetCoreInstrumentation()
.AddSource("Checkout.Orders")
.AddOtlpExporter())
.WithMetrics(m => m
.AddAspNetCoreInstrumentation()
.AddMeter("Checkout.Orders")
.AddOtlpExporter());导出日志
OpenTelemetry 也可以导出日志。请将它接入日志记录管道,使日志记录携带相同的追踪上下文,并通过 OTLP 到达您的后端。
builder.Logging.AddOpenTelemetry(o =>
{
o.AddOtlpExporter();
});批处理与可靠性
导出器会对遥测数据进行批处理以减少开销,并在失败时重试。请根据数据量调整批大小和超时时间,并优先使用收集器吸收突发流量,以确保应用线程在导出时不会被阻塞。
快速检查
测试向后端导出数据。
回顾
导出器会将遥测数据发送到后端。控制台导出器有助于开发;OTLP是与厂商无关的协议,并与 AddOtlpExporter 配合使用。将 OTLP 发送到OpenTelemetry 收集器可以让应用解耦,集中处理批处理、采样和路由,并将数据分发到 Jaeger、Prometheus 和 Grafana 等后端。日志也可以用相同方式导出,同时携带追踪上下文。
常见问题解答
「导出到后端」课时是免费的吗?
是的 — 「导出到后端」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 C# Academy 课程的其余内容,请升级到 CoddyKit PRO。 C# Academy 课程共包含 4 节课。
「导出到后端」这节课中我会学到什么?
将遥测数据发送到 OTLP 收集器和工具。 你通过在浏览器中直接运行的动手代码来练习 C# Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 C# Academy 需要有经验吗?
无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 4 节课,共 4 节。
「导出到后端」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 C# Academy 课中编写并运行代码吗?
能。每节 C# Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。