Prometheus学习系列（二十一）PromQL函数

一些函数有默认的参数，例如：year(v=vector(time()) instant-vector)。他的意思是有一个参数v是一个瞬时向量，若是没有提供，它将默认为表达式vector(time())的值。

1、abs()

abs(v instant-vector)返回输入向量，全部样本值都转换为其绝对值。

2、absent()

absent(v instant-vector)若是传递给它的向量具备任何元素，则返回空向量;若是传递给它的向量没有元素，则返回值为1的1元素向量。

这对于在给定度量标准名称和标签组合不存在时间序列时发出警报很是有用。

absent(nonexistent{job="myjob"})  
# => {job="myjob"}
absent(nonexistent{job="myjob", instance=~".*"}) 
# => {job="myjob"}
absent(sum(nonexistent{job="myjob"})) 
# => {}
复制代码

在第二个例子中，absent()试图从输入向量中导出1元素输出向量的标签。

3、ceil()

ceil(v instant-vector) 将v中全部元素的样本值舍入到最接近的整数。

4、changes()

对于每一个输入时间系列，changes(v range-vector) 将返回其值在所提供的时间范围内更改的次数做为即时向量。

5、clamp_max()

clamp_max(v instant-vector, max scalar)钳制v中全部元素的样本值，使其上限为max。

6、clamp_min()

clamp_min(v instant-vector, min scalar)钳制v中全部元素的样本值，使其下限为min。

7、day_of_month()

day_of_month(v=vector(time()) instant-vector)返回UTC中每一个给定时间的月中的某天。 返回值为1到31。

8、day_of_week()

day_of_week(v=vector(time()) instant-vector)返回UTC中每一个给定时间的星期几。 返回值为0到6，其中0表示星期日等。

9、days_in_month()

days_in_month(v=vector(time()) instant-vector)返回UTC中每一个给定时间的月中天数。 返回值为28到31。

10、delta()

delta(v range-vector)计算范围向量v中每一个时间系列元素的第一个和最后一个值之间的差值，返回具备给定增量和等效标签的即时向量。 delta被外推以覆盖范围向量选择器中指定的全时间范围，所以即便样本值都是整数，也能够得到非整数结果。

如下示例表达式返回如今和2小时以前CPU温度的差别：

delta(cpu_temp_celsius{host="zeus"}[2h])
复制代码

delta应仅用于仪表。

11、deriv()

deriv(v range-vector)函数，计算一个范围向量v中各个时间序列二阶导数，使用简单线性回归 deriv应仅用于仪表。

12、exp()

exp(v instant-vector)计算v中全部元素的指数函数。特殊状况是：

• Exp(+inf) = +Inf
• Exp(NaN) = NaN

十3、floor()

floor(v instant-vector)将v中全部元素的样本值舍入为最接近的整数。。

十4、histogram_quantile()

histogram_quatile(φ float, b instant-vector) 计算b向量的φ-直方图 (0 ≤ φ ≤ 1) 。（有关φ-分位数的详细解释和直方图度量类型的使用，请参见直方图和摘要。）b中的样本是每一个桶中的观察计数。 每一个样本必须具备标签le，其中标签值表示桶的包含上限。 （没有这种标签的样本会被忽略。）直方图度量标准类型自动提供带有_bucket后缀和相应标签的时间序列。

使用rate()函数指定分位数计算的时间窗口。

示例：直方图度量标准称为http_request_duration_seconds。 要计算过去10m内请求持续时间的第90个百分位数，请使用如下表达式：

histogram_quantile(0.9, rate(http_request_duration_seconds_bucket[10m]))
复制代码

在http_request_duration_seconds中为每一个标签组合计算分位数。 要聚合，请在rate()函数周围使用sum()聚合器。 因为histogram_quantile()须要le标签，所以必须将其包含在by子句中。 如下表达式按做业聚合第90个百分点：

histogram_quantile(0.9, sum(rate(http_request_duration_seconds_bucket[10m])) by (job, le))
复制代码

要聚合全部内容，请仅指定le标签：

histogram_quantile(0.9, sum(rate(http_request_duration_seconds_bucket[10m])) by (le))
复制代码

