SuperAPI AI 工具集

metricsql

数据与分析

查看项目

更新于 10-16 06:16

技能介绍

用途:MetricsQL 是 VictoriaMetrics 使用的查询语言,语法上完全兼容 PromQL,任何合法 PromQL 均可解析,但并非语义超集,部分查询行为不同。本技能专门讲解 MetricsQL 相对 PromQL 的差异与扩展,PromQL 基础见姊妹技能 promql。

主要能力与差异:rate/increase/delta/changes 语义不同,前者用窗口前最后一个样本计算首个增量且不做外推;提供 _prometheus 变体实现字节级一致。标量与瞬时向量统一、NaN 处理不同、安全函数保留指标名。独有 rollup 家族(rollup_rate、rollup_increase、rollup_candlestick 等)、WITH 模板、选择器中的 or 与多常量匹配、default/if/ifnot 二元运算、group_left() 标签复制、keep_metric_names、[Ni] 步长、数值后缀、聚合 limit N、boundsLabel、分数时长、Graphite 语法等。查询 API 支持 extra_label、extra_filters[]、round_digits、limit 及 stats 响应。

使用方式:通过 vmselect(集群)或单节点进程暴露 /api/v1/query 与 /api/v1/query_range。集群 URL 形如 http://<vmselect>:8481/select/<accountID>/prometheus/api/v1/query。省略回滚窗口时 default_rollup 与 rate 取 max(step, scrape_interval),其他回滚取 step;告警与记录规则应显式指定窗口。隐式转换会在求值前把裸选择器包成 default_rollup,把非选择器上的回滚变成子查询,可用 -search.disableImplicitConversion 关闭,-search.logImplicitConversion 查看重写。

适用场景与限制:适用于 VictoriaMetrics 查询编写、Prometheus 迁移审计、Grafana 面板与告警规则审查。限制:并非语义超集,跨后端字节一致需用 *_prometheus 变体;limit N 顺序任意,与 topk 不同。各参考文档路径以 ${CLAUDE_SKILL_DIR} 开头,具体收费、价格与平台信息暂未提供。