此页面由 Cloud Translation API 翻译。

使用日志浏览器查看日志

本文档简要介绍了 Google Cloud 控制台，可用于检索、查看和分析日志条目存储在日志存储分区中的数据。查看和分析单个日志条目一系列日志条目帮助您排查问题。您还可以使用 Logging API 和 Google Cloud CLI。

要对日志条目执行汇总操作，例如统计包含特定模式的日志条目，请升级日志存储桶以使用 Log Analytics，然后通过 Log Analytics 运行查询页面您可以继续使用 Logs Explorer（用于查看日志存储分区中的日志）已升级为使用 Log Analytics 的服务。如需了解详情，请参阅 Log Analytics 概览。

准备工作

如需获取查看日志条目所需的权限，请让管理员向您授予以下 IAM 角色：

如需查看 _Required 存储桶中的日志条目以及 _Default 存储桶的 _Default 视图中的日志条目，请执行以下操作：日志查看器 (roles/logging.viewer) 项目级别
如需查看 _Required 和 _Default 存储分区中的日志条目，请执行以下操作：私密日志查看者 (roles/logging.privateLogViewer) 项目级别
如需查看存储在日志存储桶的日志视图中的日志条目，请执行以下操作：日志查看访问器 (roles/logging.viewAccessor) 对包含用户定义的存储桶的项目拥有权限。如需了解如何获取对特定日志视图的访问权限，请参阅控制对日志视图的访问权限。
如需查看存储桶中受限的 LogEntry 字段，请执行以下操作：日志字段访问器 (roles/logging.fieldAccessor) 项目级别如需了解详情，请参阅配置字段级访问权限。

如需详细了解如何授予角色，请参阅管理访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

开始使用

要开始使用日志浏览器，请执行以下操作：

在 Google Cloud 控制台中，转到 Logs Explorer 页面。
前往 Logs Explorer

如果您使用搜索栏查找此页面，请选择子标题为 Logging 的结果。
选择相应的 Google Cloud 项目、文件夹或组织。

如果您使用 Amazon Web Services Elastic Compute Cloud (AWS EC2)，那么您的日志条目位于 AWS 连接器项目，用于将 AWS 账号关联到 Google Cloud 服务。

日志浏览器界面

通过日志浏览器界面，您可以显示日志条目，以及解析和分析并指定查询参数。

Logs Explorer 的界面。

日志浏览器包含以下部分，这些部分详细介绍了此页面：

操作工具栏
Query 窗格
结果工具栏
日志字段窗格
直方图
查询结果窗格

操作工具栏

使用操作工具栏功能，您可以执行以下操作：

优化范围：配置要从哪些日志条目中提取日志存储分区以供显示。您编写的查询会对提取的日志条目。如需了解详情，请参阅优化范围。
学习：查看相关文档和主题的链接。
分享链接：创建简短查询的网址，并将其复制到剪贴板，以便更轻松地共享查询。复制的网址有对应的绝对时间范围，该绝对时间范围由时间范围例如 7:49:37 PM - 8:49:37 PM。

优化范围

当您打开日志浏览器页面时，它会提取日志条目传递过选定资源的接收器的接收器；您有权查看的文件对于所有资源，提取的日志条目包括来源。对于 Google Cloud 项目，提取的日志条目还包括路由到项目的日志条目。如果您输入查询，日志浏览器将仅显示也与查询匹配的已提取的日志条目。例如，添加查询 severity>=ERROR 会得到以下结果：该屏幕仅列出严重级别为最低价格为 ERROR。

对于当前会话，您可以配置 Logs Explorer 提取。例如，在进行问题排查时检查日志视图中包含的日志条目，或特定 Google Cloud 项目中的资源。

如需配置日志浏览器页面提取哪些日志条目，请执行以下操作：执行以下操作：

