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

# 登录 Explore
<a name="v12-explore-logs"></a>

****  
本文档主题专为**支持** Grafana 版本 12.x 的 Grafana 工作空间而设计。  
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。  
对于支持 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 还可以将日志与其他遥测信号（如指标、跟踪或配置文件）关联起来。您还可以直接通过 “浏览” 向外部 URL 添加关联，从而实现数据源和外部系统之间的无缝导航。

日志可视化面板通过字段选择器组件改进了日志呈现，用于自定义显示哪些字段。Explore 中的 Loki 查询支持向前搜索，允许您按从最旧到最新的顺序搜索日志。

日志查询的结果显示为单独的日志行和显示选定时间段内日志量的图形。

## 日志卷
<a name="v12-explore-logs-volume"></a>

在处理支持全范围日志卷的数据来源时，Explore 会自动显示一个图形，其中显示所有输入日志查询的日志分布情况。 OpenSearch 和 Loki 数据源目前支持此功能。

**注意**  
在 Loki 中，这种全范围的日志卷通过指标查询来呈现，可能开销较大，具体取决于查询的时间范围。对于较小的 Loki 安装来说，处理这种查询尤其具有挑战性。为了缓解这种情况，您可以在 Loki 前面使用像 [nginx](https://www.nginx.com/) 这样的代理来为这些查询设置自定义超时（例如 10 秒）。可通过查找带有 HTTP 标头 `X-Query-Tags`（值为 `Source=logvolhist`）的查询来识别日志卷直方图查询；Grafana 会将这些标头添加到所有日志卷直方图查询中。

如果数据来源不支持加载全范围日志卷，则日志模型会通过对日志行进行计数，并根据自动计算的时间间隔将其整理到桶中来计算时间序列。第一个日志行的时间戳用于在结果中锚定日志卷的开始位置。时间序列的末尾锚定到时间选取器的 **To** 范围。这样，即使数据来源不提供全方位支持，您也能高效地分析和可视化日志数据。

## 日志
<a name="v12-explore-logs-overview"></a>

在以下各节中，您将找到有关如何在 Explore 中可视化单个日志并与之交互的详细说明。

## 日志导航
<a name="v12-explore-logs-navigation"></a>

日志导航位于日志行的右侧，可用于轻松请求更多日志。您可以单击导航底部的**旧日志**按钮完成此操作。当您达到行限制并希望查看更多日志时，这尤其有用。然后，从导航中运行的每个请求都会作为单独页面显示在导航中。每个页面都显示传入日志行的 `from` 和 `to` 时间戳。您可以通过单击每个页面来查看之前的结果。Explore 会缓存从日志导航中运行的最后五个请求，因此您在单击页面时不会重新运行相同的查询，从而节省时间和资源。

## 可视化选项
<a name="v12-explore-log-visualization-options"></a>

 您可以自定义日志的显示方式，并选择显示哪些列。


| 选项 | 描述 | 
| --- | --- | 
| 时间 | 显示或隐藏时间列。这是与数据来源报告的日志行关联的时间戳。 | 
| 唯一标签 | 显示或隐藏仅包含非常用标签的唯一标签列。上面显示了所有常用标签。 | 
| 换行 | 如果希望使用换行显示，请将其设置为 true。如果设置为 false，则会导致水平滚动。 | 
| 修饰 JSON |  将其设置为 true 可打印所有 JSON 日志。此设置不会影响 JSON 以外的任何格式的日志。 | 
| 重复数据删除 | 日志数据可能有很多重复，而 Explore 可以隐藏重复的日志行。您可以使用几种不同的重复数据删除算法。精确：除日期字段外，对整行进行精确匹配。数字：去除持续时间、IP 地址等数字后，在行上进行匹配。签名：最激进的重复数据删除方法，该方法会去除所有字母和数字，匹配剩余的空格和标点符号。 | 
| 显示结果顺序 | 您可以将接收日志的顺序从默认降序（最新的优先）改为升序（最早的优先）。 | 

## 下载日志行
<a name="v12-explore-download-log-lines"></a>

要下载 `txt` 或 `json` 格式的日志结果，请使用**下载**按钮。此功能允许保存日志数据以供进一步分析，或以方便且易于访问的格式与他人共享。

## 记录结果元信息
<a name="v12-explore-log-result-meta-information"></a>

在收到的日志行上方，您可以找到基本的元信息，包括：
+ **接收的日志数**：表示当前查询或时间范围内收到的日志总数。
+ **错误**：在日志结果中显示可能存在的错误。
+ **常用标签**：显示常用标签。
+ **处理的总字节数**：表示以字节为单位处理的日志数据的累积大小。

**注意**  
某些元信息的可用性可能取决于数据来源，因此，您可能只能看到特定数据来源的部分详细信息。

## 转义换行符
<a name="v12-explore-log-escaping-newlines"></a>

Explore 可自动检测日志行中的一些错误转义序列，如换行符（`\n`、`\r`）或制表符（`\t`）。当检测到此类序列时，Explore 会提供**转义换行符**选项。

**自动修复 Explore 检测到的错误转义序列**

1. 选择**转义换行符**来替换序列。

1. 手动检查替换项以确认其正确性。

Explore 将替换这些序列。替换时，选项将从**转义换行符**变为**删除转义**。评估变更，因为根据接收的输入，解析可能不准确。您可以选择**删除转义**来恢复替换项。

## 日志级别
<a name="v12-explore-log-level"></a>

对于指定了 `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 | \* | 

## 突出显示搜索的词
<a name="v12-explore-highlight-searched-words"></a>

当您的查询包含要搜索的特定词或表达式时，Explore 将在日志行中突出显示这些词或表达式，以便更好地查看。通过此突出显示功能，您可以更轻松地识别和关注日志中的相关内容。

**注意**  
突出显示搜索词的能力可能因数据来源而异。对于某些数据来源，可能无法突出显示搜索词。

## 日志详细信息
<a name="v12-explore-log-details-view"></a>

在 Explore 中，每条日志行都有一个名为*日志详细信息*的可扩展部分，可通过选择日志行将其打开。日志详细信息视图以附加到日志行的*字段*和*链接*的形式提供其他信息和探索选项，从而实现更强大的交互和分析。

**字段**

在日志详细信息视图中，您可以通过两种方式筛选显示的字段：正筛选条件（关注特定字段）和负筛选条件（排除特定字段）。这些筛选条件将更新生成日志行的相应查询，相应地添加等式和不等式表达式。如果数据源有支持（例如 Loki 和） OpenSearch，则日志详细信息将检查该字段是否已存在于当前查询中显示和活动状态（仅适用于正向筛选器），允许您将其关闭查询，或者将筛选表达式从正值更改为负值。

通过单击眼睛图标，您可以在日志列表中选择要可视化的字段子集，而不是完整的日志行。每个字段都有一个统计图标，以显示与所有显示的日志相关的统计信息。

**Links**

Grafana 提供了数据链接或关联的功能，使您能够将日志消息的任何部分转换为内部或外部链接。这些链接可用于导航到相关数据或外部资源，提供了一种无缝和方便的方式来探索进一步的信息。

## 日志上下文
<a name="v12-explore-log-context"></a>

日志上下文显示与特定搜索查询匹配的日志条目相关的附加上下文行。这有助于理解日志条目的上下文，类似于 `grep` 命令中的 `-C` 参数。

您可能会遇到长行文本，这使得难以阅读和分析每个日志条目相关的上下文。这就是**换行**开关派上用场的地方。启用此开关后，Grafana 将自动换行长行文本，使其适合查看器的可见宽度。这样可以更容易阅读和理解日志条目。

 **在拆分视图中打开**按钮允许您在 Explore 视图的分屏中对日志条目执行上下文查询。选择此按钮将打开一个新的 Explore 窗格，在日志条目旁边显示上下文查询，从而更容易分析和理解相关上下文。

也可以在新的浏览器选项卡中打开日志上下文查询，方法是在选择按钮以打开上下文模式的同时按 `Ctrl`（或 `Cmd`）键。在新选项卡中打开时，还会应用先前选择的筛选条件。

## 复制日志行
<a name="v12-explore-copy-log-line"></a>

通过选择**复制日志行**按钮，可将选定日志行的内容轻松复制到剪贴板。

## 将链接复制到日志行
<a name="v12-explore-copy-link-to-log-line"></a>

通过 Grafana 中的日志行链接，您可以快速导航到特定日志条目进行精确分析。选择日志行的**复制短链接**按钮后，您可以生成并复制一个短 URL，在绝对时间范围内直接访问确切的日志条目。打开链接后，Grafana 会自动滚动到相应的日志行，以蓝色背景突出显示，便于识别和关注相关信息。

**注意**  
只有 Loki 和其他提供 `id` 字段的数据来源支持此功能。