菜单
Grafana Cloud Enterprise 开源

仪表盘 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,带有两个值:value1value2

示例

Grafana Play 中的这个仪表盘传递了带有多个值的变量 server,以及各带一个值的变量 appinterval

即时过滤器

即时过滤器将键/值过滤器应用于所有使用指定数据源的指标查询。有关更多信息,请参阅添加即时过滤器

要将即时过滤器作为查询参数传递,请使用变量语法传递即时过滤器变量。然后以竖线分隔的列表形式提供键、运算符和值。

例如

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 或相对时间指定。
  • timetime.window - 定义时间范围从 time-time.window/2time+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

在仪表盘设置中创建仪表盘链接时,可以通过选择相应选项将当前仪表盘变量包含在链接中

Dashboard link page with variables option selected

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