Skip to main content

指标查询

在可观测性中,我们提供了基于内置监控模板与原生promql的监控指标查询器功能。

查询出图

  1. 点击左上角,选择可观测性
  2. 在可观测性栏目,选择查询器-指标查询器
  3. 填写你想查的参数,并执行查询:

参数名释义
集群查询哪个集群的指标(只有 管理员 才会选),此时无需指定要查询的环境/namespace
环境查询的目标项目、环境,会根据用户当前租户进行筛选
规则模板使用内置的监控查询模板查询(与查询语句互斥),模板来自Prometheus模板
查询语句使用原生的promql查询(与规则模板互斥),普通用户在查询时必须加上所选环境的namespace标签如{namespace="test"}
单位在使用promql查询时,你可以为你的查询结果指定单位,这样我们的图表就能根据它做单位自适应,详见单位表
Topk指promtheus的topk函数, 展示数组最大的k组指标,避免数据过多影响界面查看,默认20
Step时序图的时间间隔,用以控制返回的样本密度,默认auto,也就是按查询的时间范围自适应
起止时间时序图的时间范围,默认最近30分钟
小知识

Topk、Step、起止时间 作用于当前界面的所有查询面板。

  1. 在查询出图后,若你使用的是查询模板,你可以再对结果做标签筛选,筛选出你关心的指标

  1. 点击添加查询,支持同时查询多个指标并出图
小技巧

每个面板右上角有 设置告警 按钮,点击可以通过当前面板的参数快捷创建告警规则,详见 告警规则 相关文档

Prometheus模板

Kubegems配置Prometheus的查询模板,用以简便、优雅地进行指标查询及告警规则配置

  1. 可以选择创建、编辑、删除模板,模板构成如下:

模板释义:

模板构成释义
类型模板所属模块,按是否有namespace属性区分
名称模板名
规则与模板名对应,中文释义,查询和告警时会展示
expr对应的promql表达式,查询prometheus时会执行改查询语句
单位该条规则支持的单位key, 具体参见 单位表
标签promql支持筛选的标签,配置后可以在查询、告警时进行标签筛选
提示

在编辑、删除模板时,要注意检查模板有没有被告警规则引用,当然,被引用了的模板是无法删除的

单位表

目前支持的单位如下:

单位名单位释义
short默认(按1000做进制)
bytes-B字节/B
bytes-KB字节/KB
bytes-MB字节/MB
bytes-GB字节/GB
bytes-TB字节/TB
bytes-PB字节/TB
bytes/sec-B/s字节速率/B/s
bytes/sec-KB/s字节速率/KB/s
bytes/sec-MB/s字节速率/MB/s
bytes/sec-GB/s字节速率/GB/s
bytes/sec-TB/s字节速率/TB/s
bytes/sec-PB/s字节速率/PB/s
duration-ns时间/ns
duration-us时间/us
duration-ms时间/ms
duration-s时间/s
duration-m时间/m
duration-h时间/h
duration-d时间/d
duration-w时间/w
percent-0.0-1.0百分比/0.0-1.0
percent-0-100百分比/0-100
custom自定义