histogram_quantile()函数经过假设桶内的线性分布来插值分位数值。 最高桶必须具备+Inf的上限。 （不然，返回NaN。）若是分位数位于最高桶中，则返回第二个最高桶的上限。 若是该桶的上限大于0，则假设最低桶的下限为0.在这种状况下，在该桶内应用一般的线性插值。 不然，对于位于最低桶中的分位数，返回最低桶的上限。

若是b包含少于两个桶，则返回NaN。 对于φ<0，返回-Inf。 对于φ> 1，返回+Inf。

十5、holt_winters()

holt_winters(v range-vector, sf scalar, tf scalar)根据v中的范围产生时间序列的平滑值。平滑因子sf越低，对旧数据的重要性越高。 趋势因子tf越高，则考虑的数据趋势越多。 sf和tf都必须介于0和1之间。

holt_winters只能用于仪表。

十6、hour()

hour(v=vector(time()) instant-vector)返回UTC中每一个给定时间的一天中的小时。 返回值为0到23。

十7、idelta()

idelta(v range-vector)计算范围向量v中最后两个样本之间的差别，返回具备给定增量和等效标签的即时向量。

idelta只能用于仪表。

十8、increase()

increase(v range-vector)计算范围向量中时间序列的增长。 单调性中断（例如因为目标重启而致使的计数器重置）会自动调整。 增长外推以覆盖范围向量选择器中指定的全时间范围，所以即便计数器仅以整数增量增长，也能够得到非整数结果。

如下示例表达式返回范围向量中每一个时间系列在过去5分钟内测量的HTTP请求数：

increase(http_requests_total{job="api-server"}[5m])

increase只应与counters一块儿使用。 它是rate(v)的语法糖乘以指定时间范围窗口下的秒数，应该主要用于人类可读性。 在记录规则中使用rate，以便每秒一致地跟踪增量。

十9、irate

irate(v range-vector)计算范围向量中时间序列的每秒即时增加率。 这基于最后两个数据点。 单调性中断（例如因为目标重启而致使的计数器重置）会自动调整。

如下示例表达式返回范围向量中每一个时间序列的两个最新数据点的最多5分钟的HTTP请求的每秒速率：

irate(http_requests_total{job="api-server"}[5m])

只应在绘制易失性快速移动计数器时使用irate。 警报和缓慢移动计数器的使用率，由于速率的简短更改能够重置FOR子句，而且难以阅读彻底由稀有峰值组成的图形。

注意，当将irate()与聚合运算符（例如sum()）或随时间聚合的函数（任何以_over_time结尾的函数）组合时，请始终首先采用irate()，而后进行聚合。 不然，当目标从新启动时，irate()没法检测计数器重置。

二10、label_join()

对于v中的每一个时间序列，label_join(v instant-vector, dst_label string, separator string, src_label_1 string, src_label_2 string, ...)使用separator链接全部src_labels的全部值，并返回包含链接的标签dst_label的时间序列 值。 此函数中能够有任意数量的src_labels。

此示例将返回一个向量，每一个时间序列都有一个foo标签，其中添加了值a,b,c：

label_join(up{job="api-server",src1="a",src2="b",src3="c"}, "foo", ",", "src1", "src2", "src3")

二11、label_replace()

对于v中的每一个时间序列，label_replace(v instant-vector, dst_label string, replacement string, src_label string, regex string) 将正则表达式正则表达式与标签src_label相匹配。 若是匹配，则返回时间序列，标签dst_label替换为替换扩展。 $1替换为第一个匹配的子组，$2替换为第二个等。若是正则表达式不匹配，则返回时间序列不变。

此示例将返回一个向量，每一个时间序列都有一个foo标签，其值为a：

label_replace(up{job="api-server",service="a:c"}, "foo", "$1", "service", "(.):.")

二12、ln()

ln(v instance-vector)计算v中全部元素的天然对数。特殊状况是：

ln(+Inf) = +Inf ln(0) = -Inf ln(x<0) = NaN ln(NaN) = NaN

二十3、log2()

