本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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-=v <varname>alue 同步到网址。
示例
变量列在屏幕顶部的下拉列表中。选择不同的变量以查看可视化效果如何变化。
要查看变量设置,请导航至仪表板设置 > 变量。单击列表中的变量可查看其设置。
变量可用于标题、描述、文本面板和查询。以开头的文本的查询$
是模板。并非所有面板都有模板查询。
可变的最佳实践
-
变量下拉列表按仪表板设置中变量列表中的列出顺序显示。
-
将经常更改的变量放在顶部,这样它们就会首先显示(在仪表板的最左边)。
-
默认情况下,变量会预先选择下拉列表中最上面的值。如果要改为选择空值,请更改变量设置,如下所示:
-
选中 “包括全部选项” 复选框。
-
在 “自定义所有值” 字段中,输入值
+
。
-