Supervisa y planifica un evento de mantenimiento del host

Cada instancia de máquina virtual (VM) o instancia de Bare Metal usa una política de mantenimiento del host para determinar el comportamiento de la instancia durante una operación de mantenimiento. Algunas instancias ofrecen la opción adicional de ver el programa de mantenimiento con anticipación.

En esta página, se explica cómo supervisar y planificar un evento de mantenimiento del host en las instancias de Compute Engine.

Antes de comenzar

• Si aún no lo hiciste, configura la autenticación. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
  

  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

  Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.

  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.

  Si deseas obtener más información, consulta Autentica para usar REST en la Google Cloud documentación de autenticación.

Roles obligatorios

Para obtener los permisos que necesitas para crear instancias y administrar el mantenimiento de instancias, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

• Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1)
• Para obtener acceso de solo lectura a los registros de auditoría de eventos del sistema, usa el Visualizador de registros (roles/logging.viewer).

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para crear instancias y administrar el mantenimiento de las instancias. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Limitaciones

Solo puedes ver las notificaciones del próximo evento de mantenimiento de una instancia si esta usa un tipo de máquina de una de las siguientes familias:

• Familias de máquinas con optimización de acelerador:

  • A3

  • A2

  • G2

• Familias de máquinas de uso general:

  • C4A

  • C4

  • C3D

  • C3

• Familias de máquinas con optimización de memoria:

  • X4

  • M3

  • M2

  • M1

• Familias de máquinas optimizadas para el almacenamiento:

  • Z3

Descripción general de las notificaciones de mantenimiento

Google envía notificaciones sobre el próximo mantenimiento del host a través de varios métodos. Cuando se abre el período de mantenimiento, Google Cloud realiza automáticamente el mantenimiento de tu instancia. Si supervisas los próximos períodos de mantenimiento de tu instancia, puedes preparar de forma proactiva tus cargas de trabajo para que controlen el próximo mantenimiento con la menor interrupción posible.

Las instancias de procesamiento que admiten notificaciones de eventos de mantenimiento tienen las siguientes características:

• Menos eventos de mantenimiento: En general, las instancias con intervalos de mantenimiento recurrentes deberían ver menos eventos de mantenimiento.
• Notificación de mantenimiento más prolongada: Recibe notificaciones de eventos de mantenimiento con mucha anticipación para planificar.
• Supervisión y planificación: Usa Cloud Logging para realizar un seguimiento del programa de mantenimiento. Usa los incidentes y las alertas para mantenerte informado.
• Control de mantenimiento a pedido: Inicia el mantenimiento durante el período de notificación para actualizar tus instancias cuando se ajusten a tu programa.

La información sobre un próximo evento de notificación se presenta de manera similar a la siguiente:

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"
}

Si no hay ningún evento de mantenimiento próximo, verás un mensaje similar al siguiente:

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

Definiciones del estado de mantenimiento

Las siguientes definiciones de estado explican las respuestas a las consultas sobre el mantenimiento del host de una instancia. Proporcionan información relacionada con el evento de mantenimiento. Google Cloud CLI, REST y el servidor de metadatos usan estas mismas respuestas:

• canReschedule: Indica si el mantenimiento se puede iniciar de forma manual durante el período de notificación de esta instancia.
  • TRUE: El mantenimiento activado por el cliente se puede realizar durante el período de notificación.
  • FALSE: No se puede realizar el mantenimiento activado por el cliente en esta instancia. Esto suele ocurrir durante el período en el que la instancia se encuentra en mantenimiento o si el tipo de instancia no admite el mantenimiento a pedido.
• latestWindowStartTime: Es la hora más reciente a la que se puede mover el período de mantenimiento.
• machineType: Es el tipo de máquina de la instancia, por ejemplo, x4-megamem-960-metal o c4-highmem-192.
• maintenanceStatus: Es el estado actual del evento de mantenimiento.
  • ONGOING: La operación de mantenimiento está en curso.
  • PENDING: La operación de mantenimiento está programada, pero aún no se inició.
