1 背景
我们在查询Prometheus的时候,通常有两种方式,一种是查瞬时的Metric采样数据,一种是查一段时间范围内的Metric采样数据。
如果对这两种查询方式理解不到位,结果往往是对PromQL的一些内置函数的使用是错误的,或者查询的结果并不是自己预期的那样。
那都是查Metric采样数据,查询瞬时和查询一段时间范围内这两种方式有什么区别呢?
2 图解Metric和采样
在上一篇文章Prometheus源码分析:基于Go Client自定义的Exporter,是如何在Local存储Metrics的?中,我们介绍了Exporter是如何在Local存储Metric的。
本质是将Metric放在本地的Map中,然后等待Prometheus服务端来周期性地Pull。
3 从Prometheus服务端的视角来看Metric采样
Prometheus会周期性的对Exporter的target进行PULL。
例如:在时间T1,Prometheus访问target,采样到的Metric信息是:Metric01=Vt1
例如:在时间T2,Prometheus访问target,采样到的Metric信息是:Metric01=Vt2 Metric02=Vt2
上述示例说明,Metric01在T1时刻的值是Vt1,在T2时刻的值是Vt2。
4 何为瞬时向量Instant Vector?
例如在上图中,我们查询最新的Metric信息,则会返回T3时刻的采样数据(假设T3时刻是距离服务器当前时间最近的采样时刻),包括Metric01=Vt3 Metric02=Vt3
这里的瞬时向量就是:Metric01=Vt3 Metric02=Vt3
官方示例:
代码语言:javascript复制http_requests_total{job="prometheus"}
表示返回距离服务器当前时间最近的采样点的Metric信息。
5 何为区间向量Range Vector?
例如上图中,我们查询[startTime,endTime]之间的Metric信息,假设这个时间段包含三个采样时刻(T1,T2,T3)。
则查询返回的结果包括:
- Metric01=Vt1
- Metric01=Vt2 Metric02=Vt2
- Metric01=Vt3 Metric02=Vt3
这里的区间向量就是:包括上述5个metric信息。
官方示例:
代码语言:javascript复制http_requests_total{job="prometheus"}[5m]
表示返回最近5分钟内的Metric信息。
5 PromQL处理瞬时向量和区间向量上的区别
5.1 PromQL聚合操作
例如:sum,min,max,count等聚合函数,只能作用于瞬时向量上。
代码语言:javascript复制// 这是错误的,因为count只能作用于瞬时向量,而这个查询本身返回的是区间向量
count(http_requests_total{job="prometheus"}[5m])
5.2 PromQL内置函数
5.2.1 ceil()向上取整,瞬时向量
ceil(v instant-vector)
将 v 中所有元素的样本值向上四舍五入到最接近的整数。
node_load5{instance="192.168.1.75:9100"} # 结果为 2.79
ceil(node_load5{instance="192.168.1.75:9100"}) # 结果为 3
5.2.2 changes()数据值变化的次数,区间向量
changes(v range-vector)
输入一个区间向量, 返回这个区间向量内每个样本数据值变化的次数(瞬时向量)。
# 如果样本数据值没有发生变化,则返回结果为 1
changes(node_load5{instance="192.168.1.75:9100"}[1m]) # 结果为 1
6 结语
深刻的理解瞬时向量和区间向量的含义,是使用好PromQL的关键,否则我们查询的结果很可能就不符合预期。