监控和规划主机维护事件

每个虚拟机 (VM) 实例或裸金属实例都使用主机维护政策来确定实例在维护操作期间的行为。某些实例提供了提前查看维护时间表的附加选项。

本页面介绍了如何监控和规划 Compute Engine 实例上的主机维护事件。

准备工作

• 如果您尚未设置身份验证，请进行设置。身份验证是通过其进行身份验证以访问 Google Cloud 服务和 API 的过程。如需从本地开发环境运行代码或示例，您可以通过选择以下选项之一向 Compute Engine 进行身份验证：
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  如需在本地开发环境中使用本页面上的 REST API 示例，请使用您提供给 gcloud CLI 的凭据。

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  如需了解详情，请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。

所需的角色

如需获得创建实例和管理实例维护所需的权限，请让管理员向您授予项目的以下 IAM 角色：

• Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1)
• 如需对系统事件审核日志拥有只读权限，请使用以下角色： Logs Viewer (roles/logging.viewer)

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

这些预定义角色已包含创建实例和管理实例维护所需的权限。如需查看所需的确切权限，请展开所需权限部分：

您也可以使用自定义角色或其他预定义角色来获取这些权限。

限制

仅当实例使用以下某个机器系列的机器类型时，您才能查看该实例即将进行的维护事件通知：

• 加速器优化机器家族：

  • A3

  • A2

  • G2

• 通用机器家族：

  • C4A

  • C4

  • C3D

  • C3

• 内存优化机器家族：

  • X4

  • M3

  • M2

  • M1

• 存储优化机器家族：

  • Z3

维护通知概览

Google 会通过多种方式发送有关即将进行的主机维护的通知。当维护窗口打开时， Google Cloud 会自动对实例执行维护。通过监控实例即将进行的维护窗口，您可以主动准备工作负载以处理即将进行的维护，同时将中断降至最低。

这些支持维护事件通知的计算实例具有以下特征：

• 维护事件较少：通常，具有周期性维护间隔的实例的维护事件应该较少。
• 维护通知较长：提前收到维护事件通知，以便进行规划。
• 监控和规划：使用 Cloud Logging 跟踪维护时间表。使用突发事件和提醒随时了解最新动态。
• 按需维护控制：在通知期内开始维护，以便在合适时间更新实例。

有关即将发生的通知事件的信息以类似于以下方式显示：

upcomingMaintenance:{
    "canReschedule":True
    "latestWindowStartTime": "2024-12-01T19:00:01Z"
    "machineType":"x4-megamem-960-metal"
    "maintenanceStatus":"PENDING"
    "type":"SCHEDULED"
    "windowEndTime": "2024-12-01T22:00:00Z"
    "windowStartTime": "2024-12-01T19:00:00Z"
}

如果没有即将进行的维护事件，您会看到类似以下的消息：

{ "error": "no notifications have been received yet, try again later" }

维护状态定义

以下状态定义说明了对实例主机维护查询的响应。它们提供了与维护事件相关的信息。Google Cloud CLI、REST 和元数据服务器都使用相同的响应格式：

• canReschedule：是否可以在此实例的通知期内手动启动维护。
  • TRUE：可以在通知期内执行客户触发的维护。
  • FALSE：无法对此实例执行客户触发的维护。这通常在实例进行维护期间发生，或者如果实例类型不支持按需维护，也会发生这种情况。
• latestWindowStartTime：维护窗口可移至的最晚时间。
• machineType：实例的机器类型，例如 x4-megamem-960-metal 或 c4-highmem-192。
• maintenanceStatus：维护事件的当前状态。
  • ONGOING：维护操作正在进行中。
  • PENDING：维护操作已安排，但尚未开始。
• type：要执行的维护类型。
  • NONE：未安排对此实例进行维护。
  • SCHEDULED：对于中断性维护，Compute Engine 会提前至少 7 天向大多数实例发出通知；X4 实例会提前大约 60 天收到通知。
  • UNSCHEDULED：由于维护代表关键更新，因此 Compute Engine 会尽可能提前通知，但通常比计划维护事件提前通知的时间要短得多。
