本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 变量
<a name="v10-dash-variables"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
有关支持 Grafana 版本 12.x 的 Grafana 工作空间，请参阅。[在 Grafana 版本 12 中工作](using-grafana-v12.md)  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

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

您可以通过变量创建更具交互性和动态性的控制面板。您可以在指标查询中使用变量代替服务器、应用程序和传感器名称等硬编码。变量以下拉列表的形式显示在控制面板顶部。通过这些下拉列表，可以轻松更改控制面板中显示的数据。

对于希望 Grafana 查看器能够快速调整可视化效果，但又不想授予其完全编辑权限的管理员来说，这些功能尤其有用。Grafana 查看器可以使用变量。

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

**模板**

模板是任何包含变量的查询。例如，如果要管理一个控制面板来监控多个服务器，则可以为每个服务器创建一个控制面板，也可以创建一个控制面板并使用带有模板查询的面板，如下所示。

```
wmi_system_threads{instance=~"$server"}
```

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

**示例**

变量位于屏幕顶部的下拉列表中。选择不同的变量，查看可视化效果的变化。

要查看变量设置，请导航到**控制面板设置 > 变量**。单击列表中的变量以查看其设置。

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

**变量最佳实践**
+ 变量下拉列表按照**控制面板设置**的变量列表中列出的顺序显示。
+ 将经常更改的变量放在顶部，这样它们就会显示在最前面（控制面板的最左边）。
+ 默认情况下，变量会预先选择下拉列表中最上面的值。如果要选择空值，请更改变量设置，如下所示：

  1. 选中**包含全部选项**复选框。

  1. 在**自定义所有值**字段中，输入值 `+`。

**Topics**
+ [添加和管理变量](v10-dash-variable-add.md)
+ [检查变量](v10-dash-variable-add-inspect.md)
+ [变量语法](v10-dash-variable-syntax.md)