mcpField
O
otel-telemetry-emissions

otel-telemetry-emissions

github.com/ollygarden云与 DevOps11772 次安装2 天前更新
代码仓库

关于 otel-telemetry-emissions

otel-telemetry-emissions 是按上游版本整理 OpenTelemetry 组件实际发出遥测数据的目录。它适合需要按组件和版本查询 traces、metrics、logs 的用户;数据由 LLM 分析检测,关键决策前应核对来源。

主要功能

  1. 01按组件和版本组织记录
  2. 02列出 traces、metrics 和 logs
  3. 03记录信号属性及条件说明
  4. 04提供上游来源和版本元数据

适用场景

  1. 01确认特定组件版本发出的遥测信号
  2. 02比较不同版本的信号记录
  3. 03在使用记录前核验上游来源

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions

安装后在 Claude Code 中输入/otel-telemetry-emissions确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

index.md
evals/
evals.json
results.md
opentelemetry-collector-contrib/connector/servicegraphconnector/
v0.153.0.md
v0.154.0.md
v0.155.0.md
v0.156.0.md
v0.157.0.md
v0.158.0.md
v0.159.0.md
v0.160.0.md
v0.161.0.md
v0.162.0.md
v0.163.0.md
opentelemetry-collector-contrib/connector/spanmetricsconnector/
v0.153.0.md
v0.154.0.md
v0.155.0.md
v0.156.0.md
v0.157.0.md
v0.158.0.md
v0.159.0.md
v0.160.0.md
v0.161.0.md
v0.162.0.md
v0.163.0.md
opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/
v0.154.0.md
v0.155.0.md
v0.156.0.md
v0.157.0.md
v0.158.0.md

详细介绍

遥测发射

记录 OpenTelemetry 组件实际发出的遥测数据,并固定到上游版本。

注意: 这些文件中的遥测发射信息是通过 LLM 分析上游源代码检测得出的,可能包含错误。若要根据某行信息做出关键决策,请先对照组件的源代码或文档进行核实。

目录结构

<repo basename>/<path in repo>/v<version>.md

示例:opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md

每个扫描的版本对应一个文件。组件目录中的文件构成该组件的遥测历史记录;index.md 列出了所有文件——请先从这里开始,查看涵盖范围。

查询某个版本的组件

  1. 找到组件的目录(或其在 index.md 中对应的行)。
  2. 选择与目标版本完全匹配的文件。
  3. 如果没有完全匹配的文件,请使用低于目标版本的最高版本文件,并说明该确切版本未经核实。
  4. 如果完全未涵盖该组件或版本,请如实说明——不要根据语义约定推断遥测信息。

数据文件包含的内容

Frontmatter(repo、path、version、scope_name、commit_sha、last_verified),随后是按信号分类的表格:

  • Traces — Span 名称、类型、属性、备注
  • Metrics — 指标名称、仪器类型、单位、属性、备注
  • Logs — 日志/事件名称、属性、备注

scope_name 是组件的仪器作用域——用于将运行时遥测数据与组件匹配。辅助工具或管道遥测数据使用其他作用域时,对应行会在 Notes 中注明该作用域。last_verified: null 表示无法证实历史核实日期;在将对应行作为已核实信息提供之前,请重新检查固定版本的源代码。

未出现的信号会完全省略。Notes 标注条件式发射(功能门控、选择启用的配置、实验性 semconv)。Sources 列出数据所依据的上游文件。

评论

支持 Markdown