日志查看器(预览版)界面

准备工作

除非您是要将 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 格式复制日志条目。

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

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

选择字段值之后的选项

添加摘要字段

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

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

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

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

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

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

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

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

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

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

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

  2. 添加字段。

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

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

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

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

  4. 点击应用

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

“日志字段浏览器”面板

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

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

使用“日志字段浏览器”面板

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

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

“直方图”面板

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

启用“直方图”面板

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

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

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

使用“直方图”面板

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

分析日志

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

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

问题排查

本部分介绍如何排查使用日志查看器(预览版)时的常见问题。

选择一个 Cloud 项目或组织

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

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

获取 Cloud 项目 ID 或组织 ID

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

显示项目 ID 的界面

看不到日志条目

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

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

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

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

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

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

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

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

获取支持

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