关于 otel-telemetry-emissions
otel-telemetry-emissions 是按上游版本整理 OpenTelemetry 组件实际发出遥测数据的目录。它适合需要按组件和版本查询 traces、metrics、logs 的用户;数据由 LLM 分析检测,关键决策前应核对来源。
主要功能
- 01按组件和版本组织记录
- 02列出 traces、metrics 和 logs
- 03记录信号属性及条件说明
- 04提供上游来源和版本元数据
适用场景
- 01确认特定组件版本发出的遥测信号
- 02比较不同版本的信号记录
- 03在使用记录前核验上游来源
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ ollygarden/ opentelemetry-agent-skills --skill otel-telemetry-emissions安装后在 Claude Code 中输入/otel-telemetry-emissions确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
index.mdevals/evals.jsonresults.mdopentelemetry-collector-contrib/connector/servicegraphconnector/v0.153.0.mdv0.154.0.mdv0.155.0.mdv0.156.0.mdv0.157.0.mdv0.158.0.mdv0.159.0.mdv0.160.0.mdv0.161.0.mdv0.162.0.mdv0.163.0.mdopentelemetry-collector-contrib/connector/spanmetricsconnector/v0.153.0.mdv0.154.0.mdv0.155.0.mdv0.156.0.mdv0.157.0.mdv0.158.0.mdv0.159.0.mdv0.160.0.mdv0.161.0.mdv0.162.0.mdv0.163.0.mdopentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/v0.154.0.mdv0.155.0.mdv0.156.0.mdv0.157.0.mdv0.158.0.md详细介绍
遥测发射
记录 OpenTelemetry 组件实际发出的遥测数据,并固定到上游版本。
注意: 这些文件中的遥测发射信息是通过 LLM 分析上游源代码检测得出的,可能包含错误。若要根据某行信息做出关键决策,请先对照组件的源代码或文档进行核实。
目录结构
<repo basename>/<path in repo>/v<version>.md
示例:opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md
每个扫描的版本对应一个文件。组件目录中的文件构成该组件的遥测历史记录;index.md 列出了所有文件——请先从这里开始,查看涵盖范围。
查询某个版本的组件
- 找到组件的目录(或其在
index.md中对应的行)。 - 选择与目标版本完全匹配的文件。
- 如果没有完全匹配的文件,请使用低于目标版本的最高版本文件,并说明该确切版本未经核实。
- 如果完全未涵盖该组件或版本,请如实说明——不要根据语义约定推断遥测信息。
数据文件包含的内容
Frontmatter(repo、path、version、scope_name、commit_sha、last_verified),随后是按信号分类的表格:
- Traces — Span 名称、类型、属性、备注
- Metrics — 指标名称、仪器类型、单位、属性、备注
- Logs — 日志/事件名称、属性、备注
scope_name 是组件的仪器作用域——用于将运行时遥测数据与组件匹配。辅助工具或管道遥测数据使用其他作用域时,对应行会在 Notes 中注明该作用域。last_verified: null 表示无法证实历史核实日期;在将对应行作为已核实信息提供之前,请重新检查固定版本的源代码。
未出现的信号会完全省略。Notes 标注条件式发射(功能门控、选择启用的配置、实验性 semconv)。Sources 列出数据所依据的上游文件。