仪表盘 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=value2Grafana 将 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仪表盘链接中的变量
在仪表盘设置中创建仪表盘链接时,可以通过选择相应选项将当前仪表盘变量包含在链接中

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



