变量是数值的占位符,您可以在度量查询和面板标题中使用变量。因此,当你使用仪表板顶部的下拉菜单更改值时,面板的度量查询也会随之更改,以反映新值。
使用变量可以创建更具交互性和动态性的仪表盘。您可以使用变量来代替在度量查询中硬编码服务器、应用程序和传感器名称。变量在仪表盘顶部显示为下拉列表。通过这些下拉列表,可以轻松更改仪表盘中显示的数据。
如果管理员想让 Grafana 查看器快速调整可视化效果,但又不想给他们完全的编辑权限,那么这些变量就特别有用,Grafana 查看器可以使用变量。
使用变量和模板还可以制作单一来源的仪表板。如果您有多个相同的数据源或服务器,您可以制作一个仪表盘,并使用变量来更改您正在查看的内容,这将大大简化了维护工作。
模板是任何包含变量的查询。
例如,如果要管理一个仪表板来监控多个服务器,可以为每个服务器创建一个仪表板。或者,你也可以创建一个仪表板,并使用像这样带有模板查询的面板:
wmi_system_threads{instance=~"$server"}
变量值总是使用 var-<varname>=value 语法同步到 URL。
变量在屏幕顶部的下拉列表中列出,选择不同的变量可查看可视化效果的变化。
要查看变量设置,请导航至 Dashboard Settings > Variables,单击列表中的变量查看其设置。
变量可用于标题、描述、文本面板和查询,注意,以 $ 开头的文本查询是模板,并非所有面板都有模板查询。
Grafana Play 中的以下仪表盘提供了模板变量的示例:
Graphite Templated Nested - 使用查询变量、链式查询变量、区间变量和重复面板。
Elasticsearch Dummy Flight Data - 使用临时过滤器。
Templating, repeated panels - 两组重复面板使用查询变量。
Template Redux - 使用查询变量、链式查询变量、区间变量、文本框变量、自定义变量和数据源变量。
变量下拉列表的显示顺序与仪表盘设置中变量列表的显示顺序一致。
将经常更改的变量放在顶部,这样它们就会首先显示。
默认情况下,变量没有默认值。这意味着下拉菜单中最上面的值总是被预选。如果想用空值预填充变量,可以在变量设置中使用以下变通方法:
a. 选择包含所有选项复选框。
b. 在自定义所有值字段中,输入类似 + 的值。