在操作工具栏中，选择优化范围。
选择您希望日志浏览器页面提取日志条目的方式：
- 提取通过资源接收器传递的日志条目选择按当前项目确定范围。
  
  对于所有资源，提取的日志条目包括来源。对于 Google Cloud 项目，提取的日志条目还包括路由到项目的日志条目。
- 如需按日志视图提取日志条目，请选择按存储确定范围。然后选择一个或多个日志视图
  
  对于文件夹和组织，日志视图菜单包含所有日志视图，用于存储源自这些资源的日志条目。
  
  对于 Google Cloud 项目，日志视图菜单包括所选项目中日志存储分区的所有日志视图。选择存储在另一个存储分区中的日志视图 Google Cloud 项目，点击 导入项目。选择 Google Cloud 项目，然后选择日志视图。
点击应用。

查询窗格

使用查询窗格功能可执行以下操作：

查询标签页：使用以下功能构建和优化查询：
- 时间范围选择器：指定您需要的日志条目的时间范围更改为视图。如需了解详情，请参阅使用时间范围选择器。
- 搜索文本框：查找与您的搜索字词或短语匹配的日志条目。如需了解详情，请参阅跨日志字段搜索文本。
  
  注意：文本搜索的行为已更改。在不封装包含英文双引号的搜索字词， SEARCH 函数由系统自动调用。
- 过滤菜单：根据以下内容构建查询：资源、日志名称和严重性。如需了解详情，请参阅使用过滤器菜单。
- 查询编辑器字段：使用日志记录查询语言。有关详情，请参阅编写高级查询。
最近标签页：查看您最近运行的查询。有关请参阅使用近期查询。
已保存标签页：查看您已保存的查询以及其他其他 Google Cloud 项目用户与您分享的内容。有关请参阅保存查询和共享查询。
建议标签页：根据以下表格中的资源查看建议的查询 Google Cloud 项目。如需了解详情，请参阅使用建议的查询。
库标签页：根据您的用例查看和运行 Google 提供的查询。如需了解详情，请参阅从库中选择查询。
保存：保存可通过已保存页面查看和运行的查询标签页。
清除查询：清除并重置您在构建查询窗格中的查询。
流式传输日志：在 Logging 存储日志条目时查看日志条目日志存储分区。如需了解详情，请参阅流式传输日志。
运行查询：在 Query 窗格。

如果您没有看到查询编辑器字段，请启用显示查询。如果您将搜索字词，这些字词也会出现在查询编辑器字段进行求值，并作为查询表达式的一部分进行求值。

检查查询后，点击运行查询。匹配的日志 查询结果窗格下会列出您的查询。通过 直方图和日志字段窗格也可以根据查询表达式进行调整

流式传输日志

您可以流式传输日志，如下所示： Logging 会将它们存储在日志存储分区中，您也可以向仅流式传输与查询匹配的日志。

如需基于查询流式传输日志，请在 Query 窗格中添加一个查询，并且然后选择流式传输日志。在 Logging 中存储日志数据时在日志存储分区中，只有与查询匹配的日志才会显示在 查询结果窗格。如果未提供查询 Logging 会显示存储的每个日志条目。

要停止直播，请点击停止直播，或在 查询结果窗格。

结果工具栏

在结果工具栏中，您有以下选项：

日志字段：显示或隐藏日志字段窗格日志浏览器页面布局。有关详情，请参阅本文档的“日志字段”窗格部分。
直方图：显示或隐藏直方图窗格日志浏览器页面布局。有关详情，请参阅直方图部分。
分析结果：汇总您的使用 Log Analytics 分析查询结果。这个仅当您选择的范围包含符合以下条件的日志存储桶时才会显示按钮：已升级为使用 Log Analytics。如需更多信息请参阅本文档的分析结果部分。
创建指标：设置基于日志的指标。
创建提醒：设置基于日志的提醒政策。
跳至现在：对查询结果执行强制刷新，以便包含当前时间。如果时间范围选择器使用自定义时间范围，且设置了结束时间，则该查询使用默认时间运行查询时间范围为 1 小时否则，将使用当前开始日期进行刷新，或者然后运行查询。请注意，查询表达式。
更多操作：使用这些进一步的选项进行管理基于日志的提醒政策或创建接收器。

