You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

手动发送OpenTelemetry追踪时,instrumenting_module_name应如何设置?

手动追踪场景下instrumenting_module_name的设置指南

1. 基础场景的设置方案

当你仅在自身应用中手动发送追踪数据、无需对第三方组件做工具化时,直接使用项目/应用的固定名称作为instrumenting_module_name即可。比如你的项目名为my-ecommerce-service,就统一用这个字符串。

2. 全项目使用统一常量是否可行?

完全可行,甚至是推荐做法:

  • 能保证所有手动创建的Tracer归属同一工具作用域,在后端追踪系统中可以统一筛选、聚合你的应用产生的所有手动追踪数据。
  • 彻底避免了用__name__导致的跨文件名称不一致问题,契合官方文档中“使用固定字符串”的建议。

3. 何时需要设置不同名称?

只有当你需要区分应用内不同模块/业务域的追踪数据时,才需要使用不同名称:

  • 比如应用分为订单、支付、用户模块,可以分别用my-ecommerce-service.order、my-ecommerce-service.payment、my-ecommerce-service.user作为对应模块的instrumenting_module_name。
  • 这种设置能让你在追踪系统中单独查看某个模块的链路,方便快速定位特定业务域的问题。

4. 不当使用不同名称的影响

  • 若毫无规则地随意设置不同名称,会导致应用的追踪数据被分散到多个工具作用域下,难以统一查看和分析全链路。
  • 大幅增加后续排查问题的复杂度,比如你可能需要在多个作用域中搜索同一请求的追踪数据。

内容的提问来源于stack exchange,提问作者greatvovan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.28 12:57:05