控制面板 URL 变量

本文档主题专为支持 Grafana 版本 10.x 的 Grafana 工作空间而设计。

有关支持 Grafana 9.x 版本的 Grafana 工作空间，请参阅。在 Grafana 版本 9 中工作

有关支持 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 控制时间范围

要设置仪表板的时间范围，请使用fromto、time、和time.window查询参数。因为这些不是变量，所以它们不需要前var-缀。