SuperAPI AI 工具集

otel-components-telemetry

通用与其它

查看项目

更新于 10-16 09:47

技能介绍

用途:该技能提供一份按版本固定的遥测清单,记录 OpenTelemetry 采集器组件与 SDK 埋点包实际发出的遥测数据,包括 spans、metrics、logs 与 attributes,便于将运行时遥测回溯到对应组件。

主要能力:文件按 <repo basename>/<path in repo>/v<version>.md 组织,例如 opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md。每个扫描版本一个文件,组件目录下的文件构成其遥测历史,index.md 列出全部文件,可先从此处查看覆盖范围。数据文件包含 frontmatter(repo、path、version、scope_name、source_commit、last_verified),以及分信号表格:Traces 含 span 名称、kind、属性、备注;Metrics 含指标名、instrument 类型、单位、属性、备注;Logs 含日志/事件名、属性、备注。scope_name 是组件的 instrumentation scope,用于把运行时遥测匹配回组件;缺失的信号会被整体省略;Notes 标注条件性发出(如 feature gate、opt-in 配置、实验性 semconv);Sources 列出数据来源的上游文件。

使用方式:查找某版本组件时,先定位组件目录或 index.md 中的对应行,选取与目标版本完全一致的文件;若无完全匹配,则使用低于目标版本中最高的版本,并声明目标版本未经验证;若组件或版本完全未被覆盖,应直接说明,不要依据语义约定推断遥测。

适用场景:核对某个 OpenTelemetry 组件在特定版本下会发出哪些遥测、排查指标或日志来源、为采集配置与埋点分析提供版本对齐的参考。

限制:文件中的遥测发射信息由 LLM 分析上游源码检测得出,可能包含错误;在依赖某行做关键决策前,应对照组件源码或文档核验。未覆盖的组件或版本不应推断,官方其他说明暂未提供。