用途:这是一个按版本固定的遥测发射(Telemetry Emissions)登记表,用于查询 OpenTelemetry 组件实际发出了哪些遥测数据,包括 spans、metrics、logs 和 attributes。目标用户是需要核对运行时遥测来源、排查采集覆盖或编写消费端处理的工程人员。
主要能力:数据以每个被扫描版本一个 Markdown 文件的形式组织,路径形如 <repo basename>/<path in repo>/v<version>.md,例如 opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md。同一组件目录下的文件构成其遥测历史,index.md 列出全部文件,可作为入口查看覆盖范围。每个数据文件包含前置元信息(repo、path、version、scope_name、commit_sha、last_verified),随后按信号分表:Traces(span 名称、kind、属性、说明)、Metrics(指标名、instrument 类型、单位、属性、说明)、Logs(日志/事件名、属性、说明)。scope_name 是该组件的插桩 scope,用于把运行时遥测匹配回组件;未出现的信号会被整体省略;Notes 标记条件发射(feature gate、需显式开启的配置、实验性 semconv);Sources 列出数据来源的上游文件。
使用方式:先找到组件目录或其 index.md 中的行,选取与目标版本完全一致的文件;若没有精确匹配,则使用低于目标版本中最高的那个文件,并声明精确版本未经核实;若组件或版本完全未覆盖,应直接说明,不要依据 semantic conventions 推断遥测。
限制:资料明确提示,这些文件中的遥测发射由 LLM 对上游源码分析得出,可能存在错误,在用于关键决策前需对照组件源码或文档核实。其他细节暂未提供。