本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
控制面板 URL 变量
本文档主题专为支持 Grafana 9.x 版本的 Grafana 工作空间而设计。
有关支持 Grafana 版本 10.x 的 Grafana 工作空间,请参阅。在 Grafana 版本 10 中工作
有关支持 Grafana 8.x 版本的 Grafana 工作空间,请参阅。在 Grafana 版本 8 中工作
Grafana 可以应用在控制面板网址中作为查询参数传递的变量值。有关更多信息,请参阅管理仪表板链接以及模板和变量。
将变量作为查询参数传递
Grafana 将前缀为前缀的查询字符串参数解释为给定仪表板var-
中的变量。
例如,在这个 URL 中:
https://${your-domain}/path/to/your/dashboard?var-example=value
查询参数var-example=value
表示值为的仪表板变量示例value
。
为变量传递多个值
要传递多个值,请为每个值重复一次变量参数。
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
Grafana var-example=value1&var-example=value2
解释为带有两个值的仪表板变量示例:和。value1
value2
向仪表板链接添加变量
当你通过仪表板设置生成仪表板链接时,Grafana 可以向它们添加变量。有关添加变量的更多信息和步骤,请参阅管理仪表板链接。
传递临时过滤器
即席筛选器将键或值筛选器应用于使用指定数据源的所有指标查询。有关更多信息,请参阅即席过滤器。
要将即席过滤器作为查询参数传递,请使用变量语法传递即席过滤器变量,并提供键、运算符作为值、值作为竖线分隔的列表。
例如,在这个 URL 中:
https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value
查询参数使用example_key
密钥、=
运算符和example_value
值var-adhoc=key|=|value
应用配置为即席仪表板变量的即席筛选器。
注意
使用临时过滤器共享 URL 时,请记得对 URL 进行编码。在上面的示例中,将管道替换为,将(|)
相%7C
等运算符(=)
替换为 %3D
。
使用 URL 控制时间范围
要设置仪表板的时间范围,请使用from
to
、time
、和time.window
查询参数。因为这些不是变量,所以它们不需要前var-
缀。