本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Grafana 9 中的 Explore
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
Grafana 的控制面板 UI 提供了构建可视化控制面板的功能。*Explore* 去掉了控制面板和面板选项，以便您专注于查询。这有助于您进行迭代，直到得到有效的查询，然后您可以根据查询构建控制面板。
**注意**
如果您只想浏览数据，而不想创建控制面板，Explore 可以让该操作变得更加容易。如果数据来源支持图形和表数据，Explore 会以图形和表的形式显示结果。这样，您就可以同时查看数据趋势和更多详细信息。
## 开始探索
**注意**
要访问 Explore，您必须具有编辑者或管理员角色。
**访问 Explore**
1. 在 Grafana 工作区中，从左侧菜单栏中选择 Explore 菜单项。
这将打开一个空的 Explore 选项卡。
或者，要从面板中的现有查询开始，请从“面板”菜单中选择 Explore 选项。这将打开 Explore 选项卡，其中包含来自面板的查询，并让您可以在控制面板之外调整或迭代查询。
1. 从左上角的下拉列表中选择数据来源。[Prometheus](prometheus-data-source.md) 具有自定义的 Explore 实现，其他数据来源使用其标准查询编辑器。
1. 在查询字段中，编写查询以浏览数据。查询字段旁边有三个按钮：清除按钮（X）、添加查询按钮（\$1）和删除查询按钮（-）。与普通查询编辑器一样，您可以添加和删除多个查询。
有关查询的详细信息，请参阅 [查询和转换数据](v9-panels-query-xform.md)。
## 拆分和比较
拆分视图提供了一种简单的方法来比较图表和表格， side-by-side或者在一个页面上一起查看相关数据。
**顶部打开拆分视图**
1. 在 “浏览” 视图中，选择 “**拆分**” 按钮以复制当前查询，并将页面拆分为两个 side-by-side查询。
**注意**
可以为新查询选择其他数据来源，例如，比较两个不同服务器的同一查询，或比较暂存环境和生产环境。
在拆分视图中，选择附加到其中一个时间选取器的时间同步按钮，可以链接两个面板的时间选取器（如果更改一个，另一个也会更改）。链接时间选取器可使拆分视图查询的开始和结束时间保持同步。这样可确保您在两个拆分面板中看到相同的时间间隔。
1. 要关闭新创建的查询，请单击“关闭拆分”按钮。
## 共享短链接
共享缩短链接功能允许您创建更小、更简单 URLs的 /goto/:uid 格式，而不必在查询参数中使用更长的时间。 URLs 要创建指向查询结果的短链接，请在 Explore 工具栏中选择**共享**选项。从未使用过的短链接将在七（7）天后自动删除。
# Explore 中的查询管理
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
为了帮助调试查询，Explore 允许您通过查询检查器调查查询请求和响应以及查询统计信息。此功能类似于面板检查器任务[检查查询性能](v9-panels-panel-inspector.md#v9-panels-query-performance)和[检查查询请求和响应数据](v9-panels-panel-inspector.md#v9-panels-query-request-response)。
## 查询历史记录
查询历史记录是您在 Explore 中使用的查询列表。历史记录存储在 Grafana 数据库中，不与其他用户共享。历史查询的保留期为两周。超过两周的查询会被自动删除。要打开历史记录并与之交互，请在 Explore 中选择**查询历史记录**按钮。
**注意**
带星号（收藏）的查询不受两周保留期的限制，也不会被删除。
**查看查询历史记录**
您可以通过“查询历史记录”查看查询历史记录。对于每个单独的查询，您可以：
+ 运行查询。
+ 创建 and/or 编辑评论。
+ 将查询复制到剪贴板。
+ 将包含查询的短链接复制到剪贴板。
+ 为查询加上星号（收藏）。
**管理收藏的查询**
“查询历史记录”选项卡中所有标有星号的查询都会显示在“已加星标”列表中。这让您可以快速访问收藏的查询，且无需从头开始键入，即可重用这些查询。
**对查询历史记录排序**
默认情况下，查询历史记录会显示最新的查询。您可以按日期或数据来源名称以升序或降序对历史记录排序。
**对查询历史记录排序**
1. 选择**查询排序依据**字段。
1. 选择下列选项之一：
+ 最新的优先
+ 最早的优先
**筛选查询历史记录**
您可以在“查询历史记录”和“已加星标”选项卡中将查询历史记录筛选到特定的数据来源。
**将历史记录筛选到数据来源**
1. 选择**筛选特定数据来源查询**字段。
1. 选择要为其筛选历史记录的数据来源。您也可以选择多个数据来源。
在**查询历史记录**选项卡中，还可以使用滑块按日期筛选查询：
+ 使用垂直滑块按日期筛选查询。
+ 拖动顶部手柄调整开始日期。
+ 拖动顶部手柄调整结束日期。
**在查询历史记录中搜索**
您可以在历史记录中跨查询和评论进行搜索 在“查询历史记录”选项卡和“已加星标”选项卡中搜索查询。
**在查询历史记录中搜索**
1. 选择**搜索查询**字段。
1. 在搜索字段中输入您要搜索的术语。
**查询历史记录设置**
您可以在“设置”选项卡中自定义查询历史记录。下表描述了选项。
| 设置 | 默认 值 |
| --- | --- |
| 更改默认的活动选项卡 | “查询历史记录”选项卡 |
**注意**
查询历史记录设置是全局型的，在拆分模式下应用于两个面板。
## Prometheus 特定的功能
Explore 提供了适用于 Prometheus 的自定义查询体验。运行查询时，实际上会运行两个查询，一个是针对图形的普通 Prometheus 查询，一个是针对表的*即时查询*。即时查询会返回每个时间序列的最后一个值，简要概括了图形中所示的数据。
**Metrics explorer**
在查询字段的左侧，选择**指标**以打开 Metric Explorer。这将显示一个分层菜单，其中包含按前缀分组的指标。例如，所有 Alertmanager 指标都分组在 `alertmanager` 前缀下。如果您只想了解哪些指标可用，这是一个不错的切入点。
**查询字段**
“查询”字段支持指标名称和函数的自动完成，类似于标准的 Prometheus 查询编辑器。您可以按 Enter 键创建新行，然后按 Shift\$1Enter 键运行查询。
按 Ctrl\$1Space 键可以触发自动完成菜单。自动完成菜单包含一个新的“历史记录”部分，其中列出了最近运行的查询。
查询字段下方可能会显示建议，选择这些建议即可根据建议的更改更新查询。
+ 对于计数器（单调递增指标），建议使用 rate 函数。
+ 对于存储桶，将建议使用直方图函数。
+ 对于记录规则，可将其展开。
**表筛选器**
选择表面板**标签**列中的筛选器按钮，将筛选器添加到查询表达式。您也可以为多个查询添加筛选条件，系统会为所有查询添加筛选条件。
# 登录 Explore
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
除了指标外，Explore 还允许您调查以下数据来源中的日志：
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)
在基础设施监控和事件响应期间，您可以深入挖掘指标和日志，找出原因。Explore 还允许您通过查看指标和日志来关联它们。 side-by-side这将创建一个新的调试工作流。
1. 收到警报。
1. 向下钻取和检查指标。
1. 再次向下钻取，并搜索与指标和时间间隔相关的日志（以及将来的分布式跟踪）。
## 日志可视化
日志查询的结果在图形中以直方图的形式显示，以下各节将对各个日志进行说明。
如果数据来源支持全范围日志卷直方图，则会自动显示所有输入日志查询的日志分布图。 OpenSearch 和 Loki 数据源目前支持此功能。
**注意**
在 Loki 中，这种全范围的日志卷直方图通过指标查询来呈现，可能开销较大，具体取决于查询的时间范围。对于较小的 Loki 安装来说，处理这种查询尤其具有挑战性。为了缓解这种情况，我们建议在 Loki 前面使用像 [nginx](https://www.nginx.com/) 这样的代理来为这些查询设置自定义超时（例如 10 秒）。可通过查找带有 HTTP 标头 `X-Query-Tags`（值为 `Source=logvolhist`）的查询来识别日志卷直方图查询；Grafana 会将这些标头添加到所有日志卷直方图查询中。
如果数据来源不支持加载全范围日志卷直方图，则日志模型将根据按自动计算的时间间隔存储的日志行计数来计算时间序列，然后第一个日志行的时间戳会从结果中锚定直方图的开始时间。时间序列的末尾锚定到时间选取器的 **To** 范围。
**日志级别**
对于指定了级别标签的日志，Grafana 会使用标签值来确定日志级别，并相应地更新颜色。如果日志未指定级别标签，则会尝试查明其内容是否与任何受支持的表达式匹配（有关更多信息，请参阅下文）。日志级别始终由第一个匹配项决定。如果 Grafana 无法确定日志级别，则会使用未知的日志级别对其可视化。
**提示**
如果使用 Loki 数据来源，且 `level` 位于日志行中，请使用解析程序（JSON、logfmt、regex,..）将级别信息提取到用于确定日志级别的级别标签中。这允许直方图在单独的条形图中显示不同的日志级别。
**支持的日志级别以及日志级别缩写和表达式的映射：**
| 支持的表达式 | 日志级别 | 颜色 |
| --- | --- | --- |
| emerg | critical | purple |
| fatal | critical | purple |
| 警报 | critical | purple |
| crit | critical | purple |
| critical | critical | purple |
| err | error | red |
| eror | error | red |
| error | error | red |
| warn | warning | yellow |
| warning | warning | yellow |
| info | info | green |
| 信息 | info | green |
| NOTICE | info | green |
| dbug | debug | blue |
| debug | debug | blue |
| trace | trace | light blue |
| \$1 | unknown | grey |
## 日志导航
可使用日志行旁边的日志导航界面请求更多日志。您可以选择导航底部的**旧日志**按钮完成此操作。当达到行数限制并希望查看更多日志时，可通过此方式获取更多日志。每个请求都作为单独的页面显示在导航中。每个页面都显示传入日志行的起始和结束时间戳。您可以单击要查看的页面来查看之前的结果。Explore 会缓存从日志导航中运行的最后五个请求，因此在单击这些页面时不会重新运行相同的查询。
## 可视化选项
您可以自定义日志的显示方式，并选择显示哪些列。
**时间**
显示或隐藏时间列。这是与数据来源报告的日志行关联的时间戳。
**唯一标签**
显示或隐藏仅包含非常用标签的唯一标签列。上面显示了所有常用标签。
**换行**
如果希望使用换行显示，请将其设置为 True。如果设置为 False，则会导致水平滚动。
**修饰 JSON**
将其设置为 `true` 可打印所有 JSON 日志。此设置不会影响 JSON 以外的任何格式的日志。
**重复数据删除**
日志数据可能有很多重复，而 Explore 可以隐藏重复的日志行。您可以使用几种不同的重复数据删除算法：
+ **精确**：除日期字段外，对整行进行精确匹配。
+ **数字**：去除持续时间、IP 地址等数字后，在行上匹配。
+ **签名**：最激进的重复数据删除方法，该方法会去除所有字母和数字，匹配剩余的空格和标点符号。
**翻转结果顺序**
您可以将接收日志的顺序从默认降序（最新的优先）改为升序（最早的优先）。
**标签和检测到的字段**
每个日志行都有一个可扩展区域，其中带有标签和检测到的字段，以实现更可靠的交互。对于所有标签，我们添加了筛选（正向筛选）和筛除（反向筛选）选定标签的功能。每个字段或标签还有一个统计图标，以显示与所有显示的日志相关的统计信息。
**转义换行符**
Explore 可自动检测日志行中的一些错误转义序列，如换行符（`\n`、`\r`）或制表符（`\t`）。当检测到此类序列时，Explore 会提供“转义换行符”选项。
Explore 可自动修复检测到的错误转义序列
**自动修复转义序列**
1. 选择**转义换行符**来替换序列。
1. 手动检查替换项以确认其正确性。
Explore 将替换这些序列。替换时，选项将从**转义换行符**变为**删除转义**。评估变更，因为根据接收的输入，解析可能不准确。您可以选择**删除转义**来恢复替换项。
**数据链接**
通过数据链接，您可以将日志消息的任何部分转换为内部或外部链接。创建的链接在**日志详细信息**视图的**链接**部分以按钮的形式显示。
**切换字段可见性**
展开日志行，单击眼睛图标以显示或隐藏字段。
## Loki 特定的功能
Loki 是 Grafana Labs 的开源日志聚合系统。Loki 的设计符合成本效益，因为其并不索引日志内容，而是为每个日志流创建一组标签。Loki 的日志查询方式与 Prometheus 中的标签选择器的查询方式类似。该方式使用标签对日志流分组，以便与 Prometheus 标签匹配。有关 Grafana Loki 的更多信息，请查看 [Grafana Loki](https://github.com/grafana/loki) Github。
有关如何查询日志数据的更多信息，请参阅 [Loki](using-loki-in-AMG.md)。
**从指标切换到日志**
如果从 Prometheus 查询切换到日志查询（可以先进行拆分，以并排显示指标和日志），则会保留日志中存在的查询标签，并使用这些标签来查询日志流。例如，如果进行以下 Prometheus 查询：
```
grafana_alerting_active_alerts{job="grafana"}
```
切换到日志数据来源后，将会变为：
```
{job="grafana"}
```
这将返回所选时间范围内可搜索的日志块。
## 日志示例
如果所选数据来源实现了日志示例，同时支持日志和指标查询，那么对于指标查询，您将能够自动查看有助于可视化指标的日志行示例。Loki 数据来源目前支持此功能。
**实时跟踪**
使用实时跟踪功能查看受支持数据来源的实时日志。
选择 Explore 工具栏中的**实时**按钮以切换到实时跟踪视图。
在实时跟踪视图中，新日志将出现在屏幕底部，并具有渐变的对比背景，以便您跟踪新增内容。选择**暂停**按钮或滚动日志视图可暂停实时跟踪，不间断地浏览之前的日志。选择**恢复**按钮以恢复实时跟踪，或选择**停止**按钮以退出实时跟踪并返回标准 Explore 视图。
# Explore 中的跟踪
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
您可以通过 Explore 可视化来自数据来源的跟踪。
支持以下数据来源。
+ [Jaeger](jaeger-data-source.md)
+ [Tempo](tempo-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)
有关如何为上述数据来源配置查询的信息，请参阅特定数据来源的文档。
## 跟踪视图说明
本节介绍了跟踪视图控制面板的元素。
**标题**
跟踪视图的标题包含以下元素
+ 标题：显示根跨度的名称和跟踪 ID。
+ 搜索：突出显示包含搜索文本的跨度。
+ 元数据：关于跟踪的各种元数据。
**缩微贴图**
显示精简视图或跟踪时间线。将鼠标指针拖到锁位贴图上方可缩小时间范围。缩放还会更新主时间线，所以容易看到较短的时间跨度。将鼠标悬停在缩微贴图上，缩放时将显示重置选择按钮，以重置缩放。
**时间表**
显示跟踪中的跨度列表。每个跨度行由以下组件组成：
+ 展开子按钮：展开或折叠所选跨度的所有子跨度。
+ 服务名称：记录跨度的服务名称。
+ 操作名称：跨度代表的操作名称。
+ 跨度持续时间条：跟踪中操作持续时间的直观表示。
**跨度详细信息**
单击跨度行上的任意位置可显示跨度详细信息，包括以下内容。
+ 操作名称
+ 跨度元数据
+ 标签：与此跨度关联的任何标签。
+ 流程元数据：记录此跨度的进程的元数据。
+ 日志：此跨度记录的日志列表和相关键值。如果是 Zipkin，则日志部分显示 Zipkin 注释。
**节点图**
您可以选择展开显示的跟踪的节点图。根据数据来源的不同，可以将跟踪的跨度显示为图中的节点，也可以添加一些额外的上下文，包括基于当前跟踪的服务图。
**日志跟踪**
您可以从跟踪视图中的跨度直接导航到与该跨度相关的日志。这适用于 Tempo、Jaeger 和 Zipkin 数据来源。有关如何配置每个数据来源的说明，请参阅相关文档。
单击文档图标，在 Explore 中打开一个包含已配置数据来源的拆分视图，并查询该跨度的相关日志。
## 服务图视图
服务图视图能够可视化跨度指标（速率、错误率和持续时间（RED）的跟踪数据）和服务图。设置要求后，此预配置的视图将立即可用。
有关更多信息，请参阅 [Tempo](tempo-data-source.md) 数据来源页面。您还可以在 *Tempo 文档*中查看[服务图视图页面](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/)。
# Explore 中的检查器
****
本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。
检查器有助于您了解查询并进行问题排查。您可以检查原始数据，将该数据导出到逗号分隔值（CSV）文件，以 TXT 格式导出日志结果，并查看查询请求。
## 检查器 UI
检查器包含以下选项卡：
+ **统计选项卡**：显示查询花费的时间和返回的数量。
+ **查询选项卡**：显示 Grafana 查询数据来源时向服务器发送的请求。
+ **JSON 选项卡**：允许查看和复制数据 JSON 和数据帧结构 JSON。
+ **数据选项卡**：显示查询返回的原始数据。
+ **错误选项卡**：显示错误。仅在查询返回错误时可见。
## 检查器任务
您可以在 Explore 检查器中执行各种任务。
**打开检查器**
运行要检查的查询后，选择**检查器**按钮。
检查器面板在屏幕底部打开。
*检查原始查询结果*
您可以在表中查看原始查询结果，即查询返回的数据。
在**检查器**选项卡中，单击**数据**选项卡。
对于多个查询或多个节点的查询，还提供了其他选项。
+ **显示数据帧**：选择要查看的结果集数据。
+ **按时间连接的序列**：一次查看所有查询的原始数据，每列一个结果集。您可以单击列标题对数据进行排序。
**以 CSV 格式下载原始查询结果**
查看原始查询结果后，可以生成结果的 CSV 文件。您将得到一个 CSV 文件，其中包含您看到的结果，因此在生成 CSV 文件之前，请务必优化结果，以获得所需的结果。
要生成 CSV 文件，请在**检查器**选项卡中选择**下载 CSV**。
要下载专门针对 Excel 格式化的 CSV 文件，请展开**数据选项**，打开**下载 Excel** 开关，然后再选择**下载 CSV **选项。
*以 TXT 格式下载日志结果*
在**检查器**选项卡中选择**下载日志**，生成当前正在查看的日志的 TXT 文件。
**下载跟踪结果**
根据数据来源类型，Grafana 可以采用其中一种支持格式对跟踪结果生成 JSON 文件：Jaeger、Zipkin 或 OTLP 格式。
要下载跟踪，请在**检查器**选项卡上选择**下载跟踪**。
**检查查询性能**
**统计**选项卡显示统计数据，告诉您查询需要多长时间、发送的查询数量以及返回的行数。此信息有助于您对查询进行问题排查，尤其是在任何数字意外偏高或偏低时。
统计数据为只读。
**查看 JSON 模型**
您可以浏览和导出数据以及数据帧 JSON 模型。
**查看 JSON 模型**
1. 在检查器面板中，单击 **JSON** 选项卡。
1. 在**选择来源**下拉列表中，选择以下选项之一：
+ **数据**：显示一个 JSON 对象，该对象表示返回到 Explore 的数据。
+ **DataFrame 结构**-显示原始结果集。
1. 您可以展开或折叠 JSON 的某些部分以查看不同的部分。您也可以选择**复制到剪贴板**选项，来复制 JSON 正文并将其粘贴到其他应用程序中。
**查看对数据来源的原始请求和响应**
在使用 Explore 和检查器选项卡时，您可以查看通过查询生成的原始请求和响应数据。在检查器中，选择**查询**选项卡，然后选择**刷新**以查看原始数据。
Grafana 将查询发送到服务器并显示结果。您可以向下钻取查询的特定部分，展开或折叠所有部分，或者将数据复制到剪贴板以在其他应用程序中使用。