使用日志浏览器查看日志

本文档简要介绍了 Google Cloud 控制台中的 Logs Explorer,您可通过该浏览器检索、查看和分析日志数据。借助日志浏览器,您可以查找和查看日志,以便排查问题。您还可以使用 Logging APIGoogle Cloud CLI 来读取日志。

直方图的每个元素都会显示在该元素关联的时间间隔内收到的日志条目的大致数量。如需获取一段时间内收到的日志条目数量的精确计数,请使用 Log Analytics 或复制日志到 Cloud Storage 存储桶。

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

开始使用

如需获取在 Logs Explorer 中查看日志所需的权限,请让管理员授予您以下 IAM 角色:

  • 查看 _Required 存储桶中的所有日志,并在 _Default 存储桶的 _Default 视图中查看日志: 使用您项目的日志查看器 (roles/logging.viewer)。
  • 查看 _Required_Default 存储分区中的所有日志,包括数据访问日志:使用项目的 Private Logs Viewer (roles/logging.privateLogViewer)。
  • 查看存储在用户定义的日志存储桶的日志视图中的日志: 对包含用户定义的存储桶的项目拥有 Logs View Accessor (roles/logging.viewAccessor)。如果您具有不带任何条件的 Logs View Accessor 角色,则可以查看在用户定义的日志存储分区的任何日志视图中存储的日志。如需查看示例,请参阅从存储桶中读取日志
  • 查看存储桶中的受限 LogEntry 字段: 项目的日志字段访问器 (roles/logging.fieldAccessor)。如需了解详情,请参阅配置字段级访问权限

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

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

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

  1. 在 Google Cloud 控制台的导航面板中,选择 Logging,然后选择 Logs Explorer

    前往 Logs Explorer

  2. 选择相应的 Google Cloud 项目。

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

日志浏览器界面

通过日志浏览器界面,您可以检索日志、解析和分析日志数据以及优化查询参数。

日志浏览器的界面

日志浏览器包含以下部分,本页详细介绍了这些部分:

  1. 操作工具栏
  2. 查询窗格
  3. 结果工具栏
  4. 日志字段窗格
  5. 直方图
  6. 查询结果窗格

操作工具栏

使用操作工具栏功能,您可以执行以下操作:

  • 优化范围:仅按当前 Google Cloud 项目中的日志或者按一个或多个存储视图搜索范围。如需详细了解如何限定范围,请参阅优化范围
  • 学习:查看相关文档和主题的链接。
  • 共享链接:创建当前查询的缩短网址并将其复制到剪贴板,以便更轻松地共享查询。复制的网址具有以查询的当前时间范围表示的相应绝对时间范围;例如 7:49:37 PM - 8:49:37 PM

优化范围

如果您的日志存储在日志存储分区中,那么您可以在 Logs Explorer 中查看这些日志。根据您选择的项目,您可能需要调整日志浏览器的范围以查看存储在某些日志存储分区中的日志。

默认情况下,日志浏览器会显示由当前项目中的资源生成或直接路由到当前项目并存储在任何日志存储桶中的所有日志。默认情况下,日志浏览器不会显示由另一个项目中的资源生成并路由到当前项目中的日志存储桶的日志。

如需自定义在 Logs Explorer 中显示的日志,请使用操作工具栏中的优化范围按钮:

  • 如需查看在当前项目中生成或直接路由到当前项目中的所有日志,请选择按当前项目确定范围

    日志接收器可以将日志路由到当前项目中的日志存储桶、其他项目中的日志存储桶或其他项目。如需了解详情,请参阅将日志路由到支持的目标位置

  • 如需查看存储在当前项目的日志存储分区中的某些日志,请选择按存储确定范围,然后选择一个或多个日志视图。如果您想更精细地控制谁有权访问当前项目中的日志存储分区中的哪些日志,请使用此选项。

    如需详细了解如何创建和管理日志视图,请参阅在日志存储桶上配置日志视图

  • 如需查看存储在不同项目的日志存储分区中的某些日志,请选择按存储确定范围,点击项目和日志视图选择器中的 导入项目,然后选择一个或多个日志视图。如果您的组织有多个项目,并且每个项目都生成自己的唯一日志,并且您希望在 Logs Explorer 中一起查看这些日志,请使用此选项。

    例如,如需查看存储在日志存储桶中的所有日志,请选择 _AllLogs 视图:

    显示项目和日志视图选择器的“优化范围”对话框。

