Grafana面板(panel)：从数据源请求数据

文章目录

概述
请求编辑器(query editor)
Query syntax
grafana UI界面上的Query tab

概述

query描述了Grafana的panel怎么和data source沟通，以便于获取数据来作图。query多久一次被发送给data source以及收集多少数据，这都可以在panel上的data source选项处调整。Grafana每个panel至多支持26个query。

请求编辑器(query editor)

请求编辑器即写请求的区域上选项卡，等其他元素。根据data source选择的不同而不同。

Query syntax

根据data source的不同而不同。添加data source时，就有Query Language的选择。参考 Grafana data source

grafana UI界面上的Query tab

Query tab(请求选项卡)由以下五部分组成。

data source selector

选择要作图的数据。具体就是选择上图Data source后面的选项框。参考 Add a data source。出了我们自己添加的和默认存在的数据源(data source),还有一些特殊的数据源：

Grafana:内置的数据源，是随机生产的。用来测试。

Mixed:此选项可以在同一个panel请求多个数据源。当data source处选择此选项时，则Query editor list处会多了数据源选择的选项卡。

Dashboard：选择此选项可以使用另一个panel的结果，但panel必须在同一个dashboard中。(类似panel复制)

Query options

点击上图Query options后面的右箭头，可以看到下图：灰色的是默认值，白色是自己设置的，删除白色的又会恢复为默认值，这些设置只对当前panel生效。

选项的说明如下：

Max data points:若选择的data source支持此项，则此项设置是每次请求返回的数据最大数目。若超过此数，data source会合并它们(用平均值或者最大值聚合它们来减少返回的数据量)

Min interval:为自动计算的间隔设置一个最小现在，通常是最小的数据抓取间隔。若一条记录(data point),若一条记录每15s保存一次，则不存在比15s这个间隔低的记录。

interval：这是一个时间范围，把记录按照时间分组/聚合时用到。grafana自动计算合适的interval，在模板中作为一个变量使用。这个变量是$__interval （以秒为单位）或则 $__interval_ms

Relative time:覆写顶部菜单的时间范围。就是覆写下图的Last 6 hours这个值。

此选是设置展示哪段时间范围内的指标(数据)。若设置了，则panel右上角会显示。

Time shift：另一个覆写时间范围的方式，只对相对时间范围有效。

实例：下表的第二列均可用在上述的Relative time和Time shift选项中。

Example	Relative time field
Last 5 minutes	`now-5m`
The day so far	`now/d`
Last 5 days	`now-5d/d`
This week so far	`now/w`
Last 2 years	`now-2y/y`

Time shift:

Example	Time shift field
Last entire week	`1w/w`
Two entire weeks ago	`2w/w`
Last entire month	`1M/M`
This entire year	`1d/y`
Last entire year	`1y/y`

Query inspector button

点击Query inspector可以看到panel发送的请求和响应情况。

Query editor list

每个请求以A,B,C…的方式区分。根据data source的不同，这会差别很大。下图中最后的图标只需将光标移动到它们上，即可看到每个tab的作用。

data source为influxdb的请求编辑器的设置

data source为influxdb时，关于"Select"的设置

Expression

参考 Expressions.