SuperAPI AI 工具集

otel-component-telemetry

通用与其它

查看项目

更新于 10-16 09:47

技能介绍

用途:针对 OpenTelemetry 生态中的单个组件,在其已固定的上游标签版本上扫描代码,记录该组件发出的遥测数据(traces/span、metrics、logs),并写成按版本归档的清单文件。

主要能力:解析要扫描的版本(可为最近若干发布数量或一个精确标签);通过 git worktree 检出标签到临时目录;在源码中识别发出的遥测数据点;记录条件性发射(feature gate、opt-in 配置、实验性 semconv 环境变量),在 Notes 中标注门控名称;已存在结果文件的版本默认跳过,force 为 true 时重新扫描并与旧文件核对,只修正或补充错误、缺失的行,不改写整个文件;不修改其它组件的文件。

输出格式:每个已扫描版本输出一个 Markdown 文件,路径镜像仓库与组件路径,如 ${OutDir}/<repo basename>/<path>/v<version>.md。文件头部含 repo、path、version、scope_name、commit_sha、last_verified;正文按 Traces、Metrics、Logs 分节表格(列分别为 Span 名称/类型/属性/备注、Metric 名称/类型/单位/属性/备注、Log/event 名称/属性/备注),组件未发出的信号分节省略,不写空表;末尾 Sources 列出参考文件。

使用方式:该仓库已在本地克隆于 /tmp/otel-component-telemetry/<repo basename>,无需自行克隆;检出标签用 git worktree add "$(mktemp -d)" <tag>;只扫描固定标签而非分支。版本为数量时从 git tag 列出对应数量;为精确标签时只扫描该标签。Tag prefix 非空时只考虑以该字面前缀开头的标签,检出完整标签并在 frontmatter 与文件名中去掉前缀。在包与仓库标签独立版本化的 monorepo 中(如 opentelemetry-js 实验性包)且未提供标签前缀时,使用各发布标签下清单中的包自身版本,并以包版本命名文件。

限制:仅支持单个组件扫描;必须使用固定标签,不能扫描分支;输出依赖本地已克隆的仓库路径;关于定价、平台兼容性等资料暂未提供。