SuperAPI AI 工具集

kibana-otel-instrumentation

测试与质量

查看项目

更新于 10-15 21:37

技能介绍

用途:在 Kibana 代码中正确接入 OpenTelemetry 指标,基于 @kbn/metrics。仅负责 OTel 接线,不决定测什么、不设计周边逻辑、不负责从代码库中取值。

主要能力:读取并遵循 src/platform/packages/private/opentelemetry/kbn-metrics/README.md 的规则;确定完全限定指标名(含 SemConv 检查与命名约定);选择正确的仪器类型(Counter、UpDownCounter、Gauge、Histogram);决定 push 还是 observable,并合并共享 fetcher 的 observable;设置 description、unit、valueType;设计正交属性;生成 meter 设置与指标创建代码;在 @otel: 标记处插入 emit 调用;对自身输出运行审查清单。

使用方式:开发者需先准备好指标清单、周边代码、@otel: 标记和属性值。标记格式示例:// @otel: kibana.elasticsearch.cps.request.count { outcome: result.outcome, target: host };observable 用 @otel(observable):,批量 observable 用 @otel(batch-observable): 配合 @otel-metric: 与 @otel-attr:。可用 grep -nE "@otel(\(|:)" . 查找标记。模式包括 Instrument、Review/QC、Debug。实现分两阶段:先锁定每项指标的设计契约并获用户确认,再写代码。

适用场景:为 Kibana 新增或修改 OTel 指标埋点、评审既有埋点、排查指标未出现的问题。

限制:不决定测量内容与原因,不决定何时发射,不提供属性值来源,不修改 OTel 设置与 emit 调用以外的代码。若属性值缺失,会插入 /* TODO: <attr-key> */ 占位符并列出待填项。README 为最终事实来源,冲突时以 README 为准。具体配置形状、收费与平台信息暂未提供。