菜单
Grafana Cloud Enterprise 开源 RSS

变量

以下主题介绍如何在仪表板中添加和管理变量

变量是值的占位符。您可以在指标查询和面板标题中使用变量。因此,当您使用仪表板顶部的下拉列表更改值时,您的面板的指标查询将更改以反映新值。

变量允许您创建更具交互性和动态性的仪表板。您可以使用变量来代替在指标查询中硬编码服务器、应用程序和传感器名称等内容。变量在仪表板顶部显示为下拉列表。这些下拉列表使您可以轻松更改仪表板中显示的数据。

Variable drop-down open and two values selected
Give it a try using Grafana Play
使用 Grafana Play 试用一下

通过 Grafana Play,您可以探索并了解其工作原理,从实际示例中学习以加速您的开发。此功能可以在模板化 - 全局变量和插值中看到。

对于希望允许 Grafana 查看者调整可视化效果,而无需授予他们完全编辑权限的管理员来说,变量非常有用。Grafana 查看者可以使用变量。

变量和模板还允许您单源仪表板。如果您有多个相同的数据源或服务器,您可以制作一个仪表板并使用变量来更改您正在查看的内容。这大大简化了维护和维护。

模板

模板是任何包含变量的查询。

例如,如果您要管理一个仪表板来监控多台服务器,则可以为每台服务器制作一个仪表板。或者,您可以创建一个仪表板并使用带有模板查询的面板,例如这个

wmi_system_threads{instance=~"$server"}

变量值始终使用语法 var-<varname>=value 同步到 URL。

其他示例

变量在屏幕顶部的下拉列表中列出。选择不同的变量以查看可视化效果如何变化。

要查看变量设置,请导航到仪表板设置 > 变量。单击列表中的变量以查看其设置。

变量可用于标题、描述、文本面板和查询。以 $ 开头的文本查询是模板。并非所有面板都有模板查询。

Grafana Play 中的以下仪表板提供了模板变量的示例

变量最佳实践

  • 变量下拉列表按照它们在仪表板设置中的变量列表中列出的顺序显示。
  • 将您经常更改的变量放在顶部,以便它们首先显示(在仪表板的最左侧)。
  • 默认情况下,变量没有默认值。这意味着下拉列表中的最顶层值始终是预先选定的。如果您想使用空值预填充变量,您可以在变量设置中使用以下解决方法
    1. 选中包括全部选项复选框。
    2. 自定义全部值字段中,输入类似 + 的值。