SuperAPI AI 工具集

metrics-query

通用与其它

查看项目

更新于 10-15 20:28

技能介绍

用途:该技能用于调查生产问题、回答性能问题并探索指标数据,借助 cx metrics 命令完成指标发现、标签探索与 PromQL 查询构建。

主要能力与命令:所有指标操作使用 cx metrics,含四个子命令:cx metrics search --name <pattern> 按名称查找指标(通配或子串);cx metrics get-labels <metric> 列出指标的可用标签名;cx metrics query '<expr>' 执行即时 PromQL 查询(单时间点,支持 --time);cx metrics query-range '<expr>' 执行范围 PromQL 查询(支持 --start、--end、--step),输出可追加 --output json 或 --output agents。

使用方式:建议先搜索指标,再获取标签,最后构建并执行查询。时间参数支持相对写法(now、now-1h、now-30m、now-2d、now-1w)与 RFC3339/ISO 8601 绝对时间。构建查询时由简到繁,逐步加入标签过滤与聚合。无结果或报错时,检查指标名与标签名、放宽时间范围或缩短 rate 窗口,排除空标签值,单一查询最多重试 5 次。收集结果后进行跨指标关联、时序模式识别与跨层分析,并定期总结发现、已执行查询与后续计划。

适用场景:HTTP 错误率与总 RPS 对比、p95/p99 延迟、资源饱和度、可用性(up、重启次数、节点健康)等典型排查。

限制:标签值无法直接通过 CLI 查询,需依据查询结果或领域知识推断;未提供其他限制与收费信息。