在信息中心内显示事件

本文档介绍了如何配置信息中心以显示事件注释。 事件是指影响系统运行的活动，例如部署或崩溃。显示事件注释有助于您 从不同来源获取数据。

事件注释简介

您可以在 Google Cloud 控制台的信息中心页面。 同样，您可以配置一些服务专用的 Observability 标签页， 例如用于 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 事件：

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

如上一张屏幕截图所示，事件的提示包括 例如：

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

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

准备工作

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

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

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

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

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

    Enable the API

显示事件

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

配置信息中心以显示事件

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

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

控制台

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

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

    前往信息中心

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

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

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

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

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

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

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

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

API

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

  • defaultResourceName 字段会列出 Google Cloud 项目用于搜索事件的控制台级默认值。如果您未指定此字段 则系统会搜索您所选的项目。

  • 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 集群页面，然后 选择可观测性标签页。同样，您可以前往 Kubernetes 工作负载页面或虚拟机 (VM) 实例的详情页面，然后选择可观测性标签页。

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

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

    在您更新要显示的事件列表后，系统会向 检索事件数据，然后更新信息中心。

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

API

不可用。

查看活动详情

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

如要查看特定活动的详细信息，请点击查看。

通过查看按钮打开的 Google Cloud 控制台页面取决于 事件类型。 例如，对于正常运行时间检查事件，此按钮会打开正常运行时间检查的信息中心。对于其他 事件类型，则日志浏览器可能会打开。

创建提醒政策

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

控制台

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

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

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

      进入提醒

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

    2. 点击 Edit notification channel。
    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 创建和管理信息中心。

后续步骤