本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Variables
本文档主题专为支持 Grafana 10.x 版本的 Grafana 工作区而设计。
对于支持 Grafana 9.x 版本的 Grafana 工作区,请参阅 使用 Grafana 版本 9。
对于支持 Grafana 8.x 版本的 Grafana 工作区,请参阅 使用 Grafana 版本 8。
变量是值的占位符。您可以在指标查询和面板标题中使用变量。因此,当您使用控制面板顶部的下拉列表更改值时,面板的指标查询将发生变化以反映新值。
您可以通过变量创建更具交互性和动态性的控制面板。您可以在指标查询中使用变量代替服务器、应用程序和传感器名称等硬编码。变量以下拉列表的形式显示在控制面板顶部。通过这些下拉列表,可以轻松更改控制面板中显示的数据。
对于希望 Grafana 查看器能够快速调整可视化效果,但又不想授予其完全编辑权限的管理员来说,这些功能尤其有用。Grafana 查看器可以使用变量。
变量和模板还允许您使用单一来源控制面板。如果有多个相同的数据来源或服务器,则可以创建一个控制面板,使用变量来更改您查看的内容。这极大地简化了维护和保养。
模板
模板是任何包含变量的查询。例如,如果要管理一个控制面板来监控多个服务器,则可以为每个服务器创建一个控制面板,也可以创建一个控制面板并使用带有模板查询的面板,如下所示。
wmi_system_threads{instance=~"$server"}
变量值始终使用语法 var-<varname>=value 同步到 URL。
示例
变量位于屏幕顶部的下拉列表中。选择不同的变量,查看可视化效果的变化。
要查看变量设置,请导航到控制面板设置 > 变量。单击列表中的变量以查看其设置。
变量可用于标题、描述、文本面板和查询。以 $
开头的文本为模板查询。并非所有面板都有模板查询。
变量最佳实践
-
变量下拉列表按照控制面板设置的变量列表中列出的顺序显示。
-
将经常更改的变量放在顶部,这样它们就会显示在最前面(控制面板的最左边)。
-
默认情况下,变量会预先选择下拉列表中最上面的值。如果要选择空值,请更改变量设置,如下所示:
-
选中包含全部选项复选框。
-
在自定义所有值字段中,输入值
+
。
-