本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
本文档主题专为支持 Grafana 10.x 版本的 Grafana 工作区而设计。
对于支持 Grafana 9.x 版本的 Grafana 工作区,请参阅使用 Grafana 版本 9。
对于支持 Grafana 8.x 版本的 Grafana 工作区,请参阅使用 Grafana 版本 8。
关联允许用户在任意两个数据来源之间建立链接。有关更多信息,包括关联概述,请参阅 Grafana 10 版本中的关联。
创建关联
您可以从 Explore 页面创建关联。
创建关联
-
在您的 Amazon Managed Grafana 工作区中,导航至 Explore 页面。
-
选择要作为新关联来源的数据来源。
-
运行查询,在支持的可视化中生成数据。
-
在顶部工具栏中选择 + 添加,然后选择添加关联(您也可以从命令调色板中选择关联编辑器)。
Explore 现在处于关联编辑器模式,由蓝色边框和顶部栏指示。您可以在顶部栏中选择退出以退出关联编辑器。
-
现在,您可以为可视化创建以下新的关联,其中包含附加到可用于构建新查询的数据的链接:
-
日志:链接显示在每个日志行的日志详细信息中的字段值旁。
-
表:每个表单元格都是一个链接。
-
-
选择链接以添加新的关联。链接与用作关联结果字段的字段相关联。有关更多详细信息,请参阅 关联配置。
-
在打开的拆分视图中,使用右侧窗格设置关联的目标查询来源。有关更多详细信息,请参阅 目标查询。
-
使用变量语法生成目标查询,可从窗格顶部提供的列表中选择变量。该列表包含选定数据行中的样本值。
-
提供标签和描述(可选)。标签将用作可视化中链接的名称,可包含变量。
-
提供转换(可选;详情见下文)。
-
在顶部工具栏中选择保存,以保存关联并退出关联编辑器模式。用于创建关联的链接将被每行中的数据链接所取代。选择链接后,您定义的查询将在另一个窗格中运行,变量将动态替换为所选行中的值。
转换
通过转换,可以提取字段中存在的值和其他数据。例如,通过转换,您可以提取日志行的一部分以用于关联。有关关联转换的更多信息,请参阅 关联转换。
在编辑器模式下选择一个生成的链接后,您可以在转换下拉菜单中选择添加转换来添加转换。
在关联中使用转换
-
选择要应用转换的字段。选择要用于转换的字段。例如,日志行。一旦选中,此字段中的值可帮助您构建转换。
-
选择转换的类型。有关选项和相关设置,请参阅 关联转换。
-
根据您的选择,您可能会看到一个或多个变量填充,或者您可能需要在显示的选项中提供更多规范。
-
选择向关联添加转换,将指定的变量添加到可用变量列表中。
注意
对于此对话框中的正则表达式,其他文档中引用的 mapValue
在此处称为 Variable Name
。Grafana 会突出显示与字段值中的表达式匹配的任何文本。使用正则表达式捕获组来选择应提取的匹配部分。如果提供了有效的正则表达式,则变量和该变量的值将显示在 Variable
Name
字段下方。
关联示例
以下示例说明了如何使用 Explore 中的关联编辑器创建关联。如果要遵循这些示例,请确保设置测试数据来源。
创建文本到图形的关联
此示例说明了如何使用 Explore 中的关联编辑器创建关联。
关联允许使用查询的结果在任何数据来源中运行新查询。在本例中,您将运行一个渲染表数据的查询。该数据将用于运行不同的查询,以生成图形结果。
要遵循此示例,请确保已设置测试数据来源。
创建文本到图形的关联
-
在 Grafana 中,导航到 Explore。
-
从页面左上角的下拉菜单中,选择测试数据来源。
-
在右侧的下拉菜单中选择 + 添加,然后选择添加关联。
-
Explore 现在处于关联编辑器模式,由蓝色边框指示。
-
从场景下拉菜单中选择以下场景:CSV 文件。
-
选择文件 population_by_state.csv。每个单元格都是一个链接,单击后即可开始创建新的关联。
-
单击
State
列中的任何单元格以创建新的关联,将数据链接附加到该条目。例如,选择California
。 -
在拆分视图中,选择您在左侧窗格中选择的同一数据来源。查询编辑器上方的帮助程序包含可用于目标查询的所有可用变量。变量包含选定行中的所有数据字段(表列)。
-
在场景菜单中,选择 CSV 指标值。查询编辑器中的
String Input
字段提供了具有每年人口值的变量:${1980},${2000},${2020}
。这将使用变量值生成图形。 -
在查询编辑器别名字段中,输入
${State}
。运行查询,查看其是否使用变量中的示例值生成图形。
-
选择保存以保存关联并退出关联编辑器。
保存关联后,Explore 将在左侧窗格中重新运行查询。通过单击状态名称,将重新运行右侧的查询,并将该行的值插入 CSV,从而更改图形。每次单击状态名称时,都会使用更新的值重新运行查询。
您可以对任何数据来源应用相同的步骤。关联允许您在可视化中创建链接,以根据所选数据运行动态查询。在此示例中,我们使用查询返回的数据来构建新查询,以使用相同的数据来源生成不同的可视化效果。但您可以在任何数据来源之间创建关联,以创建自定义探索流程。
创建日志到表的关联
在此示例中,您将创建关联,以演示如何使用转换从日志行和另一个字段中提取值。
要遵循此示例,请确保已设置测试数据来源。
创建日志到表的关联
-
在 Grafana 中,导航到 Explore。
-
从页面左上角的下拉菜单中,选择测试数据来源。
-
在右侧的下拉菜单中选择 + 添加,然后选择添加关联。
-
Explore 现在处于关联编辑器模式,由蓝色边框指示。
-
在场景菜单中,选择日志。
-
展开日志行以查看关联链接。选择
Correlate with hostname
。 -
Explore 将在拆分视图中打开。选择您在左侧窗格中选择的同一数据来源。查询编辑器上方的帮助程序包含可用于目标查询的所有可用变量。
-
展开转换部分,然后单击添加转换。
-
在字段下拉菜单中,选择消息。日志行显示为示例数据。
-
在类型下,选择 Logfmt。这将填充变量列表。
-
选择向关联添加转换。
-
再次选择添加转换,然后在字段下选择主机名。
-
在类型下,选择正则表达式。
-
在表达式下,输入以下内容:
-([0-9]\*)
。这将选择破折号右侧的任何数字。 -
在变量名称下,输入以下内容:
hostNumber
。这将填充变量列表。 -
选择向关联添加变换,将其添加到其他变量中。
-
在数据来源编辑器中,打开场景下拉菜单,然后选择 CSV 内容。
-
在下面的文本框中,提供以下内容并保存关联:
time,msg,hostNumber,status ${time},${msg},${hostNumber},${status}
这将关闭拆分视图并重新运行左侧查询。展开任何日志行以查看关联按钮。选择关联按钮将打开拆分视图,其中包含
time
(a 字段)、msg
(使用 logfmt 从日志行中提取)、host number
(使用正则表达式从hostname
中提取)和status
(使用 logfmt 从日志行中提取)。