本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # Grafana 10 中的 Explore **** 本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 Grafana 的控制面板 UI 提供了构建可视化控制面板的功能。*Explore* 去掉了控制面板和面板选项，以便您专注于查询。这有助于您进行迭代，直到得到有效的查询，然后您可以根据查询构建控制面板。 **注意** 如果您只想浏览数据，而不想创建控制面板，Explore 可以让该操作变得更加容易。如果数据来源支持图形和表数据，Explore 会以图形和表的形式显示结果。这样，您就可以同时查看数据趋势和更多详细信息。 此页面将引导您开始探索自己的数据。以下主题提供了有关 Explore 的特定功能和用途的更多详细信息。 + [Explore 中的查询管理](v10-explore-manage.md) + [登录 Explore](v10-explore-logs.md) + [Explore 中的跟踪](v10-explore-tracing.md) + [Explore 中的关联编辑器](v10-explore-correlations.md) + [Explore 中的检查器](v10-explore-inspector.md) ## 开始探索 **注意** 要访问 Explore，您必须具有编辑者或管理员角色。 **访问 Explore** 1. 在 Grafana 工作区中，从左侧菜单栏中选择 Explore 菜单项。 这将打开一个空的 Explore 选项卡。 或者，要从面板中的现有查询开始，请从“面板”菜单中选择 Explore 选项。这将打开 Explore 选项卡，其中包含来自面板的查询，并让您可以在控制面板之外调整或迭代查询。 1. 从左上角的下拉列表中选择数据来源。 您还可以选择**打开高级数据来源选取器**以查看更多选项，包括添加数据来源（仅限管理员）。 1. 使用所选数据来源提供的查询编辑器编写查询。 有关查询的详细信息，请参阅 [查询和转换数据](v10-panels-query-xform.md)。 1. 使用右上角的按钮运行查询。 ## 拆分和比较 拆分视图提供了一种比较可视化效果 side-by-side或在一个页面上一起查看相关数据的简便方法。 **顶部打开拆分视图** 1. 在 “浏览” 视图中，选择 “**拆分**” 按钮以复制当前查询，并将页面拆分为两个 side-by-side查询。 **注意** 可以为新查询选择其他数据来源，例如，比较两个不同服务器的同一查询，或比较暂存环境和生产环境。 在拆分视图中，选择附加到其中一个时间选取器的时间同步按钮，可以链接两个面板的时间选取器（如果更改一个，另一个也会更改）。链接时间选取器可使拆分视图查询的开始和结束时间保持同步。这样可确保您在两个拆分面板中看到相同的时间间隔。 1. 要关闭新创建的查询，请选择**关闭拆分**按钮。 ## 内容大纲 内容大纲是一个侧面导航栏，用于跟踪您在 Explore 中创建的查询和可视化。您可以在它们之间快速导航。 内容大纲也适用于拆分视图。在拆分视图中，会为每个窗格生成内容大纲。 **打开内容大纲** 1. 选择 **Explore** 屏幕左上角的**大纲**按钮。 1. 选择内容大纲中的任何面板图标，以导航到该面板。 ## 分享探索 URLs 使用 Explore 时，浏览器地址栏中的 URL 会随着您对查询的更改而更新。您可以共享或将此 URL 加入书签。 **注意** 探索可能会产生相对较长的时间 URLs。如果 URL 太长，不适合使用工具，也可以生成并共享[短链接](#v10-explore-share)。 **使用外部工具生 URLs 成 Explore** 由于 Explore URLs 具有已定义的结构，因此您可以从外部工具构建 URL，然后在 Grafana 中将其打开。URL 结构为： ``` http:///explore?panes=&schemaVersion=&orgId= ``` 其中： + `org_id` 为组织 ID。 + `schema_version` 为架构版本（应设置为最新版本，即 `1`）。 + `panes` 是窗格的 URL 编码 JSON 对象，其中每个键都是窗格 ID，每个值都是符合以下模式的对象： ``` { datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources queries: { refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc. datasource: { uid: string; // the query's datasource UID ie: "AD7864H6422" type: string; // the query's datasource type-id, i.e: "loki" } // ... any other datasource-specific query parameters }[]; // array of queries for this pane range: { from: string; // the start time, in milliseconds since epoch to: string; // the end time, in milliseconds since epoch } } ``` **注意** `from` 和 `to` 字段还接受 [设置控制面板时间范围](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range) 主题中所述的相对范围。 ## 共享短链接 共享缩短链接功能允许您创建更小、更简单 URLs的 /goto/:uid 格式，而不必在查询参数中使用更长的时间。 URLs 要创建指向查询结果的短链接，请在 Explore 工具栏中选择**共享**选项。从未使用过的短链接将在七（7）天后自动删除。如果链接至少使用过一次，则该链接不会被删除。 **在绝对时间内共享短链接** 短链接有两个选项：保留相对时间（例如，从两个小时前到当前时间）或绝对时间（例如，从上午 8 点到上午 10 点）。默认情况下，共享短链接将复制选定时间范围、相对时间范围或绝对时间范围。通过选择共享短链接按钮旁边的下拉按钮，然后选择**时间同步 URL 链接**的一个选项，您可以创建具有绝对时间的短链接，这意味着任何收到链接的人都将看到与您看到的相同数据，即使他们在其他时间打开此链接。此选项不会影响在 Explore 视图中选择的时间范围。 # Explore 中的查询管理 **** 本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 您可以管理在 Explore 中创建的查询，包括已运行查询的历史记录和已加星标的查询。 ## 查询历史记录 查询历史记录是您在 Explore 中使用的查询列表。历史记录存储在 Grafana 数据库中，不与其他用户共享。历史查询的保留期为两周。超过两周的查询会被自动删除。要打开历史记录并与之交互，请在 Explore 中选择**查询历史记录**按钮。 **注意** 带星号（收藏）的查询不受两周保留期的限制，也不会被删除。 ## 查看查询历史记录 您可以通过“查询历史记录”查看查询历史记录。对于每个单独的查询，您可以： + 运行查询。 + 创建 and/or 编辑评论。 + 将查询复制到剪贴板。 + 将包含查询的短链接复制到剪贴板。 + 为查询加上星号（收藏）。 ## 管理收藏的查询 “查询历史记录”选项卡中所有标有星号的查询都会显示在“已加星标”选项卡上。这让您可以快速访问收藏的查询，且无需从头开始键入，即可重用这些查询。 ## 对查询历史记录排序 默认情况下，查询历史记录会显示最新的查询。您可以按日期或数据来源名称以升序或降序对历史记录排序。 **对查询历史记录排序** 1. 选择**查询排序依据**字段。 1. 选择下列选项之一： + **最新的优先** + **最早的优先** ## 筛选查询历史记录 您可以在“查询历史记录”和“已加星标”选项卡中将查询历史记录筛选到特定的数据来源。 **将历史记录筛选到数据来源** 1. 选择**筛选特定数据来源查询**字段。 1. 选择要为其筛选历史记录的数据来源。您也可以选择多个数据来源。 **注意** 使用混合数据来源运行的查询仅在筛选混合数据来源时才会出现，按单个数据来源筛选时不会显示。 在**查询历史记录**选项卡中，还可以使用滑块按日期筛选查询： + 使用垂直滑块按日期筛选查询。 + 拖动底部手柄调整开始日期。 + 拖动顶部手柄调整结束日期。 ## 在查询历史记录中搜索 您可以在历史记录中跨查询和评论进行搜索 在“查询历史记录”选项卡和“已加星标”选项卡中搜索查询。 **在查询历史记录中搜索** 1. 选择**搜索查询**字段。 1. 在搜索字段中输入您要搜索的术语。 ## 查询历史记录设置 您可以在“设置”选项卡中自定义查询历史记录。下表描述了这些选项。 | 设置 | 默认 值 | | --- | --- | | 更改默认的活动选项卡 | “查询历史记录”选项卡 | **注意** 查询历史记录设置是全局型的，在拆分模式下应用于两个面板。 # 登录 Explore **** 本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 Explore 让您可以调查不同数据来源中的日志，包括： + [OpenSearch](using-opensearch-in-AMG.md) + [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md) + [InfluxDB](using-influxdb-in-AMG.md) + [Loki](using-loki-in-AMG.md) 在基础设施监控和事件响应期间，您可以深入挖掘指标和日志，找出原因。Explore 还允许您通过查看日志与其他遥测信号（例如指标、轨迹或配置文件）关联起来。 side-by-side 日志查询的结果显示为单独的日志行和显示选定时间段内日志量的图形。 ## 日志卷 在处理支持全范围日志卷的数据来源时，Explore 会自动显示一个图形，其中显示所有输入日志查询的日志分布情况。 OpenSearch 和 Loki 数据源目前支持此功能。 **注意** 在 Loki 中，这种全范围的日志卷通过指标查询来呈现，可能开销较大，具体取决于查询的时间范围。对于较小的 Loki 安装来说，处理这种查询尤其具有挑战性。为了缓解这种情况，您可以在 Loki 前面使用像 [nginx](https://www.nginx.com/) 这样的代理来为这些查询设置自定义超时（例如 10 秒）。可通过查找带有 HTTP 标头 `X-Query-Tags`（值为 `Source=logvolhist`）的查询来识别日志卷直方图查询；Grafana 会将这些标头添加到所有日志卷直方图查询中。 如果数据来源不支持加载全范围日志卷，则日志模型会通过对日志行进行计数，并根据自动计算的时间间隔将其整理到桶中来计算时间序列。第一个日志行的时间戳用于在结果中锚定日志卷的开始位置。时间序列的末尾锚定到时间选取器的 **To** 范围。这样，即使数据来源不提供全方位支持，您也能高效地分析和可视化日志数据。 ## 日志 在以下各节中，您将找到有关如何在 Explore 中可视化单个日志并与之交互的详细说明。 ## 日志导航 日志导航位于日志行的右侧，可用于轻松请求更多日志。您可以单击导航底部的**旧日志**按钮完成此操作。当您达到行限制并希望查看更多日志时，这尤其有用。然后，从导航中运行的每个请求都会作为单独页面显示在导航中。每个页面都显示传入日志行的 `from` 和 `to` 时间戳。您可以通过单击每个页面来查看之前的结果。Explore 会缓存从日志导航中运行的最后五个请求，因此您在单击页面时不会重新运行相同的查询，从而节省时间和资源。 ## 可视化选项 您可以自定义日志的显示方式，并选择显示哪些列。 | 选项 | 描述 | | --- | --- | | 时间 | 显示或隐藏时间列。这是与数据来源报告的日志行关联的时间戳。 | | 唯一标签 | 显示或隐藏仅包含非常用标签的唯一标签列。上面显示了所有常用标签。 | | 换行 | 如果希望使用换行显示，请将其设置为 true。如果设置为 false，则会导致水平滚动。 | | 修饰 JSON | 将其设置为 true 可打印所有 JSON 日志。此设置不会影响 JSON 以外的任何格式的日志。 | | 重复数据删除 | 日志数据可能有很多重复，而 Explore 可以隐藏重复的日志行。您可以使用几种不同的重复数据删除算法。精确：除日期字段外，对整行进行精确匹配。数字：去除持续时间、IP 地址等数字后，在行上进行匹配。签名：最激进的重复数据删除方法，该方法会去除所有字母和数字，匹配剩余的空格和标点符号。 | | 显示结果顺序 | 您可以将接收日志的顺序从默认降序（最新的优先）改为升序（最早的优先）。 | ## 下载日志行 要下载 `txt` 或 `json` 格式的日志结果，请使用**下载**按钮。此功能允许保存日志数据以供进一步分析，或以方便且易于访问的格式与他人共享。 ## 记录结果元信息 在收到的日志行上方，您可以找到基本的元信息，包括： + **接收的日志数**：表示当前查询或时间范围内收到的日志总数。 + **错误**：在日志结果中显示可能存在的错误。 + **常用标签**：显示常用标签。 + **处理的总字节数**：表示以字节为单位处理的日志数据的累积大小。 **注意** 某些元信息的可用性可能取决于数据来源，因此，您可能只能看到特定数据来源的部分详细信息。 ## 转义换行符 Explore 可自动检测日志行中的一些错误转义序列，如换行符（`\n`、`\r`）或制表符（`\t`）。当检测到此类序列时，Explore 会提供**转义换行符**选项。 **自动修复 Explore 检测到的错误转义序列** 1. 选择**转义换行符**来替换序列。 1. 手动检查替换项以确认其正确性。 Explore 将替换这些序列。替换时，选项将从**转义换行符**变为**删除转义**。评估变更，因为根据接收的输入，解析可能不准确。您可以选择**删除转义**来恢复替换项。 ## 日志级别 对于指定了 `level` 标签的日志，我们会使用此标签值来确定日志级别，并相应地更新每个日志行的颜色。如果日志未指定级别标签，则会尝试查明其内容是否与任何受支持的表达式匹配（有关更多信息，请参阅下表）。日志级别始终由第一个匹配项决定。如果 Grafana 无法推断日志级别字段，则会使用未知的日志级别对其可视化。 **注意** 如果使用 Loki 数据来源，且 `level` 是日志行的一部分，请使用解析程序（JSON、logfmt、regex,..）将级别信息提取到用于确定日志级别的级别标签中。这允许直方图在单独的条形图中显示不同的日志级别。 **支持的日志级别以及日志级别缩写和表达式的映射：** | 日志级别 | 颜色 | 支持的表达式 | | --- | --- | --- | | critical | purple | emerg、fatal、alert、crit、critical | | 错误 | red | err、eror、error | | warning | yellow | warn、warning | | info | green | info、information、informational、notice | | debug | blue | dbug、debug | | trace | light blue | trace | | unknown | grey | \$1 | ## 突出显示搜索的词 当您的查询包含要搜索的特定词或表达式时，Explore 将在日志行中突出显示这些词或表达式，以便更好地查看。通过此突出显示功能，您可以更轻松地识别和关注日志中的相关内容。 **注意** 突出显示搜索词的能力可能因数据来源而异。对于某些数据来源，可能无法突出显示搜索词。 ## 日志详细信息 在 Explore 中，每条日志行都有一个名为*日志详细信息*的可扩展部分，可通过选择日志行将其打开。日志详细信息视图以附加到日志行的*字段*和*链接*的形式提供其他信息和探索选项，从而实现更强大的交互和分析。 **字段** 在日志详细信息视图中，您可以通过两种方式筛选显示的字段：正筛选条件（关注特定字段）和负筛选条件（排除特定字段）。这些筛选条件将更新生成日志行的相应查询，相应地添加等式和不等式表达式。如果数据源有支持（例如 Loki 和） OpenSearch，则日志详细信息将检查该字段是否已存在于当前查询中显示和活动状态（仅适用于正向筛选器），允许您将其关闭查询，或者将筛选表达式从正值更改为负值。 通过单击眼睛图标，您可以在日志列表中选择要可视化的字段子集，而不是完整的日志行。每个字段都有一个统计图标，以显示与所有显示的日志相关的统计信息。 **Links** Grafana 提供了数据链接或关联的功能，使您能够将日志消息的任何部分转换为内部或外部链接。这些链接可用于导航到相关数据或外部资源，提供了一种无缝和方便的方式来探索进一步的信息。 ## 日志上下文 日志上下文显示与特定搜索查询匹配的日志条目相关的附加上下文行。这有助于理解日志条目的上下文，类似于 `grep` 命令中的 `-C` 参数。 您可能会遇到长行文本，这使得难以阅读和分析每个日志条目相关的上下文。这就是**换行**开关派上用场的地方。启用此开关后，Grafana 将自动换行长行文本，使其适合查看器的可见宽度。这样可以更容易阅读和理解日志条目。 **在拆分视图中打开**按钮允许您在 Explore 视图的分屏中对日志条目执行上下文查询。选择此按钮将打开一个新的 Explore 窗格，在日志条目旁边显示上下文查询，从而更容易分析和理解相关上下文。 也可以在新的浏览器选项卡中打开日志上下文查询，方法是在选择按钮以打开上下文模式的同时按 `Ctrl`（或 `Cmd`）键。在新选项卡中打开时，还会应用先前选择的筛选条件。 ## 复制日志行 通过选择**复制日志行**按钮，可将选定日志行的内容轻松复制到剪贴板。 ## 将链接复制到日志行 通过 Grafana 中的日志行链接，您可以快速导航到特定日志条目进行精确分析。选择日志行的**复制短链接**按钮后，您可以生成并复制一个短 URL，在绝对时间范围内直接访问确切的日志条目。打开链接后，Grafana 会自动滚动到相应的日志行，以蓝色背景突出显示，便于识别和关注相关信息。 **注意** 只有 Loki 和其他提供 `id` 字段的数据来源支持此功能。 ## 实时跟踪 要查看来自受支持数据来源的实时日志，您可以利用 Explore 中的实时跟踪功能。 **使用实时跟踪近乎实时地查看日志** 1. 选择 Explore 工具栏中的**实时**按钮以切换到实时跟踪视图。 1. 在实时跟踪视图中，新日志将出现在屏幕底部，并具有渐变的对比背景，以便您轻松跟踪新增内容。 1. 如果您想暂停实时跟踪并不间断地查看以前的日志，可以选择**暂停**按钮或直接滚动日志视图。 1. 要清除视图并从显示中删除所有日志，请选择**清除日志**按钮。此操作将重置日志视图，并为您提供一个全新的样本，以便继续进行日志分析。 1. 要恢复实时跟踪并继续查看实时日志，请选择**恢复**按钮。 1. 如果要退出实时跟踪并返回 Explore 标准视图，请选择**停止**按钮。 通过实时跟踪功能，您可以密切关注最新日志，从而更容易监控实时事件并及时检测问题。 **日志示例** 如果所选数据来源实现了日志示例，同时支持日志和指标查询，那么对于指标查询，您将能够自动查看有助于可视化指标的日志行示例。Loki 数据来源目前支持此功能。 **从指标切换到日志** 如果您从实施 `DataSourceWithQueryExportSupport` 的指标数据来源（例如 Prometheus）到支持 `DataSourceWithQueryImportSupport` 的日志记录数据来源（例如 Loki），则其将保留日志中存在的查询标签，并使用这些标签来查询日志流。 例如，在切换到 Loki 数据来源后，以下 Prometheus `grafana_alerting_active_alerts{job='grafana'}` 查询将变为 `{job='grafana'}`。这将返回选定时间范围内可供 grepped/text 搜索的大量日志。 # Explore 中的跟踪 **** 本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 您可以通过 Explore 可视化来自数据来源的跟踪。 支持以下数据来源。 + [Tempo](tempo-data-source.md)（支持的摄取格式： OpenTelemetry、Jaeger 和 Zipkin） + [Jaeger](jaeger-data-source.md) + [AWS X-Ray](x-ray-data-source.md) + [Zipkin](zipkin-data-source.md) 有关如何为上述数据来源配置查询的信息，请参阅特定数据来源的文档。 ## 查询编辑器 您可以使用数据来源的查询编辑器来查询和搜索跟踪数据。 每个数据来源可以有自己的查询编辑器。Tempo 数据来源的查询编辑器与 Jaeger 数据来源的查询编辑器略有不同。 有关查询每个数据来源的信息，请参阅其文档。 + [Tempo](tempo-data-source.md) + [Jaeger](jaeger-data-source.md) + [AWS X-Ray](x-ray-data-source.md) + [Zipkin](zipkin-data-source.md) ## 跟踪视图说明 本节介绍了跟踪视图控制面板的元素。 **标题** 跟踪视图的标题包含以下元素 + 标题：显示根跨度的名称和跟踪 ID。 + 搜索：突出显示包含搜索文本的跨度。 + 元数据：关于跟踪的各种元数据。 **缩微贴图** 显示精简视图或跟踪时间线。将鼠标指针拖到锁位贴图上方可缩小时间范围。缩放还会更新主时间线，所以容易看到较短的时间跨度。将鼠标悬停在缩微贴图上，缩放时将显示**重置选择**按钮，以重置缩放。 **跨度筛选条件** 使用跨度筛选条件，您可以在跟踪时间轴查看器中筛选跨度。添加的筛选条件越多，筛选的跨度就越具体。 您可以添加以下一个或多个筛选条件： + 资源服务名称 + 跨度名称 + Duration + 标签（包括标签、流程标签和日志字段） 要仅显示已匹配的跨度，请选择**仅显示匹配项**开关。 **时间表** 显示跟踪中的跨度列表。每个跨度行由以下组件组成： + 展开子项按钮：展开或折叠所选跨度的所有子跨度。 + 服务名称：记录跨度的服务的名称。 + 操作名称：跨度代表的操作名称。 + 跨度持续时间条：跟踪中操作持续时间的直观表示。 **跨度详细信息** 选择跨度行可显示跨度详细信息，包括以下内容。 + 操作名称 + 跨度元数据 + 标签：与此跨度关联的任何标签。 + 流程元数据：记录此跨度的进程的元数据。 + 日志：此跨度记录的日志列表和相关键值。如果是 Zipkin，则日志部分显示 Zipkin 注释。 **日志跟踪** 您可以从跟踪视图中的跨度直接导航到与该跨度相关的日志。这适用于 Tempo、Jaeger 和 Zipkin 数据来源。有关如何配置每个数据来源的说明，请参阅相关文档。 选择文档图标，在 Explore 中打开一个包含已配置数据来源的拆分视图，并查询该跨度的相关日志。 **跟踪指标** **注意** 此功能目前为测试版。 您可以从跟踪视图中的跨度直接导航到与该跨度相关的指标。此功能适用于 Tempo、Jaeger 和 Zipkin 数据来源。有关配置的详细信息，请参阅相关文档。 **跟踪配置文件** 使用跟踪配置文件，您可以通过添加跟踪和配置文件之间的链接功能，利用 Grafana 来关联不同的信号。 ## 节点图 您可以选择展开显示的跟踪的节点图。根据数据来源的不同，可以将跟踪的跨度显示为图中的节点，也可以添加一些额外的上下文，包括基于当前跟踪的服务图。 ## 服务图视图 服务图视图能够可视化跨度指标（速率、错误率和持续时间（RED）的跟踪数据）和服务图。设置要求后，此预配置的视图将立即可用。 有关更多信息，请参阅 [Tempo](tempo-data-source.md) 数据来源页面。您还可以在*服务图视图页面*中查看 [Grafana Labs Tempo 文档](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/)。 ## 数据 API 这种可视化需要从数据来源返回特定形状的数据，以便正确显示。 数据来源需要返回数据框并设置 `frame.meta.preferredVisualisationType = 'trace'`。 **数据帧结构** 必填字段： | 字段名称 | Type | 说明 | | --- | --- | --- | | traceID | 字符串 | 整个跟踪的标识符。数据帧中应只有一个跟踪。 | | spanID | 字符串 | 当前跨度的标识符。每条轨迹的跨度IDs 应该是唯一的。 | | parentSpanID | 字符串 | 父跨度的 SpanID，用于在跟踪视图中创建子跨度与父跨度的关系。对于没有父级的根跨度，可以是 undefined。 | | serviceName | 字符串 | 此跨度所属服务的名称。 | | serviceTags | TraceKeyValuePair[] | 与服务相关的标签列表。 | | startTime | 数字 | 跨度的开始时间（毫秒纪元时间）。 | | duration | 数字 | 跨度的持续时间（毫秒）。 | 可选字段： | 字段名称 | Type | 说明 | | --- | --- | --- | | logs | TraceLog[] | 与当前跨度关联的日志列表。 | | 标签 | TraceKeyValuePair[] | 与当前跨度关联的标签列表。 | | warnings | string[] | 与当前跨度关联的警告列表。 | | stackTraces | string[] | 与当前跨度关联的堆栈跟踪列表。 | | errorIconColor | 字符串 | 如果跨度标记为 error: true，则表示错误图标的颜色。 | 有关这些类型的详细信息 [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28)，请参阅[TraceKeyValuePair[TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12)](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4)和 GitHub。 # Explore 中的关联编辑器 **** 本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 关联允许用户在任意两个数据来源之间建立链接。有关更多信息，包括关联概述，请参阅 [Grafana 10 版本中的关联](v10-correlations.md)。 ## 创建关联 您可以从 Explore 页面创建关联。 **创建关联** 1. 在您的 Amazon Managed Grafana 工作区中，导航至 Explore 页面。 1. 选择要作为新关联来源的数据来源。 1. 运行查询，在支持的可视化中生成数据。 **注意** 支持的可视化为[日志](v10-panels-logs.md)和[表](v10-panels-table.md)。 1. 在顶部工具栏中选择 **\$1 添加**，然后选择**添加关联**（您也可以从[命令调色板](v10-search.md#v10-search-palette)中选择**关联编辑器**）。 Explore 现在处于关联编辑器模式，由蓝色边框和顶部栏指示。您可以在顶部栏中选择**退出**以退出关联编辑器。 1. 现在，您可以为可视化创建以下新的关联，其中包含附加到可用于构建新查询的数据的链接： + *日志*：链接显示在每个日志行的日志详细信息中的字段值旁。 + *表*：每个表单元格都是一个链接。 1. 选择链接以添加新的关联。链接与用作关联结果字段的字段相关联。有关更多详细信息，请参阅[关联配置](v10-correlations-config.md)。 1. 在打开的拆分视图中，使用右侧窗格设置关联的目标查询来源。有关更多详细信息，请参阅[目标查询](v10-correlations-config.md#v10-correlations-config-target-query)。 1. 使用[变量语法](v10-dash-variable-syntax.md)生成目标查询，可从窗格顶部提供的列表中选择变量。该列表包含选定数据行中的样本值。 1. 提供标签和描述（可选）。标签将用作可视化中链接的名称，可包含变量。 1. 提供转换（可选；详情见下文）。 1. 在顶部工具栏中选择**保存**，以保存关联并退出关联编辑器模式。用于创建关联的链接将被每行中的数据链接所取代。选择链接后，您定义的查询将在另一个窗格中运行，变量将动态替换为所选行中的值。 ## 转换 通过转换，可以提取字段中存在的值和其他数据。例如，通过转换，您可以提取日志行的一部分以用于关联。有关关联转换的更多信息，请参阅 [关联转换](v10-correlations-config.md#v10-correlations-config-transformations)。 在编辑器模式下选择一个生成的链接后，您可以在**转换**下拉菜单中选择**添加转换**来添加转换。 **在关联中使用转换** 1. 选择要应用转换的字段。选择要用于转换的字段。例如，日志行。一旦选中，此字段中的值可帮助您构建转换。 1. 选择转换的类型。有关选项和相关设置，请参阅 [关联转换](v10-correlations-config.md#v10-correlations-config-transformations)。 1. 根据您的选择，您可能会看到一个或多个变量填充，或者您可能需要在显示的选项中提供更多规范。 1. 选择**向关联添加转换**，将指定的变量添加到可用变量列表中。 **注意** 对于此对话框中的正则表达式，其他文档中引用的 `mapValue` 在此处称为 `Variable Name`。Grafana 会突出显示与字段值中的表达式匹配的任何文本。使用正则表达式捕获组来选择应提取的匹配部分。如果提供了有效的正则表达式，则变量和该变量的值将显示在 `Variable Name` 字段下方。 ## 关联示例 以下示例说明了如何使用 Explore 中的关联编辑器创建关联。如果要遵循这些示例，请确保设置[测试数据来源](testdata-data-source.md)。 ### 创建文本到图形的关联 此示例说明了如何使用 Explore 中的关联编辑器创建关联。 关联允许使用查询的结果在任何数据来源中运行新查询。在本例中，您将运行一个渲染表数据的查询。该数据将用于运行不同的查询，以生成图形结果。 要遵循此示例，请确保已设置[测试数据来源](testdata-data-source.md)。 **创建文本到图形的关联** 1. 在 Grafana 中，导航到 **Explore**。 1. 从页面左上角的下拉菜单中，选择**测试数据来源**。 1. 在右侧的下拉菜单中选择 **\$1 添加**，然后选择**添加关联**。 1. Explore 现在处于关联编辑器模式，由蓝色边框指示。 1. 从场景下拉菜单中选择以下场景：**CSV 文件**。 1. 选择文件 **population\$1by\$1state.csv**。每个单元格都是一个链接，单击后即可开始创建新的关联。 1. 单击 `State` 列中的任何单元格以创建新的关联，将数据链接附加到该条目。例如，选择 `California`。 1. 在拆分视图中，选择您在左侧窗格中选择的同一数据来源。查询编辑器上方的帮助程序包含可用于目标查询的所有可用变量。变量包含选定行中的所有数据字段（表列）。 1. 在**场景**菜单中，选择 **CSV 指标值**。查询编辑器中的 `String Input` 字段提供了具有每年人口值的变量：`${1980},${2000},${2020}`。这将使用变量值生成图形。 1. 在查询编辑器**别名**字段中，输入 `${State}`。 运行查询，查看其是否使用变量中的示例值生成图形。 1. 选择**保存**以保存关联并退出关联编辑器。 保存关联后，Explore 将在左侧窗格中重新运行查询。通过单击状态名称，将重新运行右侧的查询，并将该行的值插入 CSV，从而更改图形。每次单击状态名称时，都会使用更新的值重新运行查询。 您可以对任何数据来源应用相同的步骤。关联允许您在可视化中创建链接，以根据所选数据运行动态查询。在此示例中，我们使用查询返回的数据来构建新查询，以使用相同的数据来源生成不同的可视化效果。但您可以在任何数据来源之间创建关联，以创建自定义探索流程。 ### 创建日志到表的关联 在此示例中，您将创建关联，以演示如何使用转换从日志行和另一个字段中提取值。 要遵循此示例，请确保已设置[测试数据来源](testdata-data-source.md)。 **创建日志到表的关联** 1. 在 Grafana 中，导航到 **Explore**。 1. 从页面左上角的下拉菜单中，选择**测试数据来源**。 1. 在右侧的下拉菜单中选择 **\$1 添加**，然后选择**添加关联**。 1. Explore 现在处于关联编辑器模式，由蓝色边框指示。 1. 在**场景**菜单中，选择**日志**。 1. 展开日志行以查看关联链接。选择 `Correlate with hostname`。 1. Explore 将在拆分视图中打开。选择您在左侧窗格中选择的同一数据来源。查询编辑器上方的帮助程序包含可用于目标查询的所有可用变量。 1. 展开转换部分，然后单击**添加转换**。 1. 在**字段**下拉菜单中，选择**消息**。日志行显示为示例数据。 1. 在**类型**下，选择 **Logfmt**。这将填充变量列表。 1. 选择**向关联添加转换**。 1. 再次选择**添加转换**，然后在**字段**下选择**主机名**。 1. 在**类型**下，选择**正则表达式**。 1. 在**表达式**下，输入以下内容：`-([0-9]\*)`。这将选择破折号右侧的任何数字。 1. 在**变量名称**下，输入以下内容：`hostNumber`。这将填充变量列表。 1. 选择**向关联添加变换**，将其添加到其他变量中。 1. 在数据来源编辑器中，打开**场景**下拉菜单，然后选择 **CSV 内容**。 1. 在下面的文本框中，提供以下内容并保存关联： ``` time,msg,hostNumber,status ${time},${msg},${hostNumber},${status} ``` 这将关闭拆分视图并重新运行左侧查询。展开任何日志行以查看关联按钮。选择关联按钮将打开拆分视图，其中包含`time`（a 字段）、`msg`（使用 *logfmt* 从日志行中提取）、`host number`（使用*正则表达式*从 `hostname` 中提取）和 `status`（使用 *logfmt* 从日志行中提取）。 # Explore 中的检查器 **** 本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 检查器有助于您了解查询并进行问题排查。您可以检查原始数据，将该数据导出到逗号分隔值（CSV）文件，以 TXT 格式导出日志结果，并查看查询请求。 ## 检查器 UI 检查器包含以下选项卡： + **统计选项卡**：显示查询花费的时间和返回的数量。 + **查询选项卡**：显示 Grafana 查询数据来源时向服务器发送的请求。 + **JSON 选项卡**：允许查看和复制数据 JSON 和数据帧结构 JSON。 + **数据选项卡**：显示查询返回的原始数据。 + **错误选项卡**：显示错误。仅在查询返回错误时可见。 ## 检查器任务 您可以在 Explore 检查器中执行各种任务。 **打开检查器** 运行要检查的查询后，选择**检查器**按钮。 检查器面板在屏幕底部打开。 **检查原始查询结果** 您可以在表中查看原始查询结果，即查询返回的数据。 在**检查器**选项卡中，单击**数据**选项卡。 对于多个查询或多个节点的查询，还提供了其他选项。 + **显示数据帧**：选择要查看的结果集数据。 + **按时间连接的序列**：一次查看所有查询的原始数据，每列一个结果集。您可以单击列标题对数据进行排序。 **以 CSV 格式下载原始查询结果** Grafana 会在默认浏览器下载位置生成一个 CSV 文件。您可以在所选的查看器中打开该文件。 1. 在**检查器**选项卡中，按照上述说明获取原始查询结果。 1. 优化查询设置，直到可以看到要导出的原始数据。 1. 选择**下载 CSV**。 要下载专门针对 Excel 格式化的 CSV 文件，请展开**数据选项**，打开**下载 Excel** 开关，然后再选择**下载 CSV **选项。 **以 TXT 格式下载日志结果** 在**检查器**选项卡中选择**下载日志**，生成当前正在查看的日志的 TXT 文件。 **下载跟踪结果** 根据数据来源类型，Grafana 可以采用其中一种支持格式对跟踪结果生成 JSON 文件：Jaeger、Zipkin 或 OTLP 格式。 1. 打开检查器。 1. 检查日志查询结果。优化结果，直到看到要导出的原始日志。 1. 选择**下载日志**。 **检查查询性能** **统计**选项卡显示统计数据，告诉您查询需要多长时间、发送的查询数量以及返回的行数。此信息有助于您对查询进行问题排查，尤其是在任何数字意外偏高或偏低时。 统计数据以只读格式显示。 **查看 JSON 模型** 您可以浏览和导出数据以及数据帧 JSON 模型。 **查看 JSON 模型** 1. 在检查器面板中，单击 **JSON** 选项卡。 1. 在**选择来源**下拉列表中，选择以下选项之一： + **数据**：显示一个 JSON 对象，该对象表示返回到 Explore 的数据。 + **DataFrame 结构**-显示原始结果集。 1. 您可以展开或折叠 JSON 的某些部分以查看不同的部分。您也可以选择**复制到剪贴板**选项，来复制 JSON 正文并将其粘贴到其他应用程序中。 **查看对数据来源的原始请求和响应** 在使用 Explore 和检查器选项卡时，您可以查看通过查询生成的原始请求和响应数据。在检查器中，选择**查询**选项卡，然后选择**刷新**以查看原始数据。 Grafana 将查询发送到服务器并显示结果。您可以向下钻取查询的特定部分，展开或折叠所有部分，或者将数据复制到剪贴板以在其他应用程序中使用。