链接 - 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 定义时间范围的下限，以毫秒纪元为单位指定。

  • to 定义时间范围的上限，以毫秒纪元为单位指定。

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

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

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

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

时间范围面板变量

您可以使用以下变量在数据链接 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 毫秒纪元）到 URL；例如，?time=1560268814105

  • __value.raw：原始值

  • __value.numeric：值的数字表示

  • __value.text：值的文本表示

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

模板变量

在链接到其他使用模板变量的控制面板时，请为选择链接的用户选择变量值。

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

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