“探索” 中的关联编辑器 - Amazon Managed Grafana
创建关联变换相关性示例

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

“探索” 中的关联编辑器

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

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

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

关联允许用户在任意两个数据源之间建立链接。有关更多信息，包括相关性概述，请参阅Grafana 版本 10 中的相关性。

创建关联

您可以从 “浏览” 页面创建关联。

创建关联

  1. 在您的亚马逊托管 Grafana 工作区中，导航至 “浏览” 页面。

  2. 选择要作为新关联源的数据源。

  3. 运行查询，在支持的可视化中生成数据。

    注意

    支持的可视化为日志和表格。

  4. 在顶部工具栏中选择 “+ 添加”，然后选择 “添加关联”（您也可以从命令面板中选择 “关联编辑器”）。

    “浏览” 现在处于 “关联编辑器” 模式，由蓝色边框和顶部栏指示。您可以通过选择顶部栏中的 “退出” 来退出关联编辑器。

  5. 现在，您可以使用附加到可用于构建新查询的数据的链接，为可视化创建以下新的关联：

    • 日志-链接显示在每个日志行的日志详细信息中的字段值旁边。

    • 表格 — 每个表格单元格都是一个链接。

  6. 选择一个链接以添加新的关联。链接与用作关联结果字段的字段相关联。有关更多详细信息，请参阅关联配置。

  7. 在打开的拆分视图中，使用右侧窗格设置关联的目标查询源。有关更多详细信息，请参阅目标查询。

  8. 使用变量语法生成目标查询，变量来自窗格顶部的列表。该列表包含选定数据行的样本值。

  9. 提供标签和描述（可选）。标签将用作可视化中链接的名称，并且可以包含变量。

  10. 提供转换（可选；详情见下文）。

  11. 在顶部工具栏中选择 “保存” 以保存关联并退出 “关联编辑器” 模式。用于创建关联的链接将替换为每行中的数据链接。选择链接后，您定义的查询将在另一个窗格中运行，变量将动态替换为所选行中的值。

变换

转换允许您将字段中存在的值与其他数据一起提取。例如，使用转换，您可以提取日志行的一部分以用于关联。有关关联变换的更多详细信息，请参见。关联变换

在编辑器模式下选择一个生成的链接后，您可以通过在 “转换” 下拉菜单中选择 “添加转换” 来添加转换。

在关联中使用变换

  1. 选择要应用转换的字段。选择要用于转换的字段部分。例如，日志行。选择后，此字段的值将用于帮助您构建转换。

  2. 选择转换的类型。关联变换有关选项和相关设置，请参阅。

  3. 根据您的选择，您可能会看到一个或多个变量已填充，或者可能需要在显示的选项中提供更多规格。

  4. 选择 “向关联添加转换”，将指定的变量添加到可用变量列表中。

注意

对于此对话框中的正则表达式，此Variable Name处调用其他文档中mapValue提及的正则表达式。Grafana 会突出显示与字段值中的表达式匹配的所有文本。使用正则表达式捕获组来选择应提取匹配项的哪一部分。如果提供了有效的正则表达式，则变量和该变量的值将显示在Variable Name字段下方。

相关性示例

以下示例说明如何使用 Explore 中的关联编辑器创建关联。如果您想遵循这些示例，请务必设置测试数据源。

创建文本以图表显示相关性

此示例说明如何在 “浏览” 中使用关联编辑器创建关联。

关联允许您使用一个查询的结果在任何数据源中运行新查询。在此示例中，您将运行一个呈现表格数据的查询。这些数据将用于运行不同的查询，从而生成图表结果。

要遵循此示例，请确保已设置测试数据源。

创建文本到图表的相关性

  1. 在 Grafana 中，导航到 “探索”。

  2. 从页面左上方的下拉菜单中选择测试数据源。

  3. 在右侧的下拉菜单中选择 + 添加，然后选择添加关联。

  4. “浏览” 现在处于 “关联编辑器” 模式，由蓝色边框表示。

  5. 从场景下拉菜单中选择以下场景：CSV 文件。

  6. 选择文件 population_by_state.csv。每个单元格都是一个链接，您可以单击该链接开始创建新的关联。

  7. 单击该State列中的任何单元格以创建新的关联，该关联将数据链接附加到该条目。例如，选择 California。

  8. 在拆分视图中，选择您在左窗格中选择的相同数据源。查询编辑器上方的帮助程序包含可用于目标查询的所有可用变量。变量包含选定行中的所有数据字段（表列）。

  9. 在场景菜单中，选择 CSV 指标值。查询编辑器中的String Input字段提供变量，其中包含每年的人口值:${1980},${2000},${2020}. 这将使用变量值生成图表。

  10. 在查询编辑器别名字段中，输入${State}。

    运行查询以查看它是否使用变量中的样本值生成图表。

  11. 选择 “保存” 以保存关联并退出关联编辑器。

    保存关联后，Explore 将在左侧窗格中重新运行查询。通过单击状态名称，可以重新运行右侧的查询，并将该行的值插入到 CSV 中，从而更改图表。每次单击状态名称时，都会使用更新的值重新运行查询。

您可以对任何数据源应用相同的步骤。关联允许您在可视化中创建链接，以便根据所选数据运行动态查询。在此示例中，我们使用查询返回的数据来构建一个使用相同数据源生成不同可视化效果的新查询。但是，您可以在任何数据源之间创建关联以创建自定义探索流程。

创建日志到表的关联

在此示例中，您将创建关联来演示如何使用变换从日志行和另一个字段中提取值。

要遵循此示例，请确保已设置测试数据源。

创建日志到表的关联

  1. 在 Grafana 中，导航到 “探索”。

  2. 从页面左上方的下拉菜单中选择测试数据源。

  3. 在右侧的下拉菜单中选择 + 添加，然后选择添加关联。

  4. “浏览” 现在处于 “关联编辑器” 模式，由蓝色边框表示。

  5. 在场景菜单中，选择日志。

  6. 展开日志行以查看关联链接。选择 Correlate with hostname。

  7. 浏览将在分屏视图中打开。选择您在左窗格中选择的相同数据源。查询编辑器上方的帮助程序包含可用于目标查询的所有可用变量。

  8. 展开 “转换” 部分，然后单击 “添加转换”。

  9. 在字段下拉菜单中，选择消息。日志行显示为示例数据。

  10. 在 “类型” 下，选择 Logfmt。这将填充变量列表。

  11. 选择 “向关联添加转换”。

  12. 再次选择 “添加转换”，然后在 “字段” 下选择主机名。

  13. 在 “类型” 下，选择 “正则表达式”。

  14. 在 “表达式” 下，输入以下内容：-([0-9]\*)。这将选择破折号右侧的任何数字。

  15. 在变量名下，输入以下内容：hostNumber。这将填充变量列表。

  16. 选择 “向关联添加变换”，将其添加到其他变量中。

  17. 在数据源编辑器中，打开场景下拉菜单并选择 CSV 内容。

  18. 在下面的文本框中，提供以下内容并保存关联：

    time,msg,hostNumber,status
${time},${msg},${hostNumber},${status}

    这将关闭拆分视图并重新运行左侧查询。展开任意日志行即可看到关联按钮。选择关联按钮将打开拆分视图，其中包含time（a 字段）、msg（使用 logfmt 从日志行中提取）、host number（使用正则表达式提取）和（使用 l o gfm t 从日志行中提取hostname）。status