分析结果

您可以使用 SQL 查询来汇总、分析日志数据以及绘制图表 Log Analytics 页面，前提是您的项目包含已升级为使用 Log Analytics。如需转到 Log Analytics 页面，请执行以下操作：在日志浏览器中，点击结果工具栏中的 分析结果。

Analyze results 按钮仅在您选择的范围包含已升级为可使用的日志存储桶日志分析。例如，如果您选择 按存储范围确定范围 方法是点击优化范围按钮，然后点击。当存储空间中至少有一个存储桶时，系统会显示分析结果按钮范围已升级为使用 Log Analytics。如需了解详情，请参阅升级日志存储桶以使用 Log Analytics。

点击 分析结果：

日志浏览器中的时间范围可能会自动调整 Log Analytics 页面中存在有意义的日志数据。
Log Analytics 页面会在新标签页中打开，并会自动翻译将当前的 Logging 查询语言查询转换为 SQL 查询。
系统将转换您在日志浏览器中选择的范围添加到 SQL 查询中的等效 FROM 子句：
- 如果您选择按当前项目确定范围，则系统会使用以下视图：已查询：
  - _Required 存储桶中的日志视图。
  - _Default 存储桶中的日志视图。
  - 当前项目中用户定义的存储分区中的所有日志视图。
- 如果您选择了按存储确定范围，并选择了一个或多个日志视图，则只有当前项目中包含所选日志视图的查询。
- 如果您选择了按存储确定范围，并在则系统不会查询任何日志存储分区。
注意：Log Analytics 不支持跨项目查询或区域。如果您在日志浏览器中选择的范围包含存储在多个项目或区域，则您会在 Log Analytics 中看到的日志可能有所不同。

在 Log Analytics 页面中，您可以用表格形式查看结果，或图表在图表标签页中，您可以选择要绘制成图表的数据，自定义图表配置，或将图表保存到自定义信息中心。对于有关如何根据查询结果创建图表以及将图表保存到请参阅使用 Log Analytics 绘制查询结果图表。

如需了解如何使用 SQL 编写查询，请参阅在 Log Analytics 中查询和查看日志。

日志字段窗格

日志字段窗格提供日志数据和数据的简要摘要提供了一种优化查询的高效方法。该窗格显示损坏的日志条目不同维度，对应于这些条目中的字段。

在查询编辑器字段中执行查询后，日志字段窗格系统会根据查询结果填充数据。此窗格显示了为每个受支持的维度创建日志条目。对于每个维度一个选择。以下维度始终可用：

资源类型

如果您使用 BindPlane 写入本地和混合云日志，然后选择 通用节点。
严重程度

如果您希望查询多个严重级别，然后使用严重性菜单。

您可能会看到“服务”维度：

如果您的日志的资源类型为 Kubernetes 容器，如果您尚未按资源类型过滤日志系统会填充 Service 菜单。此菜单中的条目包括根据资源的 k8s-pod/app 标签。

例如，如果系统显示了一条与以下内容类似的日志条目则服务菜单包含名为 myservice 的服务：
```
{
 ...
 labels: {
     compute.googleapis.com/resource_name: "mycluster1"
     k8s-pod/app: "myservice"
     k8s-pod/pod-template-hash: "5ffcd94fdd"
  }
  logName: "projects/my-project/logs/stdout"
  resource: {
     labels: {6}
     type: "k8s_container"
  }
  ...
}
```
如果您按 已审核的资源 系统会填充 Service 菜单。此菜单中的条目包括根据资源的 service 标签的值动态确定。

系统会根据您的选择。例如，当您执行下列操作时，系统会列出“项目 ID”维度查询将日志条目限制为资源类型为 Kubernetes 容器，或者已选择“Scope by storage”。

优化您的查询

