SuperAPI AI 工具集

opentelemetry-validation

通用与其它

查看项目

更新于 10-16 02:35

技能介绍

用途:验证已埋点的服务是否正确向 Observe 上报遥测,并在数据缺失或异常时协助排查。使用前提是 observe CLI 已完成认证与配置、generate-opal 技能可用、目标服务已部署运行。各验证查询存放在 references/ 目录下的独立文件中,应以这些文件为准。

主要能力:提供覆盖服务列表、埋点库列表、服务实例、服务入口点、Span 搜索、Span 事件、APM R.E.D 指标、运行时指标、基础设施指标、部署跟踪、性能分解、数据库服务检测与埋点审计等查询参考。指标类查询使用 generate-opal 及其 opal-* 子技能生成 OPAL,再执行 observe query --input <dataset-id> --pipeline '<opal>' --json。使用 pick_col 时须保留数据集的合法时间列,否则会报 no schema,例如 Tracing/Span 保留 start_time、end_time,Tracing/Deployment 保留 deployment_time 与 @."Valid To"。

使用方式分两条流程。验证流程:先用 observe auth status 确认租户并让用户确认,收集 deployment.environment.name、service.name 与可选 service.namespace,确认近期有代表性流量,等待 30–60 秒衍生遥测生成,再按顺序执行 9 项检查(数据集与服务可见性、入口点、R.E.D 指标、运行时指标、基础设施指标、部署跟踪、性能分解、数据库服务检测、埋点审计),结果为 PASS、FAIL、PENDING 或 SKIP,最后汇总为表格并对 FAIL 给出结构化失败报告。排查流程:同样先确认租户与作用域,再把症状归类为无服务、无 Span、部分覆盖、数据过时或不一致,收集证据、构建失败报告、按最早失败层定位根因,对依赖异步衍生数据的检查等待后重试一次,最后区分根因失败与连带失败并给出修复建议。

限制:需已认证的 observe CLI 与运行中的目标服务;验证依赖近期真实流量和衍生数据延迟;未提供价格、平台或效果等其它信息。