跳到主要内容

即时查询

对任意已注册数据源即席写 PromQL,用的是和规则相同的查询编辑器。

这页办完你会得到:在任意一个已注册的 Prometheus 类数据源上跑通一条 PromQL, 分得清「表格」和「图表」看的不是同一份数据,并知道怎么把这条查询带去告警规则或仪表盘。

1. 选数据源,跑第一条查询​

数据查询 → 指标(/metric/explorer),默认落在 即时查询 这个 tab 上。

即时查询即时查询

顶上那一行:

控件干什么
筛选视图把一组常用的查询条件存下来,下次直接选
数据源只列 Prometheus 类型的数据源。全新安装只有一个 embedded-tsdb
启用自动补全打开后输入框会补全指标名和标签;指标基数特别大时可以关掉

在输入框里写 PromQL,点 查询:

up

预期结果:表格 (Table) 里列出一行行序列和它们的瞬时值,左上角的「序列 (N)」是条数。 一条都没有,先看数据源连上了但查不到数据。

2. 表格和图表看的不是同一份数据​

这是这个页面最容易误解的地方:

tab查的是什么什么时候用
表格 (Table)某一时刻的瞬时查询结果,是原始上报值核对指标到底有没有上报、值和时间对不对
图表 (Graph)一段时间范围的区间查询结果,按步长重新采样看趋势

表格这一侧还有三个控件:时间(留空是「现在」,填一个时刻就查那一刻)、 单位(只影响显示,比如 SI short)、导出(CSV)(把当前这批序列和值导出来)。

图表这一侧是时间范围选择器加两个参数:最大数据点数 和 最小步长 (Min step)。 步长和采集频率对不上时,图上的点是重采样出来的,和表格里的原始值对不上是正常的, 不是 bug。图下面还会给出耗时、查询步长、结果序列数三个数字,查询慢的时候先看这里。

3. 不会写 PromQL 也能查​

输入框旁边有三个入口:

  • 内置指标(输入框左侧):按组件类型和分类挑指标名,选完直接填进输入框。 这个目录怎么维护见内置指标视图;
  • 放大镜(输入框右侧):按名字搜指标,看它有哪些标签、标签有哪些取值;
  • 历史记录:你在这个数据源上跑过的 PromQL,最多留 100 条,点一条填回输入框。 它存在你自己的浏览器里,换台机器就没有了。

4. 同屏比几条查询​

页面最下面的 添加面板 会在下方再叠一个完整的查询面板,各自选数据源、各自写 PromQL, 适合把两个数据源的同一个指标摆在一起看。面板多于一个时,每个右上角会出现关闭图标。

它不是「添加到仪表盘」。 加出来的面板只活在这个页面上,刷新就没了。要留下来得去 创建仪表盘。

把这条查询带走​

跑通之后,同一段 PromQL 有四个去处:

  • 变成告警规则:告警通知 → 规则管理 → 新增,数据源和 PromQL 原样粘过去, 再把阈值写进表达式。见指标告警规则;
  • 变成面板:仪表盘里新建图表用的是同一套查询编辑器,见创建仪表盘;
  • 变成新指标:查询太重就预算成记录规则,见记录规则;
  • 发给别人看一眼:切到 图表 (Graph),右上角的分享图标会把当前这条查询存成一张 临时图,给你一条 /chart/<id> 链接,对方不用登录就能打开。这条链接不会过期, 也没有注销入口,别拿它当受控的对外分享,见匿名限时分享。

下一步​