可观测性与稳定性 / 系统课时

怎样查询一组时间序列

怎样查询一组时间序列

Prometheus 中一个指标往往对应很多时间序列,例如同一 CPU 指标会按服务器、CPU 核和运行模式拆分。真正实用的查询不是只记住指标名,而是用标签条件准确选出目标服务器或应用,同时避免一次取回无关数据。

学习目标

  • 使用指标名和标签匹配器选择目标时间序列
  • 区分精确、排除和正则标签条件的适用场景
  • 组合多个条件并检查查询是否选中了预期对象

从指标名开始选择

PromQL 最基本的时间序列选择器就是指标名。假设 Node Exporter 已采集 CPU 指标,下面的表达式会选择当前评估时刻所有名为 node_cpu_seconds_total 的时间序列:

text
node_cpu_seconds_total

预期结果

text
node_cpu_seconds_total{cpu="0",instance="web-01:9100",job="node",mode="idle"} <VALUE>
node_cpu_seconds_total{cpu="0",instance="web-01:9100",job="node",mode="user"} <VALUE>
node_cpu_seconds_total{cpu="1",instance="web-02:9100",job="node",mode="idle"} <VALUE>
...

实际标签集合和数值取决于当前监控目标,因此 <VALUE> 会随采集时间变化。指标名只限定了指标类型,并没有指定服务器、CPU 核或模式,所以通常还需要标签条件继续缩小范围。

用标签条件缩小结果

标签条件写在花括号中。最常见的四种匹配器是 =、!=、=~ 和 !~,分别表示精确匹配、不等于、正则匹配和正则排除。

例如,只查看 web-01:9100 上 CPU 0 的非空闲累计时间,可以写成:

text
node_cpu_seconds_total{instance="web-01:9100",cpu="0",mode!="idle"}

预期结果

text
node_cpu_seconds_total{cpu="0",instance="web-01:9100",job="node",mode="iowait"} <VALUE>
node_cpu_seconds_total{cpu="0",instance="web-01:9100",job="node",mode="system"} <VALUE>
node_cpu_seconds_total{cpu="0",instance="web-01:9100",job="node",mode="user"} <VALUE>
...

同一个选择器中的多个标签条件是同时满足的关系。这里既要求 instance 和 cpu 精确匹配,又要求 mode 不是 idle,因此不会把其他服务器或 CPU 核的数据混进来。

用正则一次选择多个目标

当服务器命名有规律时,不必为每台机器分别写查询。下面的表达式选择 web-01:9100 和 web-02:9100 两台服务器的空闲 CPU 时间:

text
node_cpu_seconds_total{instance=~"web-(01|02):9100",mode="idle"}

预期结果

text
node_cpu_seconds_total{cpu="0",instance="web-01:9100",job="node",mode="idle"} <VALUE>
node_cpu_seconds_total{cpu="1",instance="web-01:9100",job="node",mode="idle"} <VALUE>
node_cpu_seconds_total{cpu="0",instance="web-02:9100",job="node",mode="idle"} <VALUE>
...

Prometheus 的标签正则采用 RE2 语法,并按完整标签值进行匹配。生产查询应尽量利用稳定标签,例如 job、instance、cluster 或业务自定义标签,而不是依赖容易变化的临时名称。

先确认选中了哪些序列

复杂计算前,先单独执行时间序列选择器,检查返回标签是否符合预期,再继续添加 rate()、聚合或告警条件。这样能够把“选错数据”和“计算公式错误”分开定位。

还要避免过宽的选择器。只有标签条件而没有指标名时,PromQL 要求至少存在一个不能匹配空字符串的标签匹配器。例如 {job=~".+"} 可以限定存在非空 job 的序列,而 {job=~".*"} 不能作为唯一条件。实际监控中优先写出指标名,通常既更容易阅读,也能减少不必要的时间序列扫描。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

怎样查询一组时间序列

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通