在自定义信息中心内显示日志和错误

本文档介绍了您可以添加到自定义信息中心的微件 以便在与数据库服务器相同的环境中查看日志和错误数据 指标数据。日志面板微件 显示日志条目。错误报告面板微件 显示最近的错误组。以上两者皆可 微件可提供在问题排查时可能有用的信息。 Log Analytics“图表”微件 显示 SQL 查询的结果， 可让您确定日志数据中的趋势。

日志浏览器和日志面板 widget

日志浏览器是调查日志的标准方式。 将日志面板微件添加到信息中心不会改变您使用 Logs Explorer由于日志面板微件可以添加到 自定义信息中心，它们提供了一种 在指标所在的上下文中查看日志条目。

日志浏览器和日志面板微件支持 相同的查询语言，并且都只显示 您有权查看的日志条目。您的 对存储日志条目的资源使用 Identity and Access Management (IAM) 角色 用于确定您是否可以查看这些日志条目。

日志浏览器和日志面板微件都预先配置为 从日志存储分区提取 Google Cloud 项目，或者路由到当前项目的项目。 您可以配置提取哪些日志条目。例如，您可以 指定从日志视图提取日志条目以显示。

日志面板微件每行显示一个日志条目， 其中包含严重性列、时间戳和 摘要。查看 JSON 格式的日志表示法 点击查看日志详细信息按钮。 每个条目摘要的结构因日志类型而异。例如： 下图显示了两个日志条目：

在上图中，第一个日志条目显示 服务请求的相关信息摘要会显示 服务、电子邮件地址以及字符串格式版本的 条目的 JSON 结构。 第二个条目显示请求的结果， 仅显示一个总结发生的操作的句子。

如需了解有关 Cloud Logging 的一般信息，请参阅以下资源：

• 基本概念
• 日志记录查询语言
• 日志浏览器

准备工作

如需获取将日志面板微件添加到自定义信息中心所需的权限，请使用 Google Cloud 控制台，以及将其配置为显示项目中的日志条目 还是在日志视图中 请让管理员向您授予 以下 IAM 角色：

• Monitoring Editor (roles/monitoring.editor) 项目权限
• Logging Viewer (roles/logging.viewer) 针对您想要查看其日志条目的每个项目的 开启 。此角色不会授予您对每个日志条目的访问权限。如需详细了解这些角色，请参阅使用 IAM 进行 Cloud Logging 访问权限控制。
• 日志查看访问器 (roles/logging.viewAccessor) 为每个项目（用于存储您要访问的日志视图的日志存储桶）上的资源。Logs View Accessor 角色可授予对项目存储的所有日志视图的访问权限。如需了解如何获取对特定日志视图的访问权限，请参阅控制对日志视图的访问权限。

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

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

在信息中心上显示日志条目

本部分介绍如何使用 Google Cloud 控制台如需了解如何使用 Cloud Monitoring API，请参阅 包含 LogsPanel widget 的信息中心。

日志面板微件已预先配置为提取 这些项目来自您的 Google Cloud 项目， Google Cloud 项目。不过，您可以配置要将哪些日志条目 从日志存储分区提取的日志面板 widget。例如，您可以 将 widget 配置为仅显示日志条目 指示某种类型的错误情况或 日志视图

信息中心最多可容纳 40 个微件。

如需使用控制台将日志面板微件添加到信息中心，请执行以下操作： 执行以下操作：

1. 在 Google Cloud 控制台中，转到 信息中心页面：

   前往信息中心

   如果您使用搜索栏查找此页面，请选择子标题为监控的结果。

2. 选择一个信息中心，或点击创建信息中心。
3. 在工具栏中，点击  添加微件。
4. 在 Add widget 对话框中，选择  Logs。
5. 可选：要更新标题，请在 widget title 字段中提供。

