变量

以下主题描述了如何在仪表板中添加和管理变量

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

变量允许您创建更多交互性和动态的仪表板。在度量查询中硬编码服务器、应用程序和传感器名称等，而不是使用变量，您可以用变量代替。变量显示为仪表板顶部的下拉列表。这些下拉列表使更改仪表板中显示的数据变得容易。

使用Grafana Play试试看

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

变量对于希望允许Grafana查看者调整可视化而无需提供完全编辑权限的管理员非常有用。Grafana查看者可以使用变量。

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

模板

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

例如，如果您正在管理一个仪表板来监控多个服务器，您可以为每个服务器创建一个仪表板。或者，您可以创建一个仪表板并使用如下模板查询的面板

wmi_system_threads{instance=~"$server"}

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

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

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

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

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

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