使用日志浏览器

准备工作

除非您是要将 Amazon Web Services (AWS) 中的日志发送到 Logging,否则无需工作区即可使用 Logging。

如果您使用工作区,则 Logging 不会合并来自多个受监控 Google Cloud 项目的日志。您必须选择特定 Cloud 项目才能查看其日志。

如果您使用工作区和 AWS,请选择 AWS 连接器项目来查看 AWS 日志。

使用入门

如需转到日志浏览器,请执行以下操作:

  1. 转到 Google Cloud 导航菜单 ,然后选择 Logging > 日志浏览器
    转到日志浏览器
  2. 选择 Google Cloud 项目。
  3. 升级菜单中,从旧版日志查看器切换到日志浏览器

您现在位于日志浏览器中。

日志浏览器界面

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

日志浏览器的界面

  1. “日志浏览器”页面:您可以在这里构建、分析和优化查询。
  2. 组织和项目选择器:可让您在组织级层或项目级层查看日志。
  3. 查询生成器:允许您使用下拉菜单或查询生成器语言来构建查询。还提供了用于查看“已保存查询”和“最近查询”的标签页。
  4. 日志字段Beta 版):可让您查看 resource.typeresource.labelslogNameseverity 字段的汇总结果,并提供了一种更高效的查询优化方式。
  5. 直方图:直观呈现日志数据的频率。
  6. 查询结果:让您可以查看从查询中检索到的日志。
  7. 日志条目:让您能以结构化的 JSON 格式查看日志条目。
  8. 时区:允许您更改显示日志的时区。
  9. 页面布局:可让您启用和停用直方图日志字段浏览器面板。
  10. 时间范围选择器:允许您按时间范围限制搜索结果。默认时间范围为 1 小时。
  11. 运行查询:允许您在查询构建器窗格中构建查询后运行查询。
  12. 跳至当前:允许您执行强制刷新,以包含当前时间。如果时间范围选择器使用了自定义范围并设置了结束时间,则会运行使用 1 小时默认时间范围的查询。否则,将使用当前开始日期或时长进行刷新,并运行查询。
  13. 操作:允许您设置基于日志的指标、创建接收器目标位置或下载日志。
  14. 配置:允许您将日志字段的值添加到日志条目开头或末尾处的摘要行。 您还可以选择显示最新日志(第一个或最后一个)。
  15. 隐藏日志摘要:用于隐藏查询结果中的日志摘要行。
  16. 展开或收起嵌套日志字段:用于展开或收起嵌套字段。
  17. 复制到剪贴板:允许您以 JSON 格式复制日志条目。
  18. 保存:您可以保存查询,并从已保存标签页查看和运行保存的查询。
  19. 跟踪记录数据:让您查看跟踪记录详情并根据跟踪记录优化查询。
  20. 展开和收起查询结果:您可以展开查询结果窗格以查看更多日志条目。
  21. 调整时间范围:您可以通过调整手柄来更改用于查询的时间范围。调整手柄后,点击运行以更新查询中使用的时间范围。
  22. 优化范围:允许您仅使用当前项目中的日志或者一个或多个存储视图来缩小搜索范围。

  23. 固定日志条目:允许您将日志条目固定到查询结果直方图窗格。根据查询结果窗格的配置方式,Logging 将日志固定到查询结果窗格的顶部或底部。

  24. 复制指向日志条目的链接:允许您共享日志条目的链接。

  25. 直方图视口:可让您查看当前显示在查询结果窗格中的日志的时间范围。

在查询结果窗格中,您可以点击某个字段的值来选择执行以下操作:

  1. 显示匹配条目:允许您查询匹配的日志条目。
  2. 隐藏匹配条目:允许您查询与所选表达式不匹配的日志条目。
  3. 向摘要行添加字段:允许您将字段作为摘要行添加到日志条目中。

选择字段值之后的选项

优化范围

您可以通过优化范围面板优化日志浏览器中显示的日志的范围。您可以选择仅在当前项目中搜索日志,也可以根据一个或多个存储视图搜索日志。

如需优化日志浏览器的范围,请完成以下步骤。

  1. 从“日志记录”菜单中选择日志浏览器

    转到日志浏览器

  2. 选择优化范围

  3. 优化范围面板上,选择范围选项。

    “优化范围”面板

    • 按项目确定范围可让您搜索当前项目生成的日志。

    • 按存储空间确定范围允许您根据一个或多个存储视图搜索日志。

  4. 如果您选择按存储空间确定范围,请选择要查看的一个或多个存储分区。

    该面板列出了满足以下条件的存储视图:

    • 用户拥有对该存储视图的访问权限。
    • 这些存储分区属于所选项目,或者所选项目已路由到了日志存储分区。
  5. 点击应用

添加摘要字段

摘要字段可让您更快地发现日志中的模式。例如,下图显示了在包含相应值的日志前添加的摘要字段 resource.labels.pod_name 的值。

日志浏览器显示的日志带有显示 pod 名称的绿色文本前缀。

在日志条目中添加摘要字段

要向日志条目添加摘要字段,请完成以下步骤:

  1. 点击展开按钮 展开日志条目。

  2. 点击某个字段的值,然后选择向摘要行添加字段

    摘要字段现在会显示在包含该字段的日志条目之前。

使用配置按钮添加摘要字段

