链接 - Amazon Managed Grafana
你应该使用哪个链接？使用 URL 控制时间范围数据链接变量

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

链接

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

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

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

您可以使用链接在常用仪表板之间导航，或者将其他人连接到您的可视化效果。通过链接，您可以创建指向其他仪表板、面板甚至外部网站的快捷方式。

Amazon Managed Grafana 支持控制面板链接、面板链接和数据链接。仪表板链接显示在仪表板的顶部。选择面板左上角的图标即可访问面板链接。

首先，请检查您当前在仪表板之间导航的方式。如果你经常在一组仪表板之间跳来跳去，难以在每个仪表板中找到相同的上下文，那么链接可以帮助优化你的工作流程。

下一步是找出哪种链接类型适合您的工作流程。尽管 Grafana 中的所有链接类型都用于创建指向其他仪表板或外部网站的快捷方式，但它们在不同的上下文中起作用。

  • 要添加与仪表板中的大多数或全部面板相关的链接，请使用仪表板链接。

  • 要深入了解特定的面板，请使用面板链接。

  • 要链接到外部站点，您可以使用仪表板链接或面板链接。

  • 要深入了解特定的系列，甚至是单个测量值，请使用数据链接。

使用 URL 控制时间范围

您可以通过在仪表板 URL 中提供以下查询参数来控制面板或仪表板的时间范围：

  • from定义时间范围的下限，以 ms epoch 为单位指定。

  • to定义时间范围的上限，以 ms epoch 为单位指定。

  • time并time.window定义从time-time.window/2到的时间范围time+time.window/2。两个参数都应以毫秒为单位指定。例如，?time=1500000000000&time.window=10000将得出 10 秒的时间范围从 1499999995000 到 1500000005000

您可以在数据链接中使用变量来查看系列字段、标签和值。有关数据链接的更多信息，请参阅数据链接。

要查看可用变量列表，请在数据链接 URL 字段中输入 $。

您也可以在数据链接 URL 中使用模板变量。有关更多信息，请参阅 模板和变量。

时间范围面板变量

您可以使用以下变量在数据链接 URL 中包含当前时间范围：

  • __url_time_range— 当前仪表板的时间范围；例如，?from=now-6h&to=now

  • $__from and $__to— 有关更多信息，请参阅 [全局变量] ({{< relref “.. /variables/variable-types/global-variables.md #__from and-__to” >}})。

系列变量

特定于系列的变量在__series命名空间下可用：

  • __series.name— 将系列名称添加到 URL

  • __series.labels.<LABEL>— 将标签的值添加到 URL。如果您的标签包含圆点，请使用__series.labels["<LABEL>"]语法。

字段变量

特定于字段的变量在命名空间下__field可用：

  • __field.name— 字段的名称

值变量

特定于值的变量在__value命名空间下可用：

  • __value.time— 该值的时间戳（Unix ms epoch）到 URL；例如，?time=1560268814105

  • __value.raw— 原始价值

  • __value.numeric— 值的数字表示形式

  • __value.text— 值的文本表示形式

  • __value.calc— 如果值是计算结果，则为计算名称

模板变量

在链接到其他使用模板变量的仪表板时，请为选择链接的人选择变量值。

使用var-myvar=${myvar}，其中myvar是模板变量的名称，该名称与您要使用的当前仪表板中的模板变量相匹配。

要将当前仪表板的所有变量添加到 URL 中，请使用__all_variables。