Variables - Amazon Managed Grafana

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

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。

示例

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

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

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

变量最佳实践

  • 变量下拉列表按照控制面板设置的变量列表中列出的顺序显示。

  • 将经常更改的变量放在顶部,这样它们就会显示在最前面(控制面板的最左边)。

  • 默认情况下,变量会预先选择下拉列表中最上面的值。如果要选择空值,请更改变量设置,如下所示:

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

    2. 自定义所有值字段中,输入值 +