仪表盘 URL 变量
仪表盘 URL 变量允许您在分享仪表盘 URL 时提供更多上下文。
例如,您可以分享一个基本的仪表盘 URL,看起来像这样
https://${your-domain}/path/to/your/dashboard
这允许用户导航到仪表盘,但并未提供任何可能有用的上下文信息。
您可以选择添加仪表盘变量作为 URL 查询参数,提供像这样的 URL
https://${your-domain}/path/to/your/dashboard?var-example=value
这样,当用户导航到仪表盘时,您可以提供额外的上下文信息。
作为查询参数的变量
Grafana 将以 var-
为前缀的查询字符串参数解释为给定仪表盘中的变量。
例如
https://${your-domain}/path/to/your/dashboard?var-example=value
在此 URL 中,查询参数 var-example=value
表示仪表盘变量 example
的值为 value
。
变量的多个值
要传递多个值,为每个值重复该变量参数
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
Grafana 将 var-example=value1&var-example=value2
解释为仪表盘变量 example
,带有两个值:value1
和 value2
。
示例
Grafana Play 中的这个仪表盘传递了带有多个值的变量 server
,以及各带一个值的变量 app
和 interval
。
即时过滤器
即时过滤器将键/值过滤器应用于所有使用指定数据源的指标查询。有关更多信息,请参阅添加即时过滤器。
要将即时过滤器作为查询参数传递,请使用变量语法传递即时过滤器变量。然后以竖线分隔的列表形式提供键、运算符和值。
例如
https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value
在此 URL 中,查询参数 var-adhoc=key|=|value
应用了配置为 adhoc
仪表盘变量的即时过滤器,使用了 example_key
键、=
运算符和 example_value
值。
注意
分享带有即时过滤器的 URL 时,请记住对 URL 进行编码。在前面的示例中,将竖线 (
|
) 替换为%7C
,将等号 (=
) 替换为%3D
。
示例
Grafana Play 中的这个仪表盘传递了即时过滤器变量 Filters
,其过滤值为 job = metrictank/tsdb-gw
。
使用 URL 控制时间范围
您可以通过在仪表盘 URL 中提供以下查询参数来控制仪表盘的时间范围
from
- 定义时间范围的下限,以毫秒、 epoch 或相对时间指定。to
- 定义时间范围的上限,以毫秒、 epoch 或相对时间指定。time
和time.window
- 定义时间范围从time-time.window/2
到time+time.window/2
。两个参数都应以毫秒为单位。例如?time=1500000000000&time.window=10000
会生成一个从 1499999995000 到 1500000005000 的 10 秒时间范围。timezone
- 定义时区。例如timezone=Europe/Madrid
。
由于这些不是变量,它们不需要 var-
前缀。
以下示例显示了一个时间范围为最近五分钟的仪表盘
https://${your-domain}/path/to/your/dashboard?from=now-5m&to=now
仪表盘链接中的变量
在仪表盘设置中创建仪表盘链接时,可以通过选择相应选项将当前仪表盘变量包含在链接中

有关向仪表盘链接添加变量的步骤,请参阅管理仪表盘链接。