SuperAPI AI 工具集

slo-investigate

通用与其它

查看项目

更新于 10-15 21:55

技能介绍

用途:对违反目标的 Grafana SLO 做深度排查,定位根因。面向有经验的运维人员,不提供基础引导。

主要能力:获取 SLO 定义与状态;渲染时间线判断违规起始与严重程度;按维度(如 cluster、namespace、service、status_code、endpoint)拆解成功率与错误率;搜索相关告警规则并查看状态;提取 runbook 与仪表盘 URL,必要时用 gh 拉取 GitHub 上的 runbook 内容。

使用方式:必须使用 gcx 命令,不直接调用 Grafana API(不用 curl 或 HTTP 库)。时间范围统一用 --from/--to,不用 --start/--end。给代理处理用 -o json,给用户展示用默认格式,时序数据展示图表。错误统一在最后处理,不穿插在工作流步骤中。典型步骤:gcx slo definitions get <UUID> -o json 取定义;gcx slo definitions status <UUID> -o wide 看状态,OK 则报告后停止,NODATA 则排查数据源;gcx slo definitions timeline <UUID> --from now-1h --to now 渲染时间线;用 gcx metrics query -d <datasource-uid> 做维度拆解;用 gcx alert rules list -o json 配合 jq 搜索相关规则;从 fastBurn/slowBurn 注解与 metadata.annotations 收集 runbook、dashboard 链接。

适用场景:某个具体 SLO 正在违规、需要快速定位坏维度与关联告警时。

限制:依赖 gcx 与 Grafana 环境;NODATA 可能因数据源配置、录制规则尚未评估或远程写入问题导致;远程写入栈没有抓取目标,up 序列缺失不代表异常;datasources list --type prometheus 可能因已知问题返回空列表,需去掉 --type 重试;ratio 查询若无 groupByLabels 需尝试常见维度;gh 未认证时只报告 URL。具体收费、价格与平台支持情况暂未提供。