log2(v instant-vector)计算v中全部元素的二进制对数。特殊状况等同于ln中的特殊状况。

二十4、log10()

log10(v instant-vector)计算v中全部元素的10进制对数。特殊状况等同于ln中的特殊状况。

二十5、minute()

minute(v=vector(time()) instant-vector)以UTC为单位返回每一个给定时间的分钟。 返回值为0到59。

二十6、month()

month(v=vector(time()) instant-vector)返回UTC中每一个给定时间的一年中的月份。 返回值为1到12，其中1表示1月等。

二十7、predict_linear()

predict_linear(v range-vector, t scalar)根据范围向量v使用线性回归预测从如今起t秒的时间序列值。

predict_linear只应与仪表一块儿使用。

二十8、rate()

rate(v range-vector)计算范围向量中时间序列的每秒平均增加率。 单调性中断（例如因为目标重启而致使的计数器重置）会自动调整。 此外，计算推断到时间范围的末端，容许错过刮擦或刮擦循环与范围的时间段的不完美对齐。

如下示例表达式返回范围向量中每一个时间系列在过去5分钟内测量的每秒HTTP请求率：

rate(http_requests_total{job="api-server"}[5m])

rate应仅用于计数器。 它最适用于警报和缓慢移动计数器的图形。

注意，当将rate()与聚合运算符（例如sum()）或随时间聚合的函数（任何以_over_time结尾的函数）组合时，始终首先采用rate()，而后聚合。 不然，当目标从新启动时，rate()没法检测计数器重置。

二十9、resets()

对于每一个时序数据，resets()在所提供的时间范围内返回计数器重置次数做为即时向量。 两个连续样本之间的值的任何减小都被解释为计数器重置。

resets()只应与计数器一块儿使用。

三10、round()

round(v instant-vector, to_nearest 1= scalar)将v中全部元素的样本值舍入为最接近的整数。 经过四舍五入解决关系。 可选的to_nearest参数容许指定样本值应舍入的最近倍数。 这个倍数也多是一个分数。

三11、scalar()

给定单元素输入向量，scalar(v instant-vector)将该单个元素的样本值做为标量返回。 若是输入向量不具备刚好一个元素，则scalar将返回NaN。

三12、sort()

sort(v instant-vector)返回按其样本值排序的向量元素，按升序排列。

三十3、sort_desc()

sort(v instant-vector和sort相同，但按降序排序。

三十4、sqrt()

sqrt(v instant-vector)计算v中全部元素的平方根。

三十5、time()

time()返回自1970年1月1日UTC以来的秒数。 请注意，这实际上并不返回当前时间，而是返回计算表达式的时间。

三十6、timestamp()

timestamp(v instant-vector)返回给定向量的每一个样本的时间戳，做为自1970年1月1日UTC以来的秒数。

此功能已添加到Prometheus 2.0中

三十7、vector()

vector(s scalar)将标量s做为没有标签的向量返回。

三十8、year()

year(v=vector(time()) instant-vector)以UTC格式返回每一个给定时间的年份。

三十9、_over_time()

如下函数容许聚合给定范围向量的每一个系列随时间的变化并返回具备每系列聚合结果的即时向量：

• avg_over_time(range-vector): 范围向量内每一个度量指标的平均值。
• min_over_time(range-vector): 范围向量内每一个度量指标的最小值。
• max_over_time(range-vector): 范围向量内每一个度量指标的最大值。
• sum_over_time(range-vector): 范围向量内每一个度量指标的求和值。
• count_over_time(range-vector): 范围向量内每一个度量指标的样本数据个数。
• quantile_over_time(scalar, range-vector): 范围向量内每一个度量指标的样本数据值分位数，φ-quantile (0 ≤ φ ≤ 1)
• stddev_over_time(range-vector): 范围向量内每一个度量指标的整体标准误差。
• `stdvar_over_time(range-vector): 范围向量内每一个度量指标的整体标准方差。

请注意，即便值在整个时间间隔内的间隔不均匀，指定时间间隔内的全部值在聚合中都具备相同的权重。

四10、连接

Prometheus官网地址：prometheus.io/ 个人Github：github.com/Alrights/pr…