如需优化查询，请从日志字段窗格中选择一个值。例如：如果您在严重性标题中选择错误，则查询窗格已更新为包含 severity=ERROR。

以下屏幕截图展示了显示严重级别后的查询编辑器字段 日志字段窗格选择了相应的资源类型：

包含两个选项的“日志字段”窗格示例。

要移除选定的项，请点击清除 X。

在日志字段窗格中添加字段

您可以将特定 LogEntry 键值对从查询结果窗格中填充的日志条目添加到日志字段窗格。例如：如果您经常按 jsonPayload.message 字段的值进行过滤，则将其添加到日志字段窗格中。

如需向日志字段窗格添加字段，请执行以下操作：

在查询结果窗格中，点击展开。
选择字段的值。从菜单中选择在“日志字段”窗格中添加字段。

自定义字段会以键值对列表形式显示在日志字段窗格中。

要从日志字段窗格中移除自定义字段，请点击旁边的移除字段。

请注意，无法在日志字段窗格中添加以下类型的字段：

与时间相关的字段；例如 receiveTimestamp 和 protoPayload.startTime。
基数较高的字段；例如 insertId 和 protoPayload.latency。
路径中包含数组索引的字段；例如 protoPayload.authorizationInfo[0].resource.

直方图

借助直方图窗格，您可以直观呈现日志在。系统会在您运行查询时重新生成直方图，以便您更轻松地查看日志数据中的趋势并进行问题排查。

要显示或隐藏直方图窗格，请在以下位置点击直方图：结果工具栏。

直方图功能

直方图窗格示例。

直方图条柱：每个直方图条柱代表一个时间范围。每个条柱都包含各条柱时间段内捕获的日志严重性等级的三色明细。这些颜色表示以下日志严重程度：
- 蓝色：低严重程度，例如默认、调试、信息和通知。
- 黄色：中等严重程度，例如警告。
- 红色：高严重程度，例如错误、严重、提醒和紧急。
每个直方图条柱都有一个菜单，其中包含分析日志的选项。
时间控制：允许您调整查询结果窗格中的日志的时间范围。如需详细了解这些选项，请参阅使用时间控件分析日志。
时间轴：显示日志的时间范围直方图条，显示在查询结果 窗格。时间轴有助于您找到正在查看的日志。

使用时间控制分析日志

您可以使用直方图的时间控件调查和分析日志数据。

快速调整时间

直方图提供时间控件，让您能够快速调整 Logs Explorer 中显示的数据。

直方图窗格时间轴显示快速时间控件。

时间句柄：朝里拖动时间轴句柄可缩小数据范围，向外拖动可扩大直方图时间轴中的数据范围。点击运行。
前后滑动时间轴：点击 前进箭头 可将时间轴滑动到后面的时间点击 后退箭头 将时间轴滑动到较早的时间。
放大和缩小：点击缩小以拓宽时间轴中显示的数据。点击放大以缩小时间轴中显示的数据范围

对时间轴的修改仅限于当前时间（“现在”）和 30 天前。

滚动或缩放到指定时间

除了之前列出的时间控制外直方图会提供滚动到时间和缩放至时间功能，可让您更深入地控制以及您在日志浏览器的其他窗格中看到的数据。

直方图窗格时间轴显示“滚动到指定时间”和“缩放到指定时间”控件。

根据直方图条柱的相对大小或严重性级别，您可能会对特定直方图条柱感兴趣。您可以选择该直方图条来调整 Logs Explorer 中显示的日志数据。

您可以使用滚动到相应时间功能在不更改的情况下浏览日志数据 直方图和日志字段窗格中的值。如果选择滚动到指定时间功能，则会发生以下情况：

您在查询结果窗格中看到的日志数据会根据所选直方图条柱捕获的时间范围进行调整。

查询未运行，但系统可能会重新加载部分数据，以确保您在查询结果窗格中看到的日志与选定的直方图条柱的时间范围相对应。
控制台网址会更新为包含截止到所选直方图条柱的时间范围所捕获到的最新日志的 timestamp。

