当前位置:

首页 > 编程开发 > C#怎么创建分布式追踪_C# OpenTelemetry Tracing配置教程【高级】

C#怎么创建分布式追踪_C# OpenTelemetry Tracing配置教程【高级】

在分布式追踪配置中,必须手动显式注册ActivitySource和Exporter,否则trace数据会全部丢失。对于ASP.NETCore,需要安装AspNetCoreInstrumentation包并调用AddAspNetCoreInstrumentation方法。此外,ActivitySource的命名必须保持一致,否则链路会断裂。本地调试时若出现延迟

本文目录

    在分布式追踪的配置里,有个问题特别常见:明明代码里调了 StartActivity(),可 Jaeger 或者 Zipkin 那边就是干干净净,一条数据都收不到。这种时候,不用怀疑自己是不是写错了,八成是底层那几个关键组件没配好。

    C#怎么创建分布式追踪_C# OpenTelemetry Tracing配置教程【高级】

    为什么直接用 OpenTelemetry.Sdk 会收不到 trace?

    问题出在哪儿?其实很简单,就是默认配置下,TracerProvider 既没注册 ActivitySource,也没启用导出器(exporter)。你创建出来的 Activity 就像个没家的孩子,没人管,也没人把它送出去,自然就被丢弃了。

    核心就在于,你得把这三样东西显式地组装起来,少一个都不行:

    • ActivitySource:这是你代码里用来创建 span 的源头,它的名字必须跟后续的采样、过滤规则对得上。
    • TracerProviderBuilder:它必须调用 AddSource("your-service-name"),把你那个 source 注册进去,告诉它“嘿,你给我管着这个”。
    • Exporter:至少得配一个,比如 AddOtlpExporter(),否则 trace 数据无处可去,等于白忙活。

    一个典型的配置片段如下:

    var builder = Sdk.CreateTracerProviderBuilder()
        .AddSource("my-api") // 和 new ActivitySource("my-api") 对应
        .AddOtlpExporter(opt => opt.Endpoint = new Uri("http://localhost:4317")); // 必须设 endpoint

    ASP.NET Core 6+ 中如何自动注入 Activity 并关联 HTTP 上下文?

    很多人会习惯性地在每个 Controller 里手动写 StartActivity(),其实大可不必。OpenTelemetry.Instrumentation.AspNetCore 这个包已经帮你把 HTTP 入口的自动埋点做好了,前提是你得把它加到 TracerProvider 里。

    这里有三个容易漏掉的地方,你得留个心眼:

    • 首先,必须安装并引用 OpenTelemetry.Instrumentation.AspNetCore 这个 NuGet 包,光装 OpenTelemetry SDK 是不够的。
    • 其次,在 AddOpenTelemetry() 的链式调用里,必须显式地加上 .AddAspNetCoreInstrumentation()。
    • 最后,如果项目里用了 gRPC,还得额外加 OpenTelemetry.Instrumentation.GrpcNetClient 或对应的插件。

    不然的话,你会看到 Controller 方法里自己创建的 span 有数据,但最关键的 HTTP 请求本身的 root span 却缺失了,整个链路在入口处就断了,分析起来非常头疼。

    ActivitySource 命名不一致会导致 trace 断裂吗?

    会的,而且这个问题非常隐蔽。OpenTelemetry 的采样、资源标注,甚至 exporter 的过滤,都依赖 ActivitySource.Name。你要是代码里写 new ActivitySource("order-service"),但 TracerProvider 只注册了 AddSource("orderservice"),那么所有从这个 source 发出的 span 都会静默丢失,找都找不到原因。

    为了避免这种问题,建议统一规范:

    • 全部用小写字母加连字符,比如 "user-auth-service",避免大小写混用或下划线。
    • 在 Program.cs 初始化时,就定义一个常量:public const string ActivitySourceName = "user-auth-service";,然后在各处复用这个常量。
    • 检查日志输出,看看有没有类似 ActivitySource 'xxx' not registered 的警告提示(需要开启 OpenTelemetry 的内部日志)。

    本地调试时 trace 总是延迟 10 秒才上报?

    这是个很典型的“开发体验问题”。OtlpExporter 默认的 batch 处理行为是:攒够 512 条数据,或者等满 10 秒,才发一次。在开发阶段,这几乎等于“看不到实时 trace”,非常影响调试效率。

    解决方法很简单,就是在配置 exporter 时,显式地调小这些参数:

    .AddOtlpExporter(opt =>
    {
        opt.Endpoint = new Uri("http://localhost:4317");
        opt.BatchExportProcessorOptions = new BatchExportActivityProcessorOptions
        {
            ExporterTimeoutMilliseconds = 3000,
            MaxExportBatchSize = 1,
            ScheduledDelayMilliseconds = 100
        };
    });

    注意:MaxExportBatchSize = 1 虽然能带来最“实时”的体验,但会显著增加网络请求次数,这招只适合在调试时用。生产环境下,建议还是保留默认值,或者设为 512。

    另外,也别忘了检查一下后端接收服务(比如 otel-collector)是否已经启动,并且端口是可达的。很多人在排查时忽略了 HttpRequestException 这类错误,其实 exporter 连不上时,它只会默默降级,根本不会抛异常出来,所以数据出不来,你都不知道是哪里卡住了。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 C#
    相关文章 更多
    winforms教程自学入门与基础开发步骤详解
    winforms教程自学入门与基础开发步骤详解

    本教程详细讲解如何使用Visual Studio创建WinForms项目,通过添加按钮和标签控件并编写点击事件代码,实现一个基础的计数器功能,适合C#初学者快速上手Windows窗体应用开发。

    谈编程与编程语言
    谈编程与编程语言

    编程的本质是创造性的严谨翻译,通过for、if和函数调用实现重复计算任务。语言发展让集成度提高,门槛降低但竞争加剧。程序员需培养整体架构能力,抓住思想精髓而非追逐新技术,方能长远发展。

    什么是面向接口编程、面向过程编程、面向对象编程?
    什么是面向接口编程、面向过程编程、面向对象编程?

    面向接口编程通过接口解耦,降低耦合度并提升可扩展性和维护性,是面向对象思想的精髓。面向过程编程将问题拆解为步骤,用函数依次执行。面向对象编程将事物抽象为对象,封装属性和方法,通过对象协作解决问题。

    我对编程的一些感悟
    我对编程的一些感悟

    编程这件事,说到底是门手艺活,但又不全是手艺。把代码写出来容易,把代码写好、写出境界,那就得看功夫了。今天聊几个核心判断,算是多年敲键盘的一点沉淀。 一、语言是功夫,思路是内功 编程语言五花八门,就像武林高手会的功夫一样,但想成为顶尖高手,内功必须深厚。内功到了,学新功夫就是分分钟的事。看过《倚天屠

    c#如何使用abstract类_c#abstract类看这一篇就够了_保姆级教程
    c#如何使用abstract类_c#abstract类看这一篇就够了_保姆级教程

    abstract类不能被直接实例化,子类必须用override实现其所有抽象方法。抽象类可实现接口,并以抽象方法转发接口成员。抽象类不能与sealed共用,其抽象方法默认隐式virtual且无方法体。可包含字段、属性等非抽象成员。

    c#如何删除文件_c#删除文件的正确用法与注意事项
    c#如何删除文件_c#删除文件的正确用法与注意事项

    C#删除文件前应先判断存在性以防异常,注意权限不足和文件被占用。File.Delete与FileInfo.Delete功能相同,后者适合多次操作。无异步删除方法,推荐后台执行或限流以避免阻塞。

    c#如何使用EmguCV_c#EmguCV的最佳实践与常见坑点
    c#如何使用EmguCV_c#EmguCV的最佳实践与常见坑点

    在EmguCV中,进行Bitmap转Image时,需先转为24位无Alpha格式,以避免颜色错乱问题;Image转Bitmap时,建议使用Mat或ImageBox控件,以有效减少内存拷贝;跨线程处理时,应使用Mat.Clone()进行深拷贝,以确保数据安全;DLL加载失败时,需设置x64平台目标,并确保native库在输出目录中。

    C#怎么实现图表生成 C#如何用LiveCharts和OxyPlot绘制柱状图折线图饼图【图表】
    C#怎么实现图表生成 C#如何用LiveCharts和OxyPlot绘制柱状图折线图饼图【图表】

    C#图表生成中,LiveCharts需用ChartValues数据集合,并在更新后触发重绘;OxyPlot饼图需启用交互与标签;包引用务必注意版本适配;导出图片需在布局完成后操作,并校正DPI缩放以确保清晰度。

    C#怎么实现过滤器Filter_C# ASP.NET Core过滤器详解教程【进阶】
    C#怎么实现过滤器Filter_C# ASP.NET Core过滤器详解教程【进阶】

    ASP.NETCore过滤器需关注执行顺序、作用域与DI生命周期。接口实现需手动注册,特性继承更常用但需满足构造函数要求。全局注册时注意scoped服务注入问题,Order值须显式设置以控制同类型过滤器执行顺序。异常过滤器仅捕获操作方法内异常,模型绑定与授权失败须分别处理。

    c#如何实现鼠标钩子_c#鼠标钩子完整教程与实战案例
    c#如何实现鼠标钩子_c#鼠标钩子完整教程与实战案例

    实现全局鼠标钩子需使用SetWindowsHookEx配合WH_MOUSE_LL,窗体级事件仅捕获本进程消息。回调函数必须为静态且标记特定签名,禁止阻塞操作。通过Marshal.PtrToStructure解析lParam获取坐标与按键状态。钩子生命周期绑定线程,需注意注册线程持续运行并双重卸载,避免句柄泄漏。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。