配置数据链接 - Amazon Managed Grafana
数据链接变量添加数据链接

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

配置数据链接

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

对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅 使用 Grafana 版本 9。

对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅 使用 Grafana 版本 8。

通过数据链接，可为链接提供更精细的上下文。您可以创建包含序列名称甚至光标下值的链接。例如，如果您的可视化显示四台服务器，则可以向其中一两台服务器添加数据链接。您也可以使用数据链接来链接面板。

根据可视化效果，可通过不同的方式访问链接本身。例如，对于时间序列可视化，您可以选择数据点或数据线。对于统计、仪表或条形仪表之类的大面积可视化，您可以选择可视化中的任意位置来打开上下文菜单。

如果可视化中只有一个数据链接，则选择可视化中的任意位置都会打开链接，而不是上下文菜单。

支持的可视化

  • 条形图

  • 条形仪表

  • K 线图

  • 画布

  • 计量表

  • Geomap

  • 热图

  • 直方图

  • 饼图

  • Stat

  • 状态时间轴

  • 状态历史记录

  • 表

  • 时间序列

  • 趋势

您可以在数据链接中使用变量，将用户引导至具有保留数据筛选条件的详细控制面板。例如，您可以使用变量来指定标签、时间范围、序列和变量选择。

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

您也可以在数据链接 URL 中使用模板变量，请参阅 Variables。

时间范围面板变量

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

  • __url_time_range：当前控制面板的时间范围（即 ?from=now-6h&to=now）

  • $__from – 有关更多信息，请参阅全局变量。

  • $__to – 有关更多信息，请参阅全局变量。

序列变量

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

  • __series.name：URL 的序列名称

字段变量

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

  • __field.name：字段的名称

  • __field.labels.<LABEL>：URL 的标签值。如果您的标签包含点，请使用 __field.labels["<LABEL>"] 语法。

值变量

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

  • __value.time：URL 的值的时间戳（Unix 毫秒纪元）（即 ?time=1560268814105）

  • __value.raw：原始值

  • __value.numeric：值的数字表示

  • __value.text：值的文本表示

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

在数据链接中使用特定于值的变量可以显示不同的结果，具体取决于工具提示模式的设置选项。

数据变量

要访问其他字段的值，请使用：

  • __data.fields[i]：字段 i 的值（在同一行上）。

  • __data.fields["NameOfField"]：使用名称而不是索引的字段值。

  • __data.fields[i].labels.cluster：访问其他字段的标签。

模板变量

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

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

变量状态 创建 URL 的结果
选择一个值 var-myvar=value1
选择多个值 var-myvar=value1&var-myvar=value2
已选择 All var-myvar=All

如果要将当前控制面板的所有变量添加到 URL，请使用 ${__all_variables}。

您可以向面板添加数据链接。

  1. 导航到要向其添加数据链接的面板。

  2. 将鼠标悬停在面板上，右上角会显示菜单图标。

  3. 从菜单中选择编辑以打开面板编辑器。

  4. 在面板编辑窗格中，向下滚动到数据链接部分并将其展开。

  5. 选择添加链接。

  6. 在打开的对话框中，输入标题。这是是链接的可读标签，显示在 UI 中。

  7. 输入要链接的 URL 或变量。

    要添加数据链接变量，请选择 URL 字段，然后输入 $ 或按 Ctrl+Space 或 Cmd+Space 以查看可用变量列表。

  8. 如果要在新选项卡中打开链接，请选择在新选项卡中打开。

  9. 选择保存以保存更改并关闭对话框。

  10. 保存对控制面板的更改。