查询窗格

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

  • 查询标签页:使用以下功能构建和优化查询:

    • 时间范围选择器:指定要查看的日志的时间范围。如需了解详情,请参阅使用时间范围选择器

    • 搜索文本框:查找与您的搜索字词或短语匹配的日志条目。 如需了解详情,请参阅在日志字段中搜索文本

    • 过滤条件菜单:根据资源日志名称严重程度构建查询。如需了解详情,请参阅使用过滤器菜单

    • 查询编辑器字段:使用 Logging 查询语言构建高级查询。如需了解详情,请参阅编写高级查询

  • 近期标签页:查看您最近运行的查询。如需了解详情,请参阅使用近期查询

  • 已保存标签页:查看已保存的查询以及 Google Cloud 项目的其他用户与您共享的查询。如需了解详情,请参阅保存查询共享查询

  • 建议标签页:查看基于 Google Cloud 项目中的资源建议的查询。如需了解详情,请参阅使用建议的查询

  • 标签页:根据您的使用场景查看并运行 Google 提供的查询。如需了解详情,请参阅从库中选择查询

  • 保存:保存可从已保存标签页查看和运行的查询。

  • 清除查询:清除并重置您在查询窗格中构建查询时所做的选择。

  • 流式传输日志:查看日志条目,因为 Logging 将其存储在日志存储分区中。如需了解详情,请参阅流式传输日志

  • 运行查询:在查询窗格中构建查询后运行查询。

如果看不到查询编辑器字段,请启用显示查询。如果您在搜索文本框中添加任何搜索字词,这些字词也会出现在查询编辑器字段中,并作为查询表达式的一部分进行求值。

查看查询后,点击运行查询。与您的查询匹配的日志列在查询结果窗格下。直方图日志字段窗格也会根据查询表达式进行调整。

流式传输日志

您可以流式传输日志,因为 Logging 会将这些日志存储在日志存储分区中,也可以添加查询以仅流式传输与查询匹配的那些日志。

如需基于某个查询流式传输日志,请在查询窗格中添加查询,然后选择流式传输日志。当 Logging 将日志数据存储在日志存储分区中时,查询结果窗格中仅显示与查询匹配的日志。如果未提供查询,Logging 会显示存储的每个日志。

如需停止流式传输,请点击停止流式传输,或在查询结果窗格中滚动。

结果工具栏

结果工具栏中,您可以选择以下选项:

  • 日志字段:在日志浏览器页面布局中显示或隐藏日志字段窗格。如需了解详情,请参阅本文档的日志字段窗格部分。
  • 直方图:在日志浏览器页面布局中显示或隐藏直方图窗格。如需了解详情,请参阅本文档的直方图部分。
  • 分析结果:使用 Log Analytics 对查询结果进行汇总并绘制图表。仅当您选择的范围包含已升级为使用 Log Analytics 的日志存储桶时,该按钮才会显示。如需了解详情,请参阅本文档的分析结果部分。
  • 创建指标:设置基于日志的指标
  • 创建提醒:设置基于日志的提醒
  • 跳至现在:对查询结果执行强制刷新,以包含当前时间。如果时间范围选择器使用自定义范围并设置了结束时间,则会使用一小时的默认时间范围运行查询。否则,它会使用当前的开始日期或时长进行刷新,并运行查询。请注意,使用此功能时,查询表达式不会改变。
  • 更多操作:使用这些更多选项来管理基于日志的提醒创建接收器

分析结果

