SuperAPI AI 工具集

cx-metrics-query

通用与其它

查看项目

更新于 10-15 20:28

技能介绍

用途:借助 cx metrics CLI 命令排查生产问题、回答性能问题并探索指标数据,工作流覆盖指标发现、标签探索与 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)。任意命令追加 -o json 或 -o agents 可获得机器可读输出。

使用方式:先搜索相关指标,例如 cx metrics search --name 'cpu';再用 cx metrics get-labels <metric_name> 发现标签,据此构建精确的 PromQL 过滤条件;然后选择查询类型,瞬时查询用于当前状态或窗口内聚合,范围查询用于跨时间段比较,并让 --step 与时间函数中的 [window] 对齐。时间参数支持相对写法(now、now-1h、now-30m、now-2d、now-1w)与绝对写法(RFC3339/ISO 8601,如 2024-01-01T00:00:00Z)。查询无结果或报错时,可扩大指标名搜索、核对标签名、放宽时间范围或缩短 rate 窗口,对可能为空的标签使用 {label!=""} 排除空值,每个查询最多重试 5 次。

适用场景:HTTP 错误排查、性能与延迟分析(如 histogram_quantile 计算 p95/p99)、可用性检查(如 up 指标、Pod 重启数、节点健康)等。

限制:标签值无法直接通过 CLI 查询,需从查询结果或领域知识推断;PromQL 结果可能很大,需频繁总结;资料未提供安装方式、认证配置、收费与平台支持等信息。