如需选择滚动到指定时间功能，请执行以下操作：

将指针悬停在直方图时间轴中的条形上。此时会显示一个窗格，其中包含指定时间范围内的日志数据的摘要信息。
在该窗格中选择滚动到指定时间。

或者，点击直方图相当于选择滚动到指定时间。

缩放到指定时间功能类似于滚动到指定时间，但可根据选定的直方图条柱捕获的时间范围对日志数据运行查询。如果选择缩放到指定时间功能，则会发生以下情况：

您在查询结果窗格中看到的日志数据会根据所选直方图条柱的时间范围限制重新加载和缩小范围。
控制台网址会更新为包含截止到所选直方图条柱的时间范围所捕获到的最新日志的 timestamp。
直方图会发生变化，以便仅显示 timestamp 值在所选直方图条柱时间范围内的日志。
日志字段窗格中的数据会根据选定的直方图条柱捕获的时间范围进行调整。

如需选择缩放到指定时间功能，请执行以下操作：

将指针悬停在直方图时间轴中的条形上。此时会显示一个窗格，其中包含指定时间范围内的日志数据的摘要信息。
在该窗格中选择缩放到指定时间。

查询结果

如需查看查询结果，请使用查询结果窗格。为了帮助您排查应用问题，您可以查看还可以对日志条目进行分组和分析日志

配置时间列

查询结果窗格中的时间列会显示生成自己的日志条目您可以自定义时间列，确保时间戳部分是可见的。这样可以腾出更多水平空间您可以在日志条目中查看更多信息

要选择显示时间戳的哪些部分，请点击时间列中的其他时间选项菜单中，然后选择以下任一选项：

日期、时间和时区
日期和时间（默认）
仅时间

使用摘要字段查找日志中的模式

假设您要查看查询结果中的日志条目，并希望快速按某个 LogEntry 字段浏览结果。或者，也许您想按某个字段值对对日志条目进行分组。您可以添加摘要字段，以条状标签的形式显示在每个结果的开头日志条目。例如，下图显示了向每个日志条目行添加了摘要字段 resource.type：

日志浏览器提供默认的摘要字段和自定义摘要字段。默认摘要字段取决于您当前的查询结果，以及自定义摘要字段，您可以选择 LogEntry 中的任意字段。

如需在查询结果中隐藏摘要字段，请使用 摘要字段切换开关。当此切换开关启用时，结果以原始文本格式显示。默认情况下，每个日志条目的内容都是截断为一行。若要让每个日志条目最多显示 10 行，使用换行切换开关。保留空格。

要隐藏特定的摘要字段，请启用摘要字段，然后点击 隐藏摘要字段。

如需修改摘要字段，请执行以下操作：

点击摘要列中的修改按钮以打开点击“编辑”菜单
在管理摘要字段对话框中，您可以执行以下操作：
- 将任何自定义字段名称添加到自定义摘要字段。
  
  摘要字段选择具有如下特点：
  - 使用查询结果中显示的日志自动补全内容。
  - 字段更正，使用英文引号括起合法字符。
  例如，如果您输入 jsonPayload.id-field，它会被更改为 jsonPayload."id-field"。
  
  您也可以选择任何 LogEntry 字段，无论。
  
  如需移除现有的自定义摘要字段，请点击其条状标签中的 X。
- 开启和关闭自定义摘要字段的截断功能。
  
  要缩短摘要字段值的显示，请使用切换开关，位于截断自定义摘要字段旁边。您可以选择在该字段前显示多少个字符以及字段的开头或结尾是。
  
  提示：如需显示摘要字段的完整值，请按住指针被截断的摘要字段。
- 隐藏或显示默认的摘要字段：
  
  如需自定义在查询结果中显示的默认摘要字段，请执行以下操作：展开隐藏或显示默认摘要字段菜单。
点击应用。

您的摘要字段现已在查询结果中更新。

搜索查询结果

