Prometheus监控平台中PromQL内置函数详解
作者：互联网
PromQL就如同SQL中有一些内置函数，PromQL中也存在一些函数，我们可以在进行PromQL表达式进行使用，完成一些数据的处理，进而在Grafana等显示页面展示动态数据，下面我们分模块具体分析。
一、聚合函数
1、sum (求和)
2、min (最小值)
3、max (最大值)
4、avg (平均值)
5、stddev (标准差)
6、stdvar (标准差异)
7、count (样本数量计数)
8、count_values (对 value 进行计数)
9、bottomk (样本值最小的 k 个元素)
10、topk (样本值最大的k个元素)
11、quantile (分布统计)
二、其他常用内置函数
1、abs(instant-vector) 求瞬时向量绝对值
2、absent(v instant-vector) 传入一个瞬时非空向量则返回空向量，否则返回不带名称值为1的指标，用来监控空数据的情况
3、ceil(v instant-vector) 四舍五入取整
4、floor(v instant-vector) 函数与 ceil() 函数相反，舍弃小数部分取整
5、changes(v range-vector) 计算区间向量中每个样本值变化次数，返回的是瞬时向量
6、clamp_max(v instant-vector, max scalar) 瞬时向量值如果大于max 则值修改为max，否则值不变（用于将向量规范到一个不大于max的区间内）
7、clamp_min(v instant-vector, min scalar) 同理，将向量规范到一个不小于min值的范围内
8、day_of_month(v=vector(time()) instant-vector) 返回 1～31 向量所在UTC时间中的所在月份的第几天
9、day_of_week(v=vector(time()) instant-vector) 函数，返回被给定 UTC 时间所在周的第几天。返回值范围：0~6，0 表示星期天。
10、days_in_month(v=vector(time()) instant-vector) 函数，返回当月一共有多少天。返回值范围：28~31。
11、delta(v range-vector) 的参数是一个区间向量，返回一个瞬时向量。它计算一个区间向量 v 的第一个元素和最后一个元素之间的差值
12、delta(v range-vector) 的参数是一个区间向量，返回一个瞬时向量。它计算一个区间向量 v 的第一个元素和最后一个元素之间的差值。
由于这个值被外推到指定的整个时间范围，所以即使样本值都是整数，你仍然可能会得到一个非整数值。
例如，下面的例子返回过去两小时的 CPU 温度差：
delta(cpu_temp_celsius{host="zeus"}[2h])
该函数一般只用在 Gauge 类型的时间序列上。
13、idelta(v range-vector) 的参数是一个区间向量, 返回一个瞬时向量。它计算最新的 2 个样本值之间的差值。(当区间内仅有一个向量时无返回值)
14、deriv(v range-vector) 的参数是一个区间向量,返回一个瞬时向量。它使用简单的线性回归计算区间向量 v 中各个时间序列的导数。
15、exp(v instant-vector) 函数，输入一个瞬时向量，返回各个样本值的 e 的指数值，即 e 的 N 次方。当得到一个无穷大的值，显示 +Inf， 反之显示0, e的负数次方无限趋进0。e的空向量指数依然为空向量。
16、year(v=vector(time()) instant-vector) 函数返回被给定 UTC 时间的当前年份。
17、hour(v=vector(time()) instant-vector) 函数返回被给定 UTC 时间的当前第几个小时，时间范围：0~23。
18、minute(v=vector(time()) instant-vector) 函数返回给定 UTC 时间当前小时的第多少分钟。结果范围：0~59。
19、month(v=vector(time()) instant-vector) 函数返回给定 UTC 时间当前属于第几个月，结果范围：0~12。
20、increase(v range-vector) 函数获取区间向量中的第一个和最后一个样本并返回其增长量, 它会在单调性发生变化时(如由于采样目标重启引起的计数器复位)自动中断。
increase(v range-vector) 函数获取区间向量中的第一个和最后一个样本并返回其增长量，它会在单调性发生变化时(如由于采样目标重启引起的计数器复位)自动中断。
由于这个值被外推到指定的整个时间范围，所以即使样本值都是整数，你仍然可能会得到一个非整数值，如果除以一定时间就可以获取该时间内的平均增长率。
例如，以下表达式返回区间向量中每个时间序列过去 5 分钟内 HTTP 请求数的增长数：
increase(http_requests_total{job="apiserver"}[5m])
该函数配合counter数据类型使用，它的返回值类型只能是计数器类型。
21、rate(v range-vector) 函数用于计算区间向量平均增长率，采用区间向量第一个值和最后值进行计算
rate(v range-vector) 函数可以直接计算区间向量 v 在时间窗口内平均每秒增长速率，它会在单调性发生变化时(如由于采样目标重启引起的计数器复位)自动中断。
该函数配合counter数据类型使用，它的返回值类型只能用计数器，在长期趋势分析或者告警中推荐使用这个函数。该函数的返回结果不带有度量指标，只有标签列表。
例如，以下表达式返回区间向量中每个时间序列过去 5 分钟内 HTTP 请求数的每秒增长率：
rate(http_requests_total[5m])
结果：
{code="200",handler="label_values",instance="120.77.65.193:9090",job="prometheus",method="get"} 0
{code="200",handler="query_range",instance="120.77.65.193:9090",job="prometheus",method="get"} 0
{code="200",handler="prometheus",instance="120.77.65.193:9090",job="prometheus",method="get"} 0.2
...
[info] 注意
当将 rate() 函数与聚合运算符（例如 sum()）或随时间聚合的函数（任何以 _over_time 结尾的函数）一起使用时，必须先执行 rate 函数，然后再进行聚合操作，
否则当采样目标重新启动时 rate() 无法检测到计数器是否被重置。
# 统计平均时间
rate(http_server_requests_seconds_sum{uri="/recommend"}[1m])/rate(http_server_requests_seconds_count{uri="/recommend"}[1m])
22、irate(v range-vector) 函数用于计算区间向量的增长率，但是其反应出的是瞬时增长率。irate 函数是通过区间向量中最后两个两本数据来计算区间向量的增长速率，它会在单调性发生变化时(如由于采样目标重启引起的计数器复位)自动中断。这种方式可以避免在时间窗口范围内的“长尾问题”，并且体现出更好的灵敏度，通过irate函数绘制的图标能够更好的反应样本数据的瞬时变化状态。
irate(v range-vector) 函数用于计算区间向量的增长率，但是其反应出的是瞬时增长率。
irate 函数是通过区间向量中最后两个两本数据来计算区间向量的增长速率，它会在单调性发生变化时(如由于采样目标重启引起的计数器复位)自动中断。
这种方式可以避免在时间窗口范围内的“长尾问题”，并且体现出更好的灵敏度，通过irate函数绘制的图标能够更好的反应样本数据的瞬时变化状态。
例如，以下表达式返回区间向量中每个时间序列过去 5 分钟内最后两个样本数据的 HTTP 请求数的增长率：
irate(http_requests_total{job="api-server"}[5m])
irate 只能用于绘制快速变化的计数器，在长期趋势分析或者告警中更推荐使用 rate 函数。因为使用 irate 函数时，速率的简短变化会重置 FOR 语句，形成的图形有很多波峰，难以阅读。
[info] 注意
当将 irate() 函数与聚合运算符（例如 sum()）或随时间聚合的函数（任何以 _over_time 结尾的函数）一起使用时，必须先执行 irate 函数，然后再进行聚合操作，
否则当采样目标重新启动时 irate() 无法检测到计数器是否被重置。
# 统计访问 /recommend 的 qps
irate(http_server_requests_seconds_count{uri='/recommend'}[1m])
23、label_join(v instant-vector, dst_label string, separator string, src_label_1 string, src_label_2 string, ...) 函数可以将时间序列 v 中多个标签 src_label 的值，通过 separator 作为连接符写入到一个新的标签 dst_label 中。可以有多个 src_label 标签。
| 1 2 |
|
24、label_replace(v instant-vector, dst_label string, replacement string, src_label string, regex string) 在原标签中匹配字符，放到目标标签中
25、ln(v instant-vector) 计算瞬时向量 v 中所有样本数据的自然对数。
| 1 2 3 4 |
|
26、log2(v instant-vector) 函数计算瞬时向量 v 中所有样本数据的二进制对数。特殊情况同ln。
27、log10(v instant-vector) 计算瞬时向量 v 中所有样本数据的十进制对数。特殊情况同ln。
28、predict_linear(v range-vector, t scalar) 函数可以预测时间序列 v 在 t 秒后的值。它基于简单线性回归的方式，对时间窗口内的样本数据进行统计，从而可以对时间序列的变化趋势做出预测。
29、resets(v range-vector) 的参数是一个区间向量。对于每个时间序列，它都返回一个计数器重置的次数。两个连续样本之间单调性发生变化被认为是一次计数器重置。
30、round(v instant-vector, to_nearest=1 scalar) 函数与 ceil 和 floor 函数类似，返回向量中所有样本值的最接近to_nearest值整数倍的值，当to_nearest=1时等价于ceil。
31、scalar(v instant-vector) 函数返回一个单元素瞬时向量的样本值，当多元素或者没有元素返回Nan。
32、vector(s scalar) 函数将标量 s 作为没有标签的向量返回（和scalar作用刚好相反）。
33、sort(v instant-vector) 函数对向量按元素的值进行升序排序。
34、sort_desc(v instant-vector) 函数对向量按元素的值进行降序排序。
35、sqrt(v instant-vector) 函数计算向量 v 中所有元素的平方根。
36、timestamp(v instant-vector) 函数返回向量 v 中的每个样本的时间戳（从 1970-01-01 到现在的秒数）。
37、avg_over_time(range-vector) : 区间向量内每个度量指标的平均值。
38、min_over_time(range-vector) : 区间向量内每个度量指标的最小值。
39、max_over_time(range-vector) : 区间向量内每个度量指标的最大值。
40、sum_over_time(range-vector) : 区间向量内每个度量指标的求和。
41、count_over_time(range-vector) : 区间向量内每个度量指标的样本数据个数。
三、下面详细分析几个函数：
1、计算Counter指标增长率
我们知道Counter类型的监控指标其特点是只增不减，在没有发生重置（如服务器重启，应用重启）的情况下其样本值应该是不断增大的。为了能够更直观的表示样本数据的变化剧烈情况，需要计算样本的增长速率。
如下图所示，样本增长率反映出了样本变化的剧烈程度：
可以通过以下表达式计算Counter类型指标的增长率：
#下面两句话取出来的结果是一样的，只不过rate()是直接算出区间向量的平均速率，而increase()你要自己去除于秒数。 increase(node_cpu_seconds_total[2m]) / 120 rate(node_cpu_seconds_total[2m])
increase函数：这里通过node_cpu_seconds_total[2m]获取时间序列最近两分钟的所有样本，increase计算出最近两分钟的增长量，
最后除以时间120秒得到node_cpu_seconds_total样本在最近两分钟的平均每秒增长率。并且这个值也近似于主机节点最近两分钟内的平均CPU使用率。
rate()函数：该函数配合counter类型数据使用，取counter在这个时间段中的平均每秒增量。比方CPU在2分钟增长了200,那么结果就是200/120。
2、计算分位数：
## 计算TP95
histogram_quantile(0.95, http_server_requests_seconds_bucket{uri='/recommend'})
到此所有常用函数都介绍完了，还有一些少见的如直方图等请查阅prometheus官网文档。
标签：详解,函数,样本,range,PromQL,Prometheus,vector,instant,向量 来源： https://blog.csdn.net/nandao158/article/details/120486812