首页/云/可观测性速查/PromQL 基础:瞬时向量与范围向量
本包目录(282 条)
监控体系与方法40 条
Prometheus 与采集64 条
Grafana 与看板53 条日志平台52 条链路追踪23 条告警与响应50 条

PromQL 基础:瞬时向量与范围向量

PromQL 的查询对象是时间序列:瞬时向量取当前点,范围向量取一段窗口;区间选择器只能作为函数参数,不能直接出图。

可观测性速查云更新于 2026-10-12

两种向量的写法

两种向量的写法
http_requests_total                  # 瞬时向量:每序列的当前值
http_requests_total[5m]              # 范围向量:近 5 分钟的样本
http_requests_total{job="api"}      # 标签精确过滤
http_requests_total{code=~"5.."}    # 正则匹配
在图表查询框里直接写 http_requests_total[5m] 会报错:范围向量必须交给 rate、avg_over_time 之类的函数处理。

易错点

  • 命令行里探索时注意引号层级,大括号与感叹号可能被 shell 解释
  • 选择器写错得到的是空结果而非报错,先到 UI 或 /api/v1/series 验证序列是否存在

数据来源与参考

  • Prometheus 文档 · Querying basics
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