跳转至

4 PromQL简单示例

1 简单的时间序列选择

返回度量指标 http_requests_total 的所有时间序列样本数据:

http_requests_total

返回度量指标名称为 http_requests_total

标签分别是 job="apiserver", handler="/api/comments" 的所有时间序列样本数据

http_requests_total{}
http_requests_total{job="apiserver", handler="/api/comments"}

返回度量指标名称为 http_requests_total

  • 标签分别是 job="apiserver", handler="/api/comments"
  • 且是 5 分钟内的所有时间序列样本数据:
http_requests_total{job="apiserver", handler="/api/comments"}[5m]
http_requests_total{label="value"}[time]

一个区间向量表达式不能直接展示在 Graph 图表中,但是可以展示在 Console 视图中。

使用正则表达式,你可以通过特定模式匹配标签为 job 的特定任务名,获取这些任务的时间序列。在下面这个例子中, 所有任务名称以 server 结尾。

http_requests_total{job=~".*server"}

Prometheus中的所有正则表达式都使用 RE2 语法

http_requests_total{status!~"4.."}

2 使用函数,操作符等

返回度量指标 http_requests_total 过去 5 分钟内的 http 请求数的平均增长速率

rate(http_requests_total[5m])

返回度量指标 http_requests_total 过去 5 分钟内的 http 请求数的平均增长速率总和,维度是 job

sum(rate(http_requests_total[5m])) by (job)
结果:
{job="apiserver"}  0.16666666666666666
{job="kubelet"}  0.49999876544124355

如果两个指标具有相同维度的标签,我们可以使用二元操作符计算样本数据,

返回值:key: value=标签列表:计算样本值

例如,以下表达式返回每一个实例的空闲内存,单位是 MiB

(instance_memory_limit_bytes - instance_memory_usage_bytes) / 1024 / 1024

如果想知道每个应用的剩余内存,可以使用如下表达式

sum(
  instance_memory_limit_bytes - instance_memory_usage_bytes
) by (app, proc) / 1024 / 1024

如果相同的集群调度群显示如下的每个实例的 CPU 使用率:

instance_cpu_time_ns{app="lion", proc="web", rev="34d0f99", env="prod", job="cluster-manager"}
instance_cpu_time_ns{app="elephant", proc="worker", rev="34d0f99", env="prod", job="cluster-manager"}
instance_cpu_time_ns{app="turtle", proc="api", rev="4d3a513", env="prod", job="cluster-manager"}
instance_cpu_time_ns{app="fox", proc="widget", rev="4d3a513", env="prod", job="cluster-manager"}
...

我们可以按照应用和进程类型来获取 CPU 利用率最高的 3 个样本数据

topk(3, sum(rate(instance_cpu_time_ns[5m])) by (app, proc))

假设一个服务实例只有一个时间序列数据,那么我们可以通过下面表达式统计出每个应用的实例数量

count(instance_cpu_time_ns) by (app)