博客 Prometheus PromQL语法

Prometheus PromQL语法

沸羊羊发表于 2024-07-16 14:40 330 0

一、PromQL语法

1.1、数据类型

PromQL 表达式计算出来的值有以下几种类型：

瞬时向量 (Instant vector)
区间向量 (Range vector)
标量数据 (Scalar)
字符串 (String)

1.2、瞬时向量选择器

瞬时向量选择器用来选择一组时序在某个采样点的采样值。最简单的情况就是指定一个度量指标，选择出所有属于该度量指标的时序的当前采样值。比如下面的表达式：

Bash

apiserver_request_total

可以通过在后面添加用大括号包围起来的一组标签键值对来对时序进行过滤。比如下面的表达式筛选出了 job 为 kubernetes-apiservers，并且 resource为 pod的时序：

Bash

apiserver_request_total{job="kubernetes-apiserver",resource="pods"}

匹配标签值时可以是等于，也可以使用正则表达式。总共有下面几种匹配操作符：

Bash

=：  完全相等

!=： 不相等

=~： 正则表达式匹配

!~： 正则表达式不匹配

下面的表达式筛选出了container是kube-scheduler或kube-proxy或kube-apiserver的时序数据

Bash

container_processes{container=~"kube-scheduler|kube-proxy|kube-apiserver"}

1.3、区间向量选择器

区间向量选择器类似于瞬时向量选择器，不同的是它选择的是过去一段时间的采样值。可以通过在瞬时向量选择器后面添加包含在 [] 里的时长来得到区间向量选择器。比如下面的表达式选出了所有度量指标为apiserver_request_total且resource是pod的时序在过去1 分钟的采样值。

这个不支持Graph，需要选择Console，才会看到采集的数据

Bash

apiserver_request_total{job="kubernetes-apiserver",resource="pods"}[1m]

说明：时长的单位可以是下面几种之一：

Bash

s：seconds

m：minutes

h：hours

d：days

w：weeks

y：years

1.4、偏移向量选择器

前面介绍的选择器默认都是以当前时间为基准时间，偏移修饰器用来调整基准时间，使其往前偏移一段时间。偏移修饰器紧跟在选择器后面，使用 offset 来指定要偏移的量。比如下面的表达式选择度量名称为apiserver_request_total的所有时序在 5 分钟前的采样值。

Bash

apiserver_request_total{job="kubernetes-apiserver",resource="pods"} offset 5m

下面的表达式选择apiserver_request_total 度量指标在 1 周前的这个时间点过去 5 分钟的采样值。

Bash

apiserver_request_total{job="kubernetes-apiserver",resource="pods"} [5m] offset 1w

1.5、聚合操作符

PromQL 的聚合操作符用来将向量里的元素聚合得更少。总共有下面这些聚合操作符

Bash

sum：求和

min：最小值

max：最大值

avg：平均值

stddev：标准差

stdvar：方差

count：元素个数

count_values：等于某值的元素个数

bottomk：最小的 k 个元素

topk：最大的 k 个元素

quantile：分位数

1）计算k8s-master1节点所有容器总计内存：

Bash

sum(container_memory_usage_bytes{instance=~"k8s-master1"})/1024/1024/1024

2）计算k8s-master1节点最近1m所有容器cpu使用率

Bash

sum (rate (container_cpu_usage_seconds_total{instance=~"k8s-master1"}[1m])) / sum (machine_cpu_cores{ instance =~"k8s-master1"}) * 10

1.6、函数

Prometheus 内置了一些函数来辅助计算，下面介绍一些典型的。

Bash

abs()：绝对值

sqrt()：平方根

exp()：指数计算

ln()：自然对数

ceil()：向上取整

floor()：向下取整

round()：四舍五入取整

delta()：计算区间向量里每一个时序第一个和最后一个的差值

《行业指标体系白皮书》下载地址：https://www.dtstack.com/resources/1057/?src=bbs 《数据治理行业实践白皮书》下载地址：https://www.dtstack.com/resources/1001/?src=bbs 《数栈V6.0产品白皮书》下载地址：https://www.dtstack.com/resources/1004/?src=bbs 想了解或咨询更多有关袋鼠云大数据产品、行业解决方案、客户案例的朋友，浏览袋鼠云官网：https://www.dtstack.com/?src=bbs 同时，欢迎对大数据开源项目有兴趣的同学加入「袋鼠云开源框架钉钉技术群」，交流最新开源技术信息，群号码：30537511，项目地址：https://github.com/DTStack

指标体系指标体系建设实战离线开发环境搭建离线软件开发套件（SDK）离线应用程序构建大数据技术 k8s master1 PromQL语法 Prometheus

0条评论

上一篇：离线应用程序构建

下一篇：数字经济转型

我要提问

分享经验

社区公告

大数据领域最专业的产品&技术交流社区，专注于探讨与分享大数据领域有趣又火热的信息，专业又专注的数据人园地

最新活动更多

Prometheus PromQL语法

我要提问

分享经验

微信扫码获取数字化转型资料

钉钉扫码加入技术交流群