当您的项目包含已升级为使用 Log Analytics 的日志存储分区时,您可以在 Log Analytics 页面中使用 SQL 查询来汇总、分析日志数据以及绘制图表。如需从日志浏览器前往 Log Analytics 页面,请在结果工具栏中点击 分析结果

仅当您选择的范围包含已升级为使用 Log Analytics 的日志存储桶时,系统才会显示 分析结果按钮。例如,如果您使用优化范围按钮选择了按存储范围确定范围,则当存储范围内的至少一个存储桶升级为使用 Log Analytics 时,系统会显示 分析结果按钮。如需了解如何升级日志存储桶以使用 Log Analytics,请参阅升级日志存储桶以使用 Log Analytics

点击 分析结果按钮时,会发生以下情况:

  • 日志浏览器中的时间范围可能会自动调整,以使日志分析页面中具有有意义的日志数据。

  • Log Analytics 页面会在新标签页中打开,并自动将当前的 Logging 查询语言查询转换为 SQL 查询。

  • 您在日志浏览器中选择的范围将转换为 SQL 查询中的等效 FROM 子句:

    • 如果您选择按当前项目确定范围,则系统会查询 _Required_Default 存储分区。

    • 如果您在选择了一个或多个日志视图的情况下选择了按存储确定范围,则系统只会查询当前项目中包含所选日志视图的日志存储分区。

    • 如果您选择按存储确定范围,并在其他项目中指定了日志视图,则系统不会查询任何日志存储分区。

日志分析页面中,您能够以表格形式或图表形式查看结果。在 Chart 标签页中,您可以选择已绘制图表的数据,自定义图表配置,或将图表保存到自定义信息中心。如需了解如何根据查询结果创建图表,并将图表保存到自定义信息中心,请参阅使用 Log Analytics 将查询结果绘制成图表

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

日志字段窗格

日志字段窗格提供日志数据的简要摘要,并提供了一种高效优化查询的方法。此窗格会显示按不同维度细分的日志条目,与这些条目中的字段相对应。

在查询编辑器字段中执行查询后,系统会根据查询结果填充日志字段窗格。此窗格会显示每个受支持维度的日志条目计数。对于每个维度 您都可以进行选择。以下维度始终可用:

  • 资源类型

    如果您使用 BindPlane 写入本地和混合云日志,请选择资源类型通用节点

  • 严重级别

    如果您希望查询按多个严重级别进行过滤,请使用严重级别菜单。

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

  • 如果您的日志的资源类型为 Kubernetes 容器,并且尚未按资源类型过滤日志,则系统会填充服务菜单。此菜单中的条目由资源的 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 标签的值动态确定。

其他维度(例如“项目 ID”)会根据您的选择而列出。例如,如果查询将日志条目限制为资源类型为 Kubernetes 容器的日志条目,或者选择了按存储确定范围,则系统会列出“项目 ID”维度。

优化查询

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

以下屏幕截图展示了使用日志字段窗格选择严重性和资源类型后的查询编辑器字段:

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

若要移除所选内容,请点击清除 X

日志字段窗格中添加字段

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

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

  1. 查询结果窗格中,点击 展开以展开日志条目。

  2. 点击某个字段的值。从菜单中选择在“日志字段”窗格中添加字段

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

如需从日志字段窗格中移除自定义字段,请点击该字段旁边的移除

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

  • 与时间相关的字段;例如 receiveTimestampprotoPayload.startTime
  • 基数较高的字段;例如 insertIdprotoPayload.latency
  • 路径中包含数组索引的字段;(例如 protoPayload.authorizationInfo[0].resource)。

直方图

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

如需显示或隐藏直方图窗格,请点击结果工具栏中的直方图按钮。

直方图功能