如要搜索查询结果的内容，请点击在搜索结果中查找 查询结果窗格中，然后输入搜索字词。此过滤条件让您可以在日志条目中查找信息，而无需创建新查询。

符合搜索条件的字词会在 查询结果窗格：

系统会突出显示包含匹配搜索字词的日志条目。

查看类似日志条目

您可以查看与所选日志条目类似的日志条目，您可以专注于感兴趣的日志。

如需显示类似的日志条目，请执行以下操作：

在查询结果窗格的日志条目上，执行以下操作：点击展开。
点击类似条目，然后选择显示类似条目。

查询会使用如下所示的查询进行更新，并重新加载查询结果：
```
--Show similar entries
protoPayload.methodName="io.k8s.core.v1.configmaps.update"
--End of show similar entries
```

如需查看类似日志条目的预览，请执行以下操作：

在查询结果窗格中的日志条目上，点击展开。
展开类似条目菜单，然后选择 预览类似条目。

系统会打开一个单独的对话框，其中包含以下信息：
- 找到的模式
- 包含该模式的日志条目所占的百分比
- 包含模式的日志条目示例
在此对话框中，您可以隐藏或显示日志条目：

隐藏类似日志条目

您可以隐藏类似的日志条目，以便从查询中移除日志结果。

您可以通过以下两种方式隐藏类似的日志条目：

隐藏大量自动分组的日志条目。当您运行查询后，系统会分析查询结果然后，系统会根据类似的日志自动对模式和日志条目进行分组字段内容。如果检测到重要的图案，系统会在 查询结果窗格，显示了可查询到的结果隐藏：

隐藏类似条目：此按钮用于向查询添加一个子句并重新加载查询结果。

预览：系统会打开一个单独的窗口，说明找到的图案；以及显示条目的示例。

如果您隐藏类似日志，系统不会保存 Logs Explorer 会话，每个查询都会生成一个新的分析，仅显示在所显示的日志中。不同的查询会分析具体取决于所返回的日志类型。
隐藏与特定日志条目类似的日志条目。隐藏日志条目，请执行以下操作：
1. 在日志条目上，点击展开。点击类似条目菜单，然后选择 隐藏类似条目。
  
  查询会更新，并且查询结果窗格会重新加载。日志条目与所选日志条目类似的事件将不会显示。

查看或隐藏与字段匹配的日志条目

您可以查看或隐藏与日志条目中的字段匹配的日志条目，您将重点关注包含相同字段内容的条目。

如需查看或隐藏与日志条目中的特定字段匹配的日志条目，请执行以下操作：以下：

在查询结果窗格的日志条目中，点击展开。
点击日志条目中某个字段的值（例如 compute.googleapis.com），它是 serviceName。

您会看到以下菜单：
选择显示匹配条目或隐藏匹配的条目。

查询会更新为显示或隐藏类似条目的查询，并且 查询结果会重新加载新结果。

固定日志条目

运行查询后，您可以固定日志条目，以突出显示该日志条目。置顶日志条目会在查询结果窗格中保持居中。如果您运行新查询且未包含固定的日志条目，则系统会提示您取消固定该日志条目。

如需固定日志条目，请执行以下操作：

将指针悬停在要固定的日志条目上。
点击固定。

固定某个日志条目后，其背景会变暗，并且显示了固定图标。图钉图标 直方图窗格中也会根据固定日志条目的 timestamp：

日志浏览器会在查询结果和直方图窗格中显示固定的日志条目。

如需取消固定某个日志条目，请再次点击固定图标。

显示与固定的日志条目的资源匹配的日志

固定日志条目后，您可以运行显示日志条目的新查询与固定日志的资源类型或资源标签相匹配的资源。

如需固定某个日志条目并显示与同一资源类型或请执行以下操作：

