在信息中心内显示事件

本文档介绍了如何配置信息中心以显示事件注释。事件是指影响系统运行的活动，例如部署或崩溃。在排查问题时，显示事件注释有助于您将来自不同来源的数据关联起来。

事件注释简介

您可以在 Google Cloud 控制台的信息中心页面中列出的大多数信息中心内显示事件。同样，您可以配置一些特定于服务的可观测性标签页（例如 Compute Engine 和 Google Kubernetes Engine 的标签页），以显示事件。如需配置信息中心或可观测性标签页中显示的事件类型，您可以使用 Google Cloud 控制台。对于您创建的信息中心（被归类为自定义信息中心），您还可以使用 Cloud Monitoring API。

除非您使用 Cloud Monitoring API 或执行操作来保存事件类型选择，否则您的选择仅适用于当前会话。使用 Google Cloud 控制台时，固定所选内容可将其保存下来。

如需查看事件类型列表、问题排查参考和其他信息，请参阅事件类型页面。

即使您未选择任何事件类型，也可能会在信息中心或可观测性标签页中看到以下已启用的事件类型：

自动添加的事件类型属于推荐事件类型。 您可以让这些事件类型保持推荐状态，将其保存到信息中心 JSON，或将其忽略（这会移除相应建议）。如需确定系统会保存哪些事件类型，请展开注释菜单，然后查看已固定部分。

如何识别事件

信息中心会查询不同的数据源，以确定要在信息中心内显示的事件：

  • 提醒事件由 Monitoring 标识。提醒事件会提供有关突发事件何时打开的信息。

  • Personalized Service Health 事件由 Monitoring 发送到 Service Health API 的查询标识。这些事件会指明 Google Cloud 服务何时出现中断。

  • 系统会通过分析通过 Google Cloud 项目中的 Cloud Logging 接收器传输的日志条目来识别所有其他事件类型。这些日志条目包括由您的项目生成的日志条目，以及转送到您的项目的日志条目。如需在发生上述任一事件时收到通知，您可以创建基于日志的提醒政策。在提醒政策中，使用事件类型页面上提供的查询。

事件的显示方式

对于所有事件，系统都会在事件发生时在信息中心的图表中添加注释。通过分析日志条目识别的事件会显示单个时间参考值。相反，Service Health 状况事件会显示开始时间，然后图表的背景会在事件持续期间发生变化。这些活动还会显示一个心形图标。

以下屏幕截图显示了一个图表，其中显示了通过分析日志条目识别出的多个事件和一个服务运行状况事件：

显示警告和信息事件注释的图表。

如上图所示，事件的提示包含以下信息：

  • 事件名称。
  • 活动的日期和开始时间。
  • 对于服务运行状况事件，显示受影响产品和位置数量的条状标签。如需列出受影响的商品或地区，请将光标放在相应的条状标签上。
  • 查看按钮。选择此按钮后，系统会打开一个页面，其中显示与事件有关的更多信息。例如，它可能会打开日志浏览器，以便您查看日志条目，或者它可能会打开 Service Health 事件的详情页面。

信息中心过滤器用于限制信息中心显示的数据，通常会同时过滤时间序列数据和事件。

准备工作

  • 如需获得在信息中心查看和显示事件以及创建提醒政策所需的权限，请让管理员向您授予项目的以下 IAM 角色：

    • 查看和创建信息中心和提醒政策：Monitoring Editor (roles/monitoring.editor)。
    • 查看和显示从 Google Cloud 项目中创建的非数据访问日志条目中识别出的事件： 日志查看器 (roles/logging.viewer)。
    • 查看和显示从 Google Cloud 项目中创建的任何日志条目中识别出的事件： 非公开日志查看器 (roles/logging.privateLogViewer)。
    • 查看服务运行状况事件：Personalized Service Health viewer (roles/servicehealth.viewer)

    如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

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

  • 如果您想在信息中心内显示服务运行状况事件，请启用 Service Health API：

    Enable the API

显示事件

本部分介绍如何配置信息中心或可观测性标签页以显示事件。

配置信息中心以显示事件

本部分介绍了如何配置 Google Cloud 控制台的信息中心页面中列出的信息中心，以显示事件。

如需查看可与日志浏览器或基于日志的提醒政策搭配使用的事件类型、问题排查参考和查询的列表，请参阅事件类型页面。

控制台

如需在信息中心内显示事件，请执行以下操作：

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

    前往信息中心

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

  2. 选择要查看的信息中心。
  3. 在信息中心的工具栏中，点击 注释，然后选择您希望信息中心显示的事件类型。

  4. 执行下列其中一项操作：

    • 如需保存您的选择，以便在您重新加载信息中心时显示事件，请点击固定所选。如果您已在信息中心内停用自动保存功能，请前往信息中心的工具栏，然后点击保存。

      固定所选内容时，您会修改信息中心的 JSON 定义。因此，当重新打开信息中心时，系统会加载您的选择，并且信息中心会显示相应事件类型的注释。

    • 如需仅显示当前会话的事件类型，请点击应用。

    更新要显示的事件类型列表后，Cloud Monitoring 会发出查询（需要几分钟时间），然后将注释添加到信息中心的图表中。

  5. 如需查看事件摘要或访问指向更多信息的链接，请使用指针激活提示。

API