• windowEndTime：发生维护的时段的结束时间。
• windowStartTime：发生维护的时段的开始时间。

维护状态行为

管理维护事件时，请检查 canReschedule 和 maintenanceStatus 的值。这些字段结合起来可指示您是否可以执行某些操作来重新安排维护事件：

• canReschedule=True 和 maintenanceStatus=Pending - 您可以在预定开始时间之前手动为实例启动维护事件。
• canReschedule=False 和 maintenanceStatus=Ongoing - 维护工作正在进行中，无法重新安排。
• canReschedule=False 和 maintenanceStatus=Pending - 您的实例不支持手动触发的维护事件。

查看维护通知

您可以通过查询计算实例、元数据服务器或使用 Cloud Logging 来查找维护通知。

检查实例是否有维护事件通知

使用 Google Cloud CLI、REST 或查询元数据服务器，查看您的实例是否有即将发生的主机维护事件。

gcloud compute instances describe INSTANCE_NAME \
   --zone=ZONE_NAME --format="yaml(resourceStatus.upcomingMaintenance)"

  resourceStatus:
    upcomingMaintenance:
      canReschedule: true
      latestWindowStartTime: '2025-01-15T12:00:01Z'
      machineType: x4-megamem-960-metal
      maintenanceStatus: PENDING
      type: SCHEDULED
      windowEndTime: '2025-01-15T16:00:00Z'
      windowStartTime: '2025-01-15T12:00:00Z'

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME

  upcomingMaintenance:{
    "canReschedule":True
    "latestWindowStartTime": "2023-12-01T19:00:01Z"
    "machineType": "x4-megamem-960-metal"
    "maintenanceStatus":"PENDING"
    "type":"SCHEDULED"
    "windowEndTime": "2023-12-01T22:00:00Z"
    "windowStartTime": "2023-12-01T19:00:00Z"
  }

$ curl http://metadata.google.internal/computeMetadata/v1/instance/upcoming-maintenance?alt=json -H "Metadata-Flavor: Google"

检查 Cloud Logging 是否存在维护事件通知

Compute Engine 会在 Cloud Audit Logs 中为实例创建系统事件，以记录维护事件。您可以使用 Cloud Logging 和 Logs Explorer 在维护事件发生前、发生期间和发生后查看这些事件。

维护通知示例

Logs Explorer 中会显示实例的维护事件通知，其中的值类似于以下内容：

• methodName："compute.instances.upcomingMaintenance"
• metadata：
  • maintenanceStatus："PENDING"
  • machineType："x4-megamem-960-metal"
  • windowStartTime："2024-07-23T20:00:00Z"

当维护事件开始时，日志中会显示一项新的信息事件，其中的值类似于以下内容：

• methodName："compute.instances.upcomingMaintenance"
• metadata：
  • maintenanceStatus："ONGOING"
  • machineType："x4-megamem-960-metal"
  • windowStartTime："2024-07-23T20:00:00Z"

在维护事件期间，系统会根据实例的主机维护策略配置，将以下某个系统事件记录到审核日志中：

• 对于配置为在维护事件期间使用实时迁移的实例，系统将记录包含 methodName: "compute.instances.migrateOnHostMaintenance" 的系统事件。
• 对于配置为在维护事件期间终止的实例，系统将记录包含 methodName: "compute.instances.terminateOnHostMaintenance" 的系统事件。

维护事件结束后，审核日志中会显示一个新的信息事件，其中的值类似于以下内容：

• methodName："compute.instances.upcomingMaintenance"
• status: { message: "Maintenance window has completed for this instance. All maintenance notifications on the instance have been removed." }

为主机维护通知配置提醒

您可以设置基于日志的提醒政策，以搜索特定的维护通知事件，并使用通知渠道发送提醒。

如需了解详情，请参阅配置基于日志的提醒以及创建和管理通知渠道。

后续步骤

• 了解如何设置主机维护政策。
• 了解如何获取实时迁移通知。
• 了解如何手动触发主机维护事件
• 了解如何使用 Google Cloud 控制台或 Monitoring API 管理基于日志的提醒政策。