文章目录
PromQL简介
PromQL是prometheus自己开发的数据查询DSL语言，语言表现力非常丰富，支持条件查询、操作符、并且内建了大量内置函数，供我们针对监控数据的各种维度进行查询。
数据类型
PromQL 表达式计算出来的值有以下几种类型：
- 瞬时向量 (Instant vector)：一组时序，每个时序只有一个采样值
- 区间向量 (Range vector)：一组时序，每个时序包含一段时间内的多个采样值
- 标量数据 (Scalar)：一个浮点数
- 字符串 (String)：一个字符串
1、瞬时数据 (Instant vector)
定义：瞬时数据表示的是当前时刻的数据
示例：查询CPU的使用时间 (node_cpu_seconds_total)
2、区间数据 (Range vector)
定义：区间数据表示的是在某一个时间范围内的数据，可以分为以下几种：
➢ Time Durations
表示持续时间，计量单位包含毫秒(ms)、秒(s)、分钟(m)、小时(h)、天(d)、周(w)、年(y)等。
示例：查询CPU1分钟内的使用时间 (node_cpu_seconds_total[1m])
可以看到1分钟内，每个指标有4个值，采样周期是15s。
➢ Offest modifier
Offset modifier 表示偏移量修饰符，允许更改查询中单个瞬间和范围向量的时间偏移量。
示例：查询CPU使用时间在5分钟以前的数据 (node_cpu_seconds_total offset 5m)
➢ @modifier
@修饰符 后面加上一个Unix时间戳，可以查询改时间点的数据。
注意：这种用法需要在prometheus启动时添加参数 --enable-feature=promql-at-modifier ，并且以前老版本的prometheus可能不支持这种用法。
示例：查询2022.01.25 00:00:00这个时刻CPU的使用时间 (node_cpu_seconds_total@1643040000)
3、标量数据 (Scalar)
定义：标量数据没有时间属性，每个时间点数值一致。
示例：查询CPU使用时间，所有标签的个数 (count(node_cpu_seconds_total) )
4、字符串 (String)
定义：字符串在PromQL中用于表示文本数据。
示例：可以用单引号（‘’）、双引号（“”）或反引号（``）来指定。在PromQL中，字符串通常用于标签匹配或作为函数参数。
条件匹配
promQL支持各种条件匹配，条件匹配符有：= 、!= 、=~ 、!~
- =：选择与提供的字符完全相同的数据
- !=：选择不等于提供的字符串的数据
- =~：选择与提供的字符串进行正则表达式匹配的数据
- !~：选择与提供的字符串不匹配的数据
1、完全匹配
示例1：查询CPU第一个核的使用时间 (node_cpu_seconds_total{cpu=“0”})
示例2：查询CPU除第一个外其他核的使用时间 (node_cpu_seconds_total{cpu!=“0”} )
示例3：查询CPU第一个、第二个核的使用时间 (node_cpu_seconds_total{cpu=~“0|1”})
示例4：查询CPU除第一个、第二个外其他核的使用时间 (node_cpu_seconds_total{cpu!~“0|1”})
2、正则匹配
示例：查询CPU第一个核，且mode是i开头的使用时间 (node_cpu-seconds_total{cpu=“0”,mode=~“i.*”})
运算符
PromQL支持各种运算符，并对结果数据进行运算和过滤。
1、比较运算符
比较运算符有：== 、!= 、> 、< 、>= 、<=
比较运算符与数学中和其他语言的含义是一样的
示例：查询CPU使用时间等于0的标签 (node_cpu_seconds_total == 0)
示例：查询CPU使用时间不等于0的标签 (node_cpu_seconds_total != 0)
其他比较运算符的用法与上面类似，就不举例了。
2、算数运算符
算术运算符有：加+ 、减- 、乘* 、除/ 、取余% 、幂次方^等
示例：计算主机CPU使用时间和主机上面虚拟机使用时间的和 (node_cpu_seconds_total + node_cpu_guest_seconds_total)
其他算数运算符的用法与上面类似，就不举例了。
3、逻辑运算符
逻辑运算符有：和(and)、或(or)、非(unless)
示例：查询CPU的时间大于0且小于10的标签 (node_cpu_seconds_total > 0 and node_cpu_seconds_total < 10)
其他逻辑运算符的用法与上面类似，就不举例了。
4、聚合运算符
➢ 求和 (sum)
示例：计算CPU所有核的总使用时间 (sum(node_cpu_seconds_total))
➢ 计数 (count)
示例：计算CPU的核数 (count(node_cpu_seconds_total{mode=“system”}))
➢ 最大值 (max)
示例：查询CPU第一个核中使用时间最大值 (max(node_cpu_seconds_total{cpu=“0”}))
➢ 最小值 (min)
示例：查询CPU第一个核中使用时间最小值 (min(node_cpu_seconds_total{cpu=“0”}) )
➢ 求平均值 (avg)
示例：查询CPU所有核的平均使用时间 (avg(node_cpu_seconds_total))
➢ 取前x个值 (topk)
示例：查询CPU所有核中排名前两个的核 (topk(2,node_cpu_seconds_total))
➢ 取后x个值 (bottomk)
示例：查询CPU所有核中排名后两个的核 (bottomk(2,node_cpu_seconds_total))
5、匹配运算
➢ 关联标签 (on)
定义：将两个指标进行算数运算时，如果两个指标的标签不完全相同，可以匹配相同的标签进行计算。
示例：计算CPU每个核系统态和用户态的总使用时间 (node_cpu_seconds_total{mode=“system”} + on(instance,cpu) node_cpu_seconds_total{mode=“user”})
➢ 忽略标签 (ignoring)
定义：将两个指标进行算数运算时，如果两个指标的标签不完全相同，可以忽略不一样的标签进行计算忽略运行状态。
示例：计算CPU每个核系统态和用户态的总使用时间 (node_cpu_seconds_total{mode=“system”} + ignoring(mode) node_cpu_seconds_total{mode=“user”})
➢ 以某个标签进行计算 (by)
示例：计算每个CPU核的各个状态的总使用时间 (sum(node_cpu_seconds_total) by (cpu)))
➢ 舍弃某个标签后进行计算 (without)
示例：计算每个CPU核的各个状态的总使用时间 (sum(node_cpu_seconds_total) without (cpu))
