本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # Explore **** 本文档主题专为支持 **Grafana 8.x 版本**的 Grafana 工作区而设计。 有关支持 Grafana 版本 12.x 的 Grafana 工作空间，请参阅。[在 Grafana 版本 12 中工作](using-grafana-v12.md) 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。 在 Grafana 工作区中，控制面板 UI 提供了用于构建可视化控制面板的工具。*Explore* 会删除所有控制面板和面板选项，这样您就可以专注于查询。迭代直到查询正常运行，然后规划和构建控制面板。 对于基础设施监控和事件响应，您不再需要切换到其他工具来调试出现的问题。您可以使 Explore 更深入地挖掘您的指标和日志，找出原因。 Explore 使您无需创建控制面板即可更轻松地查看数据。如果您的数据来源支持图表和表数据，则 Explore 会以图表和表的形式显示结果。这可以帮助您同时查看数据趋势和更多详细信息。 ## 开始探索 **注意** 默认情况下，具有“查看者”角色的用户无法编辑，也无权访问 Explore。 左侧菜单上的 **Explore** 图标会打开一个空的 Explore 选项卡。 要从面板中的现有查询开始，请从**面板**菜单中选择 **Explore** 选项。这将打开 Explore 选项卡，其中包含来自面板的查询。然后，您可以在控制面板之外调整或迭代查询。 从左上角的下拉列表中选择您的数据来源。Prometheus 有一个自定义的 Explore 实现。其他数据来源使用其标准查询编辑器。 在查询字段中，您可以编写查询并探索数据。查询字段旁边有三个按钮：清除按钮（X）、添加查询按钮（\+）和删除查询按钮（-）。与普通查询编辑器一样，您可以添加和移除多个查询。 ## 拆分和比较 拆分视图功能是一种并排比较图表和表，或者在一个页面上同时查看相关数据的方法。选择**拆分**可复制当前查询，并将页面拆分为两个并排查询。您可以选择为新查询选择不同的数据来源。这使您有机会比较两个不同服务器的相同查询，或者将过渡环境与生产环境进行比较。 在拆分视图中，通过选择附在时间选择器上的时间同步按钮之一，可以链接两个面板的时间选择器（如果您更改其中一个时间选择器，另一个也会更改）。链接时间选择器有助于保持拆分视图查询的开始和结束时间同步，这样您就可以在两个拆分面板中查看相同的时间间隔。 您可以通过选择**关闭拆分**来关闭新创建的查询。 ## 共享缩短的链接 使用**共享缩短的链接**功能创建更小、更简单的 URL，格式为 `/goto/:uid`，而不是共享包含复杂查询参数的较长 URL。您可以通过在 Explore 工具栏中选择**共享**选项来创建缩短的链接。任何从未使用过的缩短的链接都会在 7 天后自动删除。 ## 查询历史记录 查询历史记录是您在 Explore 中使用的查询列表。历史记录是浏览器的本地记录，不会共享。要打开历史记录并与之交互，请在 Explore 中选择**查询历史记录**。 ### 查看查询历史记录 在查询历史记录中，您可以执行以下操作： + 运行查询。 + 创建或编辑注释。 + 将查询复制到剪贴板。 + 将包含查询的短链接复制到剪贴板。 + 将查询标上星号 ### 管理收藏的查询 “查询历史记录”选项卡中所有标有星号的查询都会显示在“已加星标”选项卡上。您可以更快地访问自己喜欢的查询并重复使用这些查询，而无需从中重新键入它们。 ### 对查询历史记录进行排序 默认情况下，查询历史记录会显示最新的查询。您可以按日期或数据来源名称以升序或降序对历史记录排序。 在查询历史记录右侧的下拉列表中，选择以下选项之一：字段。 + 最新的优先 + 最早的优先 + 数据源 A-Z + 数据源 Z-A **注意** 如果您位于拆分视图中，则排序模式仅适用于活动面板。 ### 筛选查询历史记录 在**查询历史记录**和**已加星标**选项卡上，您可以按数据来源名称筛选查询历史记录。 1. 选择**筛选特定数据来源的查询**。 1. 选择想要用于筛选历史记录的数据来源。您也可以选择多个数据来源。 在**查询历史记录**选项卡上，您可以使用垂直滑块按日期筛选查询： + 拖动下方的句柄可调整开始日期。 + 拖动上方的句柄可调整结束日期。 **注意** 如果您在拆分视图中，则筛选器仅适用于活动面板。 ### 在查询历史记录中搜索 您可以在历史记录中跨查询和评论进行搜索 可以在**查询历史记录**和**已加星标**选项卡中对查询进行搜索。 1. 选择**搜索查询**字段。 1. 在搜索框中，输入您的搜索词。 ### 查询历史记录设置 您可以在**设置**选项卡中自定义查询历史记录。下表列出了可用的选项。 | 设置 | 默认 值 | | --- | --- | | 指定 Grafana 将保存您的查询历史记录的时长。 | 1 周 | | 更改默认的活动选项卡。 | “查询历史记录”选项卡 | | 仅显示对当前在 Explore 中处于活动状态的数据来源的查询。 | True | | 清除查询历史记录。 | （选择清除查询历史记录可永久删除所有已存储的查询。） | **注意** 查询历史记录设置是全局型的，在拆分模式下应用于两个面板。 ## Prometheus-specific features Explore 功能的第一个版本提供了 Prometheus 的自定义查询体验。当您运行查询时，Grafana 实际上会运行两个查询：对图表的普通 Prometheus 查询和对表的即时查询。即时查询会返回每个时间序列的最后一个值，简要概括了图形中所示的数据。 ### Metrics explorer 在查询字段的左侧，选择**指标**以打开 Metric Explorer。这将显示一个分层菜单，其中包含按前缀分组的指标。例如，所有 Alertmanager 指标都分组在 `alertmanager` 前缀下。如果要探索哪些指标可用，这是一个不错的起点。 ### “查询”字段 “查询”字段支持指标名称和函数的自动完成，类似于标准的 Prometheus 查询编辑器的工作方式。按 **Enter** 运行查询。 按 **Ctrl \+ 空格键**可以访问“自动完成”菜单。自动完成菜单包含一个新的“历史记录”部分，其中列出了最近运行的查询。 建议可以显示在“查询”字段下。选择一个建议，使用建议的更改更新您的查询。 + 对于计数器（单调递增指标），建议使用 rate 函数。 + 对于存储桶，建议使用直方图函数。 + 对于记录规则，可将其展开。 ### 表筛选器 在表面板的**标签**列中选择**筛选器**按钮，向查询表达式添加筛选器。您也可以为多个查询添加筛选器。将为所有查询添加筛选器。 ## 日志集成 您还可以使用 Explore 来调查包含以下数据来源的日志： + InfluxDB + Elasticsearch ### 日志可视化 日志查询的结果在图形中以直方图的形式显示，各个日志显示在下面。如果数据来源未发送请求的时间范围内的直方图数据，则日志模型将根据按自动计算的时间间隔进行分桶的日志行计数来计算时间序列。然后，直方图的开头由结果中第一行日志的时间戳锚定。时间序列的末尾锚定到时间选取器的 **To** 范围。 #### 日志级别 对于指定了**级别**标签的日志，Grafana 会使用标签值来确定日志级别，并相应地更新颜色。如果日志没有指定级别标签，Grafana 会解析日志以确定其内容是否与任何支持的表达式匹配。日志级别始终由第一个匹配项决定。如果 Grafana 无法确定日志级别，则会使用**未知的**日志级别对其可视化。下表列出了日志级别以及日志级别缩写和表达式的映射。 | 支持的表达式 | 日志级别 | 颜色 | | --- | --- | --- | | 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 | | \* | unknown | grey | ### 可视化选项 您可以自定义日志的显示方式，并选择显示哪些列。 #### 时间 此选项显示或隐藏时间列。这是与数据来源报告的日志行关联的时间戳。 #### 唯一标签 该选项显示或隐藏唯一标签列，其中仅包含非常用标签。上面显示了所有常用标签。 #### 换行 要在显示中使用换行，请将其设置为 **True**。将此选项设置为 **False** 会导致水平滚动。 #### 删除重复数据 日志数据的重复程度可能很高。Explore 可以通过隐藏重复的日志行来帮助解决这个问题。您可以从不同的重复数据删除算法中进行选择： + **精确**：除日期字段外，对整行进行精确匹配。 + **数字**：去除持续时间、IP 地址等数字后，在行上进行匹配。 + **签名**：最激进的重复数据删除，它会删除所有字母和数字。已对剩余的空格和标点符号进行匹配。 #### 翻转结果顺序 您可以将接收日志的顺序从默认降序（最新的优先）改为升序（最早的优先）。 ### 标签和检测到的字段 每个日志行都有一个可扩展区域，其中带有标签和检测到的字段，以实现更可靠的交互。对于所有标签，您可以对选定标签进行筛选（正向筛选）和筛除（反向筛选）操作。每个字段或标签还有一个统计图标，以显示与所有显示的日志相关的一次性统计信息。 ### 切换检测到的字段 如果您的日志采用 JSON 或 logfmt 结构，则可以显示或隐藏检测到的字段。展开日志行，然后选择眼睛图标以显示或隐藏字段。 {{< docs-imagebox img=”/img/docs/explore/parsed-fields-7-2.gif “max-width= “800px” caption= “在 Explore 中切换检测到的字段” >}} ## 跟踪集成 您可以在 Explore 中可视化来自追踪数据来源的跟踪。目前支持的数据来源： + [连接到 Jaeger 数据来源](jaeger-data-source.md) + [连接到 Tempo 数据来源](tempo-data-source.md) + [Connect 连接到 AWS X-Ray 数据源](x-ray-data-source.md) + [连接到 Zipkin 数据来源](zipkin-data-source.md) 有关使用查询编辑器的信息，请参阅特定数据来源的文档。 ### 标题 该标头包含以下项目： + 标头标题，显示根跨度的名称和跟踪 ID + 搜索，它会突出显示包含搜索文本的跨度 + 有关跟踪的元数据 ### 缩微贴图 缩微贴图显示精简视图或跟踪时间轴。将鼠标拖到缩微贴图上方可缩小时间范围。缩放还会更新主时间轴，所以容易看到较短的时间跨度。如果将光标悬停在缩微贴图上，当缩放时，您可以看到**重置选择**按钮，它会重置缩放。 ### 时间轴 时间轴显示了跟踪内的跨度列表。每个跨度行包括以下组成部分： + **展开子项**按钮：展开或折叠所选跨度的所有子跨度 + 服务名称：记录跨度的服务的名称 + 操作名称：此跨度所代表的操作的名称 + 跨度持续时间条：跟踪中操作持续时间的直观表示。 选择跨度行上的任意位置即可显示跨度详细信息。 ### 跨度详细信息 跨度详细信息包含以下项： + 操作名称 + 跨度元数据 + 标签（与此跨度关联的任何标签） + 流程元数据（有关记录此跨度的进程的元数据） + 日志：此跨度记录的日志列表和相关键值。如果是 Zipkin，则日志部分显示 Zipkin 注释。 ## 在 Explore 和控制面板之间导航 为了帮助加快涉及定期从 Explore 切换到控制面板的工作流程，反之亦然，我们增加了从面板下拉列表导航到 Explore 后返回到原始控制面板的功能。 导航到 Explore 后，您应该会注意到 Explore 工具栏上有一个“后退”按钮。 只需选择该按钮即可返回到原始控制面板，或者，如果您想将在 Explore 中所做的更改带回控制面板，只需选择按钮旁边的箭头即可显示“带着更改返回到面板”菜单项。 ## 查询检查器 为了帮助调试查询，Explore 允许您通过查询检查器调查查询请求和响应以及查询统计信息。此功能类似于面板检查器的**统计**选项卡和**查询**选项卡。有关更多信息，请参阅[检查查询性能](inspect-a-panel.md#inspect-query-performance)和[查看对数据来源的原始请求和响应](inspect-a-panel.md#view-raw-request-and-response-to-data-source)。