6. 可选：如需修改提取哪些日志条目，请执行以下操作： 执行以下任一操作：

   • 如需从其他项目或多个项目提取日志条目，请执行以下操作： 请在 Project 条目中找到所有项目， 展开 Current project，然后完成 对话框。菜单列出了所有 Google Cloud 项目 当前指标范围内的用户数量

     如果菜单中的条目包含 "您没有项目级权限，无法查看此项目中的日志", 则表示你没有查看 Google Cloud 项目的日志条目。

   • 提取日志视图中包含的日志条目 执行以下操作：

     1. 在 Scope by 条目中，展开 Project， 然后选择存储。
     2. 在存储视图条目中，展开 当前项目，然后完成对话框。 该菜单列出了以下位置中日志存储分区的日志视图： Google Cloud 项目。选择日志存储分区上的日志视图 在其他 Google Cloud 项目中 点击 导入项目， 选择项目，然后选择一个或多个日志视图。 您只能导入项目 当前指标范围中包含的指标
     注意： 当前用户无权访问 日志面板微件搜索日志条目的日志视图， 该 widget 将显示错误。如需了解详情，请参阅 日志面板显示权限遭拒的消息。

7. 可选：如需限制日志面板 widget 显示哪些日志，请执行以下操作： 在查询编辑器字段中输入一个查询；如果您停用了 不再自动运行查询，请点击运行查询。 有关查询的简要介绍，请参阅 查询示例。

8. 可选：将模板变量应用于日志面板 widget。有关 请参阅 向自定义信息中心添加永久过滤条件。

9. 要将更改应用到信息中心，请在工具栏中执行以下操作： 点击应用。如需舍弃更改，请点击取消。

10. 要保存修改后的信息中心，请点击工具栏中的保存。

    日志面板 widget 显示提取的日志表 与您的查询相匹配的条目。您还可以使用微件的过滤器 临时更改微件显示的日志条目。 有关详情， 过滤日志条目。

查询示例

要填充查询编辑器字段，您可以在字段中输入文本，也可以从菜单中选择。查询编辑器字段使用与日志浏览器相同的查询语言。如需了解问题排查信息，请参阅语法问题。

严重级别和日志名称菜单允许您选择多个选项。以下是与多个严重级别匹配的查询语句示例：

severity=(WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY)

通过资源菜单，您可以按资源过滤。您可以选择 某个资源类型（例如 Audited Resource） 窗口来选择特定方法。

例如，如需添加针对 Audited Resource 的查询，请执行以下操作：

1. 展开资源菜单。
2. 搜索并选择 Audited Resource。

3. 点击应用。

   以下步骤会将以下子句添加到查询编辑器 字段：

   resource.type="audited_resource"
   

同样，如需为 Cloud Functions 审核日志添加查询，请执行以下操作： 以下：

1. 展开资源菜单。
2. 搜索并选择 Audited Resource。
3. 在“服务”菜单中，选择 Cloud Functions。

4. 点击应用。

   以下步骤会将以下子句添加到查询编辑器 字段：

   resource.type="audited_resource" resource.labels.service="cloudfunctions.googleapis.com"
   

过滤日志条目

您可以通过修改 以下字段或菜单的值：

• 信息中心时间选择器：日志面板 widget 仅检索 与集群内 按此字段指定的时间间隔写入。

• 过滤条件字段： 系统会应用您指定的过滤条件 在查询完成后运行系统仅会为 当前会话

• 日志面板微件上的严重性菜单：按严重性等级进行过滤 将在查询完成后应用系统会保留此字段的值 仅限当前会话使用

• 针对日志面板微件的查询：日志面板微件会显示 系统仅显示与查询匹配的日志条目 如果您不指定查询 所选的时间间隔如果您指定了查询 日志面板微件会显示一个显示查询 图标，将当前查询以提示的形式显示。

  如需修改查询，请修改日志面板 widget。

• 日志面板微件上的 Google Cloud 项目：如需修改此设置，请执行以下操作： 修改日志面板 widget。