要使用配置按钮添加摘要字段,请完成以下步骤:

  1. 点击配置,然后选择管理摘要字段

    从“配置”下拉菜单中选择“管理摘要字段”

  2. 添加字段。

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

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

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

  3. 点击截断摘要字段即可以缩短显示摘要字段值。然后选择截断字段之前显示的字符数,以及是否显示字段的开头或结尾。

  4. 点击应用

    摘要字段现在会显示在包含该字段的日志条目之前。

“日志字段”面板

日志字段面板可提供日志数据的简明摘要,并提供了一种更高效的查询优化方法。它会显示给定日志字段的日志条目计数(按递减顺序排序)。日志字段计数与直方图面板所用的时间范围对应。

系统会根据执行的查询填充并更新日志字段。 如果存在空查询,日志字段面板会按资源类型和日志严重性字段显示日志条目的计数。

“日志字段”面板显示日志字段数据。

使用“日志字段”面板

您可以将日志字段面板中的字段添加到查询构建器中,以缩小查询范围和优化查询。为此,请在日志字段面板中点击一个字段值。这会将该日志字段添加到查询构建器中,并通过使用 AND 运算符将其作为表达式添加到原始查询来自动运行查询。

在运行查询时,会随着日志条目的扫描进度而增量加载日志字段计数。查询完成后(以蓝色进度条终止表示),您将看到所有日志字段的总计数。

“直方图”面板

您可以通过“直方图”面板查看日志随时间的分布情况。这让您可以更轻松地查看日志数据趋势并进行问题排查。

启用“直方图”面板

要启用“直方图”面板,请选择页面布局,然后选中直方图复选框。此时会显示直方图面板。

“页面布局”处于打开状态,且“直方图”已选中

要停用“直方图”面板,请清除直方图复选框。

使用“直方图”面板

每当您运行查询时,系统都会生成直方图。该直方图会显示选定时间范围内匹配日志条目的频率。

分析日志

如需分析日志数据,请将鼠标光标悬停在直方图面板的控件栏上,然后选择跳转到指定时间,以便选择更小的时间范围。这会在该选定的时间范围内运行新的查询。

日志直方图,显示了用于跳转到指定时间的弹出式对话框

直方图面板包含一个视口,反映了查询结果窗格中显示的日志的时间范围。视口可帮助您熟悉您当前在查询的更大时间范围内查看的日志。

视口的大小取决于查询结果窗格中显示的日志条目的最大值和最小值 timestamp 之间的时间长度。

直方图面板显示视口。

跟踪记录数据

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

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

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

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

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

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

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

固定日志

通过固定日志,您可以突出显示感兴趣的日志条目。如要固定日志,请将鼠标悬停在要固定的日志上,然后选择固定图标 。固定某日志条目后,其背景颜色会变暗,并且会显示一个固定图标

固定日志并重新运行查询时,固定的日志会显示在查询结果窗格的顶部或底部,具体位置取决于日志的配置方式。根据固定日志的 timestamp直方图窗格上还会显示固定图标。

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

如要为该日志取消固定,请选择固定图标,然后选择取消固定日志条目

在其资源上下文中查看固定日志条目

您可以在其资源上下文中查看固定的日志,以便查看固定日志周围与固定日志具有相同资源类型的日志条目。

如需查看其资源上下文中的固定日志,请选择固定图标 ,然后选择固定并显示资源日志条目

选择在资源上下文中固定并显示资源。

Logging 会使用固定日志中的资源类型填充查询构建器,然后运行查询。现在,您可以查看与其资源类型相关的固定日志。

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

使用直方图窗格,您可以选择固定日志,然后选择缩放到日志条目以缩小直方图的时间范围窗格。这使您可以优化查询,以隔离已固定日志附近的日志。

直方图的时间范围已缩小。

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

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

正在下载日志

您可以下载 CSV 或 JSON 格式的日志。您需要以下角色才能下载日志:

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

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

  1. 选择操作,然后选择下载日志

    使用“操作”按钮下载日志。

  2. 在“下载日志”对话框中,选择 CSV 或 JSON 格式,然后选择将日志下载到计算机或云端硬盘,或者在新标签页中查看日志。

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

问题排查

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

选择一个 Cloud 项目或组织

要从 Google Cloud Console 中的任何位置(包括日志浏览器在内)选择 Cloud 项目,请使用项目和组织选择器:

已从下拉菜单中选择了一个项目

获取 Cloud 项目 ID 或组织 ID

要从 Google Cloud Console 中的任何位置获取 Cloud 项目 ID 或组织 ID,请展开项目和组织选择器中的项目列表,然后在 ID 列中找到项目 ID:

显示项目 ID 的界面

看不到日志条目

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

  • 是否选择了正确的项目?如果选择不正确,请从项目和组织选择器中选择正确的项目。

  • 您的项目是否使用了生成日志的资源,这些资源上是否有活动?即使是新项目,也应该有记录该项目已创建的审核日志。转到受监控的资源列表页面中的“将服务映射到资源类型” 部分,确认您使用的是会生成日志的资源。

  • 时间范围是否过窄?确认您的查询中的时间范围正确无误。

  • 查看当前的排除项查询,确保您所查找的日志不会被意外排除。

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

  • 您无法看到早于 Logging 保留期限的日志条目。如需了解有效的日志保留期限,请参阅日志保留期限

  • 在高负载时段内,将日志发送到 Logging 或者接收及显示日志的过程可能存在延迟。

  • 日志浏览器不会显示带有未来时间戳的日志条目,直到当前时间“赶上”这些时间戳后才会显示。这种情况并不常见,可能是由发送日志的应用中的时间偏差引起的。

获取支持

如需了解如何获取支持,请参阅 Google Cloud 的运维套件支持页面