直方图窗格。

  1. 直方图条柱:每个直方图条柱代表一个时间范围。每个条柱都包含各条柱时间段内捕获的日志严重性等级的三色明细。这些颜色表示以下日志严重程度:

    • 蓝色:低严重程度,例如 默认调试信息通知
    • 黄色:中等严重程度,例如警告
    • 红色:高严重程度,例如错误严重提醒紧急

    每个直方图条柱都有一个菜单,其中包含分析日志的选项。

  2. 时间控制:允许您调整查询结果窗格中的日志的时间范围。如需详细了解这些选项,请参阅使用时间控件分析日志

  3. 时间轴:显示当前在查询结果窗格中显示的日志的时间范围(以直方图条表示)。时间轴可帮助您熟悉您当前在查询的更大时间范围内查看的日志。

使用时间控制分析日志

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

快速调整时间

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

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

  • 时间句柄:朝里拖动时间轴句柄可缩小数据范围,向外拖动可扩大直方图时间轴中的数据范围。点击运行

  • 向前和向后滑动时间轴:点击 前进箭头,即可将时间轴滑到后面的时间。点击 向后箭头可将时间轴滑动到较早的时间。

  • 缩放:点击 缩小可扩大时间轴中显示的数据。点击 放大可缩小时间轴中显示的数据范围。

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

滚动或缩放到指定时间

除了上述时间控件外,直方图还提供滚动到指定时间缩放到指定时间功能,便于您更深入地控制直方图以及您在 Logs Explorer 的其他窗格中看到的数据。

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

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

您可以使用滚动到时间功能浏览日志数据,而无需更改直方图日志字段窗格中的值。如果选择滚动到指定时间功能,则会发生以下情况:

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

    查询未运行,但系统可能会重新加载部分数据,以确保您在查询结果窗格中看到的日志与选定的直方图条柱的时间范围相对应。

  • 控制台网址会更新为包含截止到所选直方图条柱的时间范围所捕获到的最新日志的 timestamp

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

  1. 将鼠标悬停在直方图时间轴中的条形上。此时会显示一个窗格,其中包含指定时间范围内的日志数据的摘要信息。

  2. 在该窗格中选择滚动到指定时间

    或者,点击直方图条柱而不是将鼠标悬停在其上方,此操作相当于选择滚动到指定时间

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

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

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

  1. 将鼠标悬停在直方图时间轴中的条柱上。此时会显示一个窗格,其中包含指定时间范围内的日志数据的摘要信息。

  2. 在该窗格中选择缩放到指定时间

查询结果

如需查看查询结果,请使用查询结果窗格。为帮助您排查应用问题,您可以查看各个日志条目的详细信息,并对日志条目进行分组和分析,以查找日志中的模式。如果您在查看日志的项目中启用了 Duet AI,则您还可以使用 Duet AI 总结日志条目

配置时间

查询结果窗格中的时间列显示日志条目的时间戳。您可以自定义时间列,以便仅显示时间戳的某些部分。这样会创造更多的水平空间,让您可以在日志条目中查看更多信息。

如需选择要显示的时间戳部分,请点击时间列中的 其他时间选项菜单,然后选择以下选项之一:

  • 日期、时间和时区

  • 日期和时间(默认)

  • 仅时间

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

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

日志浏览器显示的日志带有显示资源类型的绿色文本前缀。

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

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

如需隐藏特定摘要字段,请点击摘要字段,然后点击隐藏摘要字段

如需修改摘要字段,请执行以下操作:

  1. 点击摘要列中的 修改按钮,打开修改菜单。

    查询结果窗格会显示用于修改摘要字段的按钮。

  2. 管理摘要字段对话框中,您可以执行以下操作:

    • 将任何自定义字段名称添加到自定义摘要字段

      摘要字段选择具有如下特点:

      • 使用查询结果中当前显示的日志自动补全信息。
      • 字段更正,使用英文引号括起合法字符。

      例如,如果您输入 jsonPayload.id-field,它会被更改为 jsonPayload."id-field"

      您还可以选择任何 LogEntry 字段,无论自动补全功能是否向您推荐了该字段。

      如需移除现有的自定义摘要字段,请点击其条状标签中的 X

    • 启用和停用自定义摘要字段的截断功能。

      如需缩短摘要字段值的显示时间,请使用截断自定义摘要字段旁边的 切换开关。您可以选择在截断字段之前显示多少个字符,以及显示字段的开头还是结尾。

    • 隐藏或显示默认摘要字段:

      如需自定义在查询结果中显示哪些默认摘要字段,请展开隐藏或显示默认摘要字段菜单。

  3. 点击应用

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

