SuperAPI AI 工具集

opentelemetry

部署与运维

查看项目

更新于 10-15 15:32

技能介绍

OpenTelemetry 是一个用于可观测性(observability)的开源框架与规范集合,目标是为追踪、指标和日志提供厂商中立的采集与导出方式。本条目介绍的是在 Claude 技能库中的 OpenTelemetry 可观测性模式,属于概念与实践指导类内容。

用途方面,该技能围绕可观测性信号的采集与传输展开,帮助使用者在系统中建立统一的 traces、metrics、logs 数据通路,并处理上下文传播(context propagation)、OTLP 导出、Collector 管道以及相关问题排查。

主要能力与快速上手要点:

  1. 通过 OpenTelemetry Collector 以厂商中立的端点导出 OTLP 数据;
  2. 标准化资源属性(resource attributes),例如 service.name、service.version、deployment.environment;
  3. 从自动埋点(auto-instrumentation)开始,再逐步加入手动 span 与日志关联(log correlation)。

参考文档分为三部分:

  • references/concepts.md:讲解 traces、metrics、logs 三类信号,上下文传播、采样(sampling)与语义约定(semantic conventions);
  • references/collector-and-otlp.md:讲解 Collector 管道、处理器(processors)、部署模式与尾部采样(tail sampling);
  • references/instrumentation-and-troubleshooting.md:讲解手动 span、传播陷阱、基数(cardinality)问题与调试方法。

适用场景:需要在分布式系统中建立或改进可观测性体系、统一遥测数据采集与导出、排查追踪与指标问题的开发者与运维人员。

限制:本条目的官方文本未提供,缺少具体的安装命令、代码示例、支持平台、收费与价格等信息,暂未提供。上述内容仅为概念与参考文档层面的说明,实际使用需结合完整的 OpenTelemetry 官方文档与项目环境。