点击 向下箭头 以展开固定菜单。
从图钉菜单中选择所需选项：
- 要使用相同的 resource.type 作为选择“Same resource.type”。
  
  例如，假设您将 resource.type 为 k8s_node.如果您选择 Same resource.type，则查询重新运行以显示包含 resource.type="k8s_node" 的所有日志条目。
- 要使用相同的 resource.labels 作为选择“Same resource.labels”。
- 要使用相同的 trace已固定选择 Same Trace。
- 如需清除查询并显示所有日志条目，请选择全部显示。

在直方图窗格中查看固定的日志条目

您可以使用直方图窗格突出显示、滚动和进一步检查固定日志条目。

在 Histogram 窗格中，点击 Pin（固定）。然后从以下菜单选项中进行选择：

滚动到日志条目：将日志条目置于当前 查询结果窗格，然后在附近日志的上下文。
缩放至日志条目：缩小 直方图 (Histogram) 窗格显示并优化查询，以分离出。

查看跟踪记录数据

如果日志条目同时包含 trace 和延迟时间相关字段，则会显示延迟时间和跟踪记录图标。

包含跟踪记录数据的日志条目显示。

如果日志条目仅包含 trace 字段，则只会显示跟踪记录图标。

要查看与日志条目相关的跟踪记录数据，请点击跟踪记录图标。您可以选择以下选项：

查看跟踪记录详情：显示父级 Span 和子跟踪记录以及有关跟踪记录的详细信息。如需查看有关跟踪记录的更多详细信息，请通过点击在 Trace 中查看导航到 Cloud Trace。如需详细了解详情面板中的内容，请参阅查找和探索跟踪记录。

显示此跟踪记录的所有日志：通过添加设置为与日志条目关联的跟踪记录的标识符的 trace 字段来优化和运行查询。
仅显示跟踪的请求：通过添加设置为 True 的 traceSampled 字段来优化和运行查询。如需详细了解采样，请参阅采样率。

复制指向日志条目的链接

如要分享指向日志的链接，请展开日志条目，然后选择复制链接。该链接会复制到剪贴板。您可以将链接发送给有权访问 Google Cloud 项目。当用户将链接粘贴到浏览器中或将其选中时，Logging 会将日志条目固定到查询结果窗格中。

下载日志

您可以下载 CSV 或 JSON 格式的日志。您需要具有以下 Identity and Access Management 角色之一才能下载日志：

Logging Admin (roles/logging.admin)
Logs View Accessor (roles/logging.viewAccessor)

如需下载日志，请执行以下操作：

点击工具栏中的下载 查询结果窗格。
在下载日志对话框中，选择 CSV 或 JSON 格式，然后选择点击下载。
选择如何处理日志数据。您可以选择以下选项：
- 将数据下载到您的计算机。
- 将数据下载到 Google 云端硬盘。
- 在新标签页中打开数据。
保存 CSV 文件并选择 Google 云端硬盘后，您可以使用 Google 表格。

有关问题排查信息，请参阅日志下载失败。

示例查询

如需查看按 Google Cloud 产品和用例整理的建议查询，请参阅使用日志浏览器的示例查询。例如，您可以运行与 Kubernetes 相关的查询来查找 Google Kubernetes Engine 日志。

查看 Compute Engine 日志

对于某些 Compute Engine 资源类型，例如 gce_instance 和 gce_network，您会看到资源名称以辅助文本的形式 Logs Explorer 中的多个位置。例如，对于 gce_instance 您可以看到虚拟机名称以及虚拟机 ID。资源名称有助于您需要确定正确的资源 ID，以便基于该资源构建查询。

您可能会在以下位置看到 Compute Engine 资源名称：

查询窗格过滤条件菜单：Compute Engine 资源类型会显示资源名称及其对应的资源 ID：辅助文本。
日志字段：Compute Engine 资源类型在字段维度中显示资源名称，而不是资源 ID。
查询结果：对于 Compute Engine 虚拟机实例日志， resource.labels 字段显示具有相应资源名称的元数据。
摘要字段：适用于 Compute Engine 虚拟机实例日志，该条状标签会显示资源名称而非资源 ID。