搜索查询结果

如需搜索查询结果的内容,请点击查询结果窗格中的在搜索结果中查找,然后输入搜索字词。利用此过滤条件,您无需构建新查询即可查找日志条目中的信息。

与搜索条件匹配的字词会在查询结果窗格内的日志条目中突出显示:

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

查看类似日志条目

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

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

  1. 查询结果窗格的日志条目上,点击 展开

  2. 点击类似条目,然后选择显示类似条目

    该查询会使用类似如下的查询进行更新,并重新加载查询结果:

    --Show similar entries
    protoPayload.methodName="io.k8s.core.v1.configmaps.update"
    --End of show similar entries
    

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

  1. 查询结果窗格的日志条目上,点击 展开

  2. 展开类似条目菜单,然后选择预览类似条目

    系统会打开一个单独的对话框,其中包含以下信息:

    • 找到的模式
    • 包含该模式的日志条目所占的百分比
    • 包含此模式的日志条目示例

    在此对话框中,您可以隐藏或显示日志条目:

    通过“预览日志条目”对话框,您可以隐藏或显示类似的日志条目。

隐藏类似日志条目

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

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

  • 隐藏大量自动分组的日志条目。当您运行查询时,系统会针对模式分析查询结果,然后根据类似的日志字段内容自动对日志条目进行分组。如果检测到重要模式,查询结果窗格中会显示一个横幅,其中显示可隐藏的结果百分比:

    隐藏类似日志横幅。

    隐藏类似条目:此按钮可向查询添加子句并重新加载查询结果。

    预览:系统会打开一个单独的窗口,其中描述了找到的模式,并显示条目示例。

    如果您隐藏类似日志,系统不会在 Logs Explorer 会话之外保存任何信息,并且每个查询都会仅根据显示的日志生成一个新的分析。不同的查询会根据返回的日志类型分析日志条目的不同部分。

  • 隐藏与特定日志条目类似的日志条目。如需隐藏与日志条目类似的日志条目,请执行以下操作:

    1. 在日志条目上,点击 展开,点击类似条目菜单,然后选择隐藏类似条目

      查询会更新,并且查询结果窗格会重新加载。系统不会显示与所选日志条目类似的日志条目。

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

您可以查看或隐藏与日志条目中的字段匹配的日志条目,从而专注于包含相同字段内容的条目。

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

  1. 查询结果窗格的日志条目上,点击 展开

  2. 点击日志条目中某个字段的值,例如 compute.googleapis.com,它是一个 serviceName

    您会看到以下菜单:

    此菜单包含用于根据特定字段隐藏和显示日志条目的选项。

  3. 选择显示匹配的条目隐藏匹配的条目

    查询会使用可显示或隐藏类似条目的查询进行更新,查询结果会重新加载以显示新结果。

固定日志条目

运行查询后,您可以通过固定日志条目来突出显示该条目。固定的日志条目保持在查询结果窗格中的中心位置。如果您运行新查询并且不包含固定的日志条目,系统会提示您取消固定日志条目。

如需固定日志条目,请执行以下操作:

  1. 将鼠标悬停在要固定的日志条目上。
  2. 点击 固定

固定日志条目后,其背景会变暗,并显示 固定图标。系统还会根据固定的日志条目的 timestamp,在直方图窗格中显示一个图钉图标:

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

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

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

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

