变量

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

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

变量允许您创建更具交互性和动态性的仪表盘。与其在指标查询中硬编码服务器、应用程序和传感器名称等内容，不如使用变量代替它们。变量显示为仪表盘顶部的下拉列表。这些下拉列表使更改仪表盘中显示的数据变得容易。

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

变量对于希望允许 Grafana 查看者调整可视化而不授予其完整编辑权限的管理员很有用。Grafana 查看者可以使用变量。

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

模板

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

例如，如果您要管理用于监控多个服务器的仪表盘，您可以为每个服务器创建一个仪表盘。或者，您可以创建一个仪表盘，并在面板中使用像这样的模板查询

wmi_system_threads{instance=~"$server"}

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

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

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

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

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

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