SuperAPI AI 工具集

synth-check-status

部署与运维

查看项目

更新于 10-15 21:55

技能介绍

用途:查看 Grafana Synthetic Monitoring 的检查健康状况,包括检查清单、每个检查的通过/失败状态与成功率,以及成功率时间线(终端图表)。

主要能力:列出全部检查(NAME、JOB、TARGET、TYPE,NAME 后缀为数字检查 ID);查看全部或指定检查的状态(NAME、JOB、TARGET、SUCCESS、LATENCY、STATUS,可用 -o wide 显示 PROBES_UP/PROBES_TOTAL,-o json 输出全部字段);按 --status FAILING 过滤失败检查;用 timeline 查看成功率时间线。状态判定阈值取决于检查的 alertSensitivity:high 为 95%,medium/默认 90%,low 为 75%;OK 表示达到阈值,FAILING 表示低于阈值,NODATA 表示无 Prometheus 数据。

使用方式:始终先用 gcx synthetic-monitoring checks list 获取清单,可用 --job 'my-check*' 按名称过滤;再执行 gcx synthetic-monitoring checks status 或 status <ID>;时间线用 gcx synthetic-monitoring checks timeline <ID> --since <duration>,或 --from <start> --to <end>(--since 与 --from/--to 互斥)。时间线形态可判断:1.0 平线为健康,跌至 0 为探针级失败,间歇性尖峰为抖动,逐渐下降为退化。

适用场景:需要快速了解合成监控检查整体健康、定位失败检查、观察成功率趋势时。

限制与后续:FAILING 检查建议转 synth-investigate-check 做逐探针分析与失败分类;NODATA 需确认检查是否被禁用或数据源配置,可先执行 gcx synthetic-monitoring checks get <ID> -o json | jq '.spec.enabled' 验证,再考虑重新启用(转 synth-manage-checks);创建、更新、删除检查也转 synth-manage-checks。命令返回空时用 gcx config view 检查上下文;ID 报 not found 时从 list 的 NAME 数字后缀确认;时间线无数据可尝试更长时长。仅使用 gcx 命令,不直接调用 API。