如需固定日志条目并显示与同一资源类型或资源标签匹配的日志条目,请执行以下操作:

  1. 点击固定日志旁边的 向下箭头,以展开固定菜单。

  2. 从图钉菜单中进行选择:

    • 如需使用与固定的日志相同的 resource.type 重新运行查询,请选择相同的 resource.type

      例如,假设您固定 resource.typek8s_node 的日志条目。如果您选择相同的 resource.type,系统会重新运行查询以显示所有带有 resource.type="k8s_node" 的日志条目。

    • 如需使用与固定日志相同的 resource.labels 重新运行查询,请选择相同的 resource.labels

    • 如需使用与固定日志相同的 trace 重新运行查询,请选择同一跟踪记录

    • 如需清除查询并显示所有日志条目,请选择全部显示

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

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

直方图窗格中,点击 固定,然后从以下菜单选项中进行选择:

  • 滚动到日志条目:将日志条目进入当前的查询结果窗格,并在附近日志的上下文中查看固定的日志条目。
  • 缩放至日志条目:缩小直方图窗格显示的时间范围,并优化查询以隔离固定日志附近的日志。

查看跟踪记录数据

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

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

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

仅包含跟踪记录字段的日志条目显示才有跟踪记录图标。

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

  • 查看跟踪记录详情:显示父级 Span 和子跟踪记录以及有关跟踪记录的详细信息。如需查看有关跟踪记录的更多详细信息,请通过点击在 Trace 中查看导航到 Cloud Trace。如需详细了解详细信息面板中的内容,请参阅查找和探索跟踪记录
  • 显示此跟踪记录的所有日志:通过添加设置为与日志条目关联的跟踪记录的标识符的 trace 字段来优化和运行查询。

  • 仅显示跟踪的请求:通过添加设置为 TruetraceSampled 字段来优化和运行查询。如需详细了解采样,请参阅采样率

查看 Monitoring 数据

对于某些日志(例如 GKE 和 Compute Engine 日志),您可以点击日志摘要行中的资源类型以显示包含以下选项的菜单:

  • 查看监控详情:打开 GKE 资源的详细信息面板。如需详细了解详细信息面板,请参阅查看资源详细信息
  • 在 Monitoring 中查看:打开资源的 Monitoring 页面。
  • 在 GKE 中查看在 Compute Engine 中查看:打开 GKE 或 Compute Engine 界面中资源的详情页面。

显示 GKE 资源的日志浏览器菜单。

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

复制链接以与他人共享日志条目。

下载日志

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

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

如需下载日志,请执行以下操作:

  1. 点击查询结果窗格中的下载

  2. 下载日志对话框中,选择 CSV 或 JSON 格式。

  3. 选择如何处理日志数据。您可以选择以下选项:

    • 将数据下载到您的计算机。
    • 将数据下载到 Google 云端硬盘。
    • 在新标签页中打开数据。

    保存 CSV 文件并选择 Google 云端硬盘后,您可以在 Google 表格中打开该文件。

示例查询

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

查看 Compute Engine 日志

对于某些 Compute Engine 资源类型(例如 gce_instancegce_network),您会在 Logs Explorer 中的几个位置看到带有资源 ID 的资源名称作为辅助文本。例如,对于 gce_instance 资源类型,您会看到虚拟机名称以及虚拟机 ID。资源名称可帮助您识别正确的资源 ID,然后据此构建查询。

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

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

问题排查

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

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

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

写入 Compute Engine 实例控制台的日志可能无法在 Logs Explorer 中使用。如需查看这些日志,请执行以下操作:

  1. 在 Google Cloud 控制台的导航面板中,选择 Compute Engine,然后选择虚拟机实例

    前往虚拟机实例

  2. 选择相应实例,然后在页面的日志部分中选择串行端口 1(控制台)

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

获取 Google Cloud 项目或组织 ID

如需从 Google Cloud 控制台中的任意位置获取 Google Cloud 项目或组织 ID,请从 Google Cloud 项目和组织选择器中展开 Google Cloud 项目列表,然后在 ID 列中找到 Google Cloud 项目 ID:

显示项目 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 可观测性支持页面