如需将自定义信息中心配置为显示事件，请在 Dashboard 对象中添加 annotations 字段。annotations 字段包含 DashboardAnnotations 对象的实例，该实例包含两个字段：

  • defaultResourceName 字段列出了 Google Cloud 项目用于搜索事件的 Dashboard 级默认值。如果您未指定此字段，系统会搜索您选择的项目。

  • EventAnnotation 对象数组。每个对象都包含以下内容：

    • displayName 字段，用于定义特定于事件的切换开关上的标签。如果未指定此字段或此字段的值为空字符串，系统会显示事件的默认名称。
    • 一个 enabled 字段，用于控制事件切换开关的值。当 true 时，切换开关处于 on 位置，并且事件会显示在信息中心内。当 false 时，开关处于 off 位置。
    • eventType 字段，其中包含 EventType 枚举中的值。
    • filter 字段，用于指定要附加到特定事件查询的查询。如果此字段的值为空字符串，则系统会使用特定于事件的查询。
    • resourceNames 字段，用于定义要搜索事件的 Google Cloud 项目列表。如果此字段为空数组，系统会搜索您选择的项目。

以下是集群更新事件的 annotations 对象示例。在此示例中，filter 字段会将事件限制为特定集群：

"annotations": {
  "defaultResourceNames": [],
  "eventAnnotations": [
    {
      "displayName": "",
      "enabled": true,
      "eventType": "GKE_CLUSTER_UPDATE",
      "filter": "resource.labels.cluster_name=my-cluster",
      "resourceNames": []
    }
  ]
}

如需详细了解如何使用 Cloud Monitoring API 创建信息中心，请参阅通过 API 创建和管理信息中心以及示例：在信息中心上启用事件。

配置可观测性标签页以显示事件

本部分介绍如何配置可观测性标签页以显示事件。某些服务（例如 Compute Engine 和 Google Kubernetes Engine）提供了一个可观测性标签页，用于显示指标和日志数据。

控制台

如需配置可观测性标签页以显示事件，请执行以下操作：

  1. 前往服务或产品的可观测性标签页。

    例如，您可以前往 Kubernetes 集群页面，然后选择 Observability（可观测性）标签页。同样，您可以前往 Kubernetes 工作负载页面或虚拟机 (VM) 实例的详情页面，然后选择可观测性标签页。

  2. 确保信息中心菜单设置为预定义。事件无法显示在自定义信息中心中。

  3. 在工具栏中，点击 注释，然后完成对话框。

    更新要显示的事件列表后，系统会发出查询以检索事件数据，然后更新信息中心。

    如果未显示 Annotations 菜单，则无法将该标签页配置为显示事件。

API

不可用。

查看活动详情

当您查看显示事件注释的图表时，可以使用提示中提供的链接来获取更多信息。

如需查看特定事件的详细信息，请点击查看。

查看按钮打开的 Google Cloud 控制台页面取决于事件类型。例如，对于正常运行时间检查事件，此按钮会打开正常运行时间检查的信息中心。对于其他事件类型，系统可能会打开 Logs Explorer。

创建提醒政策

通过分析通过 Google Cloud 项目中的 Cloud Logging 接收器传输的日志条目来识别事件时，您可以通过配置基于日志的提醒，在这些事件发生时收到通知。基于日志的提醒政策会在收到日志条目时对其进行查询。当查询返回不为空的结果时，系统会创建突发事件并发送通知。

控制台

如需创建基于日志的提醒，请执行以下操作：

  1. 如果您尚未配置通知渠道，请执行以下操作：

    1. 在 Google Cloud 控制台中，转到 提醒页面：

      进入提醒

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

    2. 点击修改通知渠道。
    3. 前往您要配置的通知渠道类型，点击新增，然后完成对话框。

  2. 在 Google Cloud 控制台中，转到 Logs Explorer 页面。

    前往 Logs Explorer

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

  3. 在工具栏中，选择创建提醒。

  4. 输入提醒政策的名称，然后点击下一步。

  5. 在定义要发出提醒的日志条目部分中，输入查询或更新您在选择创建提醒时从查询窗格中复制的查询。

    对于每种事件类型，事件类型页面都会列出适合在基于日志的提醒政策中使用的查询。

  6. 完整填写对话框，然后点击保存。

API

如需使用 Cloud Monitoring API 创建基于日志的提醒政策，请执行以下操作：

  1. 确定要包含在提醒政策条件中的查询。对于每种事件类型，事件类型页面都会列出一个适合在基于日志的提醒政策中使用的查询。

  2. 创建一个包含提醒政策表示法的 JSON 文件。如需详细了解此步骤及相关示例，请参阅设计提醒政策。

  3. 调用 alertPolicies.create API 方法。 例如，您可以发出 gcloud alpha monitoring policies create 命令。

隐藏事件

控制台

如需隐藏所有事件，请在信息中心工具栏中依次点击 注释、清除和应用。

如需隐藏某种类型的事件，请点击 注释，取消选中相应事件类型，然后选择应用。

API

如需在自定义信息中心中隐藏某种类型的事件，请找到相应事件类型的 EventAnnotation 对象，然后将 enabled 字段设置为 false。

如需详细了解如何使用 Cloud Monitoring API，请参阅使用 API 创建和管理信息中心。

后续步骤