• 信息中心过滤条件：存在信息中心过滤条件时，过滤条件设置 应用于对日志面板 widget 的查询。 例如，如果您将 信息中心过滤条件 cluster_name: mycluster，则查询为 已更新为包含 resource.labels."cluster_name"="mycluster"。 如需详细了解信息中心过滤条件，请参阅 添加临时过滤器并 添加永久过滤条件。

本部分的其余内容提供了有关如何 过滤日志条目。

示例：按日期过滤日志条目

如需在日志面板微件中显示最新日志，请使用时间字段 。 例如，选择 1 小时。如果您没有选择自定义时间范围 该微件始终会显示最新日志，即使 早于所选时间范围。

调查突发事件时，您可能希望将日志条目限制为特定时间段内的条目。要将日志条目配置为显示固定时间段内的日志，请执行以下一项或两项操作：

• 使用时间范围选择器选择时间范围。
• 在配置窗格的查询编辑器字段中输入 timestamp 子句，然后选择应用过滤条件。

指定时间间隔后，系统不会自动显示日志面板微件 刷新之后。

示例：按严重性过滤日志条目

在监控对失败情况的调试时，您可能只想查看错误消息，并在显示结果中隐藏所有其他日志条目。如需配置日志面板微件，使其仅显示 满足特定严重级别要求，请执行以下一项或两项操作：

• 要应用临时过滤条件，请在以下位置为严重程度菜单选择一个值： 日志面板微件此菜单指定最低严重级别。例如，“警告”值会使系统检索严重级别为“错误”的日志条目，但不会检索严重级别为“通知”的日志条目。默认情况下，此字段的值设置为 Default，即包括所有日志条目。

  当您离开信息中心时，严重级别菜单的设置将被舍弃。

• 如需应用永久过滤条件，请在配置窗格的查询编辑器字段中输入 severity 子句，然后选择应用过滤条件。

示例：按字符串或短语过滤日志条目

通过按特定字符串或短语过滤日志条目，您可以从视图中排除不感兴趣的日志条目。例如，如需查看包含特定电子邮件地址的日志条目，您可以按该地址进行过滤。

• 如需应用临时过滤条件以仅查看包含特定字词或短语的日志条目，请使用 过滤条件字段。include-test 不区分大小写。

  如果您添加多个过滤条件，则仅显示匹配所有过滤条件的日志，因为相邻过滤条件之间插入了隐式 AND。不过，您 可以明确插入 OR 运算符：

  • 例如，如果添加过滤条件 Get 和 Compute，将显示同时包含这两个字词的日志条目。

  • 例如，如果添加过滤条件 Get、OR 和 Compute，将显示包含 Get 或 Compute 的日志条目。

  过滤条件字段的值不是永久的。

• 如需应用永久过滤条件，请修改存储在查询编辑器字段中的查询，然后选择应用过滤条件。如需了解查询语法，请参阅 Logging 查询语言。

  例如，如需仅显示 MESSAGE 字段包含字符串“lamp”的日志条目，请将子句 jsonPayload.MESSAGE:"lamp" 添加到查询编辑器 字段。

在日志浏览器中查看日志条目

日志面板微件会显示日志条目的关键字段，但它们不会显示 完整的日志条目。如需检查日志条目的所有字段，请执行以下操作：

1. 在日志面板微件中，选择在日志浏览器中查看。

2. 在对话框中，选择要在其中打开日志浏览器的 Google Cloud 项目。

   系统会在新的浏览器标签页中打开日志浏览器，并显示您之前使用的过滤条件 在日志面板微件中选择的自动应用。

3. 选择要查看的日志条目。

显示通过 Log Analytics 查询生成的图表

预览

此功能须遵守服务专用条款的“通用服务条款”部分中的“非正式版产品条款”。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

本部分介绍了如何配置和保存根据 将 Log Analytics 查询发送到自定义信息中心。借助 Log Analytics， 使用 SQL 查询搜索和汇总日志以生成有用的数据分析。