• type: Es el tipo de mantenimiento que se realizará.
  • NONE: No hay mantenimiento programado para esta instancia.
  • SCHEDULED: En el caso del mantenimiento disruptivo, Compute Engine proporciona un aviso con un mínimo de 7 días de anticipación para la mayoría de las instancias; las instancias X4 reciben un aviso anticipado de aproximadamente 60 días.
  • UNSCHEDULED: Dado que el mantenimiento representa actualizaciones críticas, Compute Engine intenta proporcionar la mayor cantidad de avisos anticipados posible, pero, por lo general, es mucho menor que para los eventos de mantenimiento programados.
• windowEndTime: Es el final del período en el que se produce el mantenimiento.
• windowStartTime: Es el inicio del período en el que se realiza el mantenimiento.

Comportamientos del estado de mantenimiento

Cuando administres eventos de mantenimiento, verifica los valores de canReschedule y maintenanceStatus. Cuando se combinan, estos campos indican qué acciones puedes realizar o no con respecto a la reprogramación de un evento de mantenimiento:

• canReschedule=True y maintenanceStatus=Pending: Puedes iniciar manualmente el evento de mantenimiento de la instancia antes de la hora de inicio programada.
• canReschedule=False y maintenanceStatus=Ongoing: El mantenimiento está en curso y no se puede reprogramar.
• canReschedule=False y maintenanceStatus=Pending: Tu instancia no admite eventos de mantenimiento activados de forma manual.

Cómo ver las notificaciones de mantenimiento

Puedes encontrar notificaciones de mantenimiento si consultas tus instancias de procesamiento, el servidor de metadatos o Cloud Logging.

Verifica las instancias para ver si hay una notificación de evento de mantenimiento

Usa Google Cloud CLI, REST o consulta el servidor de metadatos para ver si hay un próximo evento de mantenimiento del host para tu instancia.

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"

Revisa Cloud Logging para ver si hay una notificación de evento de mantenimiento

Compute Engine crea eventos del sistema en los registros de auditoría de Cloud para una instancia en el caso de eventos de mantenimiento. Puedes ver estos eventos antes, durante y después de un evento de mantenimiento con Cloud Logging y el Explorador de registros.

Ejemplos de notificaciones de mantenimiento

En el Explorador de registros, aparece una notificación de evento de mantenimiento para una instancia con valores similares a los siguientes:

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

Cuando comienza el evento de mantenimiento, aparece un nuevo evento informativo en los registros con valores similares a los siguientes:

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

Durante el evento de mantenimiento, según la configuración de la política de mantenimiento del host para la instancia, se registra uno de los siguientes eventos del sistema en los registros de auditoría:

• En el caso de las instancias configuradas para usar la migración en vivo durante los eventos de mantenimiento, se genera un evento del sistema con methodName: "compute.instances.migrateOnHostMaintenance".
• Para las instancias configuradas para finalizar durante los eventos de mantenimiento, se genera un evento del sistema con methodName: "compute.instances.terminateOnHostMaintenance".

Cuando finaliza el evento de mantenimiento, aparece un nuevo evento informativo en los registros de auditoría con valores similares a los siguientes:

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

Configura alertas para las notificaciones de mantenimiento del host

Puedes configurar una política de alertas basada en registros para buscar eventos específicos de notificación de mantenimiento y enviar alertas a través de un canal de notificación.

Para obtener más información, lee Configura alertas basadas en registros y Crea y administra canales de notificaciones.

¿Qué sigue?

• Obtén más información para establecer una política de mantenimiento del host.
• Obtén información para obtener avisos de migración en vivo.
• Aprende a activar manualmente un evento de mantenimiento del host
• Obtén información para administrar las políticas de alertas basadas en registros con la consola de Google Cloud Monitoring o la API de Monitoring.