问题排查

本部分介绍如何排查使用日志浏览器时的常见问题。

如果您在尝试查看接收器目标位置中的日志时遇到问题，请参阅对路由和接收器进行问题排查。

日志下载失败

您正在使用日志浏览器，点击下载。该命令开始了，但随后无法完成或报告了错误。

要解决此问题，请减少执行命令所需的时间尝试以下操作：

在下载日志对话框中，减小日志条目数量上限的值。
缩短查询日志的时间段。
在查询结果工具栏中，点击隐藏类似条目，开始下载
修改查询以使用编入索引的字段。

找不到虚拟机实例的控制台日志

写入 Compute Engine 实例控制台的日志可能不会显示在日志浏览器中。如需查看这些日志，请执行以下操作：

在 Google Cloud 控制台中，转到虚拟机实例页面：
前往虚拟机实例

如果您使用搜索栏查找此页面，请选择子标题为 Compute Engine 的结果。
选择相应实例，然后在以下位置选择串行端口 1（控制台）：日志部分。

您可以对实例进行配置，使其串行端口输出为发送到 Cloud Logging。如需了解详情，请参阅启用和停用串行端口输出日志记录。

获取 Google Cloud 项目或组织 ID

如需从以下位置的任意位置获取 Google Cloud 项目或组织 ID：从 Google Cloud 控制台中展开 Google Cloud 项目列表， Google Cloud 项目和组织选择器，然后找到 ID 列中的 Google Cloud 项目 ID。

看不到日志条目

如果您没有看到任何日志条目，请执行以下检查：

是否选择了正确的 Google Cloud 项目？否则，请选择从 Google Cloud 项目中正确的 Google Cloud 项目组织选择器。
您的 Google Cloud 项目是否使用的资源生成日志这些资源上是否有活动？即使 Google Cloud 项目则应该有审核日志，记录已创建应用这一事实。转到受监控的资源列表页面中的“将服务映射到资源类型” 部分，确认您使用的是会生成日志的资源。
时间范围是否过窄？确认您的查询中的时间范围正确无误。
查看当前的排除项查询，确保系统不会意外排除您所查找的日志。
查看日志时是否使用了正确的范围？相关说明有关如何调整搜索范围的说明，请参阅优化范围。

我的查询正确无误，但我仍然没有看到日志条目

您看不到超过 Logging 保留期限的日志条目。如需了解有效的日志保留期限，请参阅日志保留期限。
在高负载时段内，将日志发送到 Logging 或者接收及显示日志的过程可能存在延迟。
日志浏览器不会显示带有未来时间戳的日志条目，直到当前时间“赶上”这些时间戳后才会显示。这种情况并不常见，可能是由发送日志的应用中的时间偏差引起的。
查询范围设置得过大，无法在合理的时间内完成。您可能会看到“截止期限到操作完成为止”。请尝试使您的查询更具体或缩短时间范围。

查询返回错误

如果您在未指定存储桶的情况下对资源发出查询，则 Cloud Logging 使用 Google Cloud 项目中接收器的历史记录来确定可能在什么位置写入了该资源的条目。如果 Cloud Logging 可识别超过 200 个存储分区则查询会失败，并显示以下消息： Error: Invalid query.

如需解决此问题，请将查询范围缩小为一部分存储。如需了解详情，请参阅优化范围。

查询结果时间范围与查询不匹配

您在查询结果和日志字段窗格中看到的日志数据会根据直方图时间轴捕获的时间范围进行调整。您可以调整使用直方图的时间控件或时间范围选择器。调整这些时间控件不会改变在 Query 窗格中查询表达式。

如果您的查询带有时间戳，则时间范围选择器会处于停用状态，查询使用时间戳表达式作为其时间范围限制。如果查询不使用时间戳表达式，则会使用时间范围选择器作为其时间范围限制。

获取支持

如需了解如何获取支持，请参阅 Google Cloud Observability 支持页面。