CnOps 智能运维与可观测社区
首页开源项目实践文章视频课程常见问答开发者工具STAROps 专题
导航菜单
首页开源项目实践文章视频课程常见问答开发者工具STAROps 专题

CnOps 智能运维与可观测社区

愿景

CnOps 智能运维与可观测社区是一个以"智能运维与可观测"为核心的开放、包容、分享的技术社区,旨在聚集运维专家、开发者和爱好者,共同探讨、学习和分享可观测最佳实践与最新技术,与众多技术社区合作互动,共同探讨交叉领域的技术挑战,推动可观测领域的创新与进步。

内容社区

  • 实践文章
  • 视频课程
  • 开源项目
  • 常见问答
  • 开发者工具

友情链接

  • Prometheus
  • Grafana Lab
  • OpenTelemetry
  • LoongCollector

关注我们

阿里云云原生公众号阿里云云原生
阿里云可观测公众号阿里云可观测

Copyright © 2026 CnOps 社区. All rights reserved.

首页/开源项目/OpenTelemetry/插桩范围
文档目录
文档开始手动插桩使用插桩库导出器资源采样什么是 OpenTelemetry?
可观测性入门上下文传播
组件语义约定Resources(资源)插桩范围采样Distributions(发行版)术语表
API 参考文档示例
支持库列表

OpenTelemetry

插桩范围

插桩范围代表应用代码中的一个逻辑单元。 所输出的遥测数据可关联到该逻辑单元。 开发者可以决定什么代表合理的插桩范围。 例如,他们可以选择模块、包或类作为插桩范围。 在库或框架的情况下,常用的方法是使用对库或框架唯一的标识符作为范围,例如库或框架的完全限定名称和版本。 如果库本身没有内置的 OpenTelemetry 插桩,而是使用插桩库,则使用插桩库的名称和版本作为插桩范围。...

插桩范围代表应用代码中的一个逻辑单元。
所输出的遥测数据可关联到该逻辑单元。

开发者可以决定什么代表合理的插桩范围。
例如,他们可以选择模块、包或类作为插桩范围。
在库或框架的情况下,常用的方法是使用对库或框架唯一的标识符作为范围,例如库或框架的完全限定名称和版本。
如果库本身没有内置的 OpenTelemetry 插桩,而是使用插桩库,则使用插桩库的名称和版本作为插桩范围。

当从提供程序获取链路追踪器、指标计量器或日志记录器实例时,插桩范围由名称和版本对定义。
该实例创建的每个 Span、指标或日志记录都与提供的插桩范围关联。

在你的可观测性后端中,范围划分允许你按作用域对遥测数据进行多维度拆解分析。
例如,查看你的用户正在使用哪个版本的库以及该库版本的性能如何,或者将问题定位到应用程序的特定模块。

下图展示了一个具有多个插桩范围的链路。
不同的范围由不同的颜色表示:

  • 顶部的 /api/placeOrder Span 由使用的 HTTP 框架生成。
  • 绿色的 Span(CheckoutService::placeOrder、prepareOrderItems 和 checkout)是应用程序代码,按 CheckoutService 类分组。
  • CartService::getCart 和 ProductService::getProduct 的 Span 也是应用程序代码,按 CartService 和 ProductService 类分组。
  • 橙色(Cache::find)和浅蓝色(DB::query)的 Span 是库代码,按库名称和版本分组。

此图展示了具有多个插桩范围的链路