除了使用“Log Analytics”页面配置和保存图表外 信息中心，您可以保存 Log Analytics 图表 直接在 Monitoring 中执行以下操作：

1. 在 Google Cloud 控制台中，转到 信息中心页面：

   前往信息中心

   如果您使用搜索栏查找此页面，请选择子标题为监控的结果。

2. 选择一个信息中心，或点击创建信息中心。
3. 在工具栏中，点击  添加微件。
4. 在添加微件对话框中，前往数据部分，然后 然后选择 Log Analytics。
5. 在配置微件面板中，配置要在 创建图表，然后点击运行查询。

6. 可选：在结果标签页中，按以下条件自定义图表配置： 使用显示面板。

   在显示面板中，您可以更改图表类型，并自定义图表类型 通过更改维度、测量值和 细分：

   • 维度： 维度必须是时间戳、数字或字符串列。默认情况下，该维度设置为 架构中基于时间戳的第一个列。如果查询中没有时间戳，则 选择第一字符串列作为维度。您还可以自定义维度 图表显示面板中的“添加日期”按钮。选择时间戳列作为维度后，图表将 可以显示数据如何随时间变化。

   • 衡量： 您可以在“图表显示”面板中选择多个测量值。选择测量后 还必须选择聚合函数，以对其分组值执行，例如 count、sum、average和percentile-99。 例如，count-distinct 会返回给定列中的唯一值数量。

   • 细分维度： 若要根据另一列将单个数据系列拆分为多个数据系列，请添加细分。

   如需详细了解如何自定义图表配置，请参阅 自定义图表配置。

7. 要保存修改后的信息中心，请点击工具栏中的保存。

您还可以在 Log Analytics 图表保存到信息中心后对其进行修改。 如需了解详情，请参阅 修改 widget 的配置。

在信息中心显示错误

本部分介绍如何使用 Google Cloud 控制台如需了解如何添加 使用 Cloud Monitoring API 将错误报告面板添加到信息中心，请参阅 包含 ErrorReportingPanel widget 的信息中心。

如需使用控制台将错误报告面板添加到信息中心，请执行以下操作：

1. 在 Google Cloud 控制台中，转到 信息中心页面：

   前往信息中心

   如果您使用搜索栏查找此页面，请选择子标题为监控的结果。

2. 选择一个信息中心，或点击创建信息中心。
3. 在工具栏中，点击  添加微件。
4. 在添加微件对话框中，转到可视化部分，然后 然后选择 Error Reporting 面板。
5. 选择要显示其错误组的项目， 展开 Projects，然后进行选择。
6. 可选：更新标题。

7. 可选：要限制显示错误的资源， 执行以下操作：

   1. 展开 所有资源，然后选择一项资源。

   2. 选择资源后，您可以选择应用，也可以 请使用其他菜单优化过滤条件：

      • 如需显示 App Engine 资源的错误，请选择 GAE 服务，然后点击应用。

      • 要显示特定 App Engine 服务的错误，请选择 GAE 服务，选择相应服务，然后点击应用。

8. 要将更改应用到信息中心，请在工具栏中执行以下操作： 点击应用。如需舍弃更改，请点击取消。

   以下示例展示了一个错误报告面板：

   

9. 要保存修改后的信息中心，请点击工具栏中的保存。

问题排查

• 日志面板表明其显示部分数据
• 日志面板报告无效查询
• 日志面板显示“找不到条目”消息

后续步骤

• 了解 Cloud Monitoring 如何提供指标可见性 和存储在多个 Google Cloud 项目中的日志，请参阅 指标范围概览。

• 了解如何配置信息中心以显示日志或错误 请参阅以下内容：

  • 包含 LogsPanel widget 的信息中心。
  • 包含 ErrorReportingPanel widget 的信息中心。

• 如需详细了解错误组，请参阅 Error Reporting 概览。