Supervisar y planificar un evento de mantenimiento del host

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Cada instancia de máquina virtual (VM) o instancia básica utiliza una política de mantenimiento de 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.

Esta página explica cómo monitorear y planificar un evento de mantenimiento de host en instancias de Compute Engine.

Antes de comenzar

• Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. 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.

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

Roles requeridos

Para obtener los permisos que necesita para crear instancias y administrar el mantenimiento de instancias, solicite a su administrador que le otorgue los siguientes roles de IAM en el proyecto:

• Administrador de instancias informáticas (v1) ( roles/compute.instanceAdmin.v1 )
• Para acceso de solo lectura a los registros de auditoría de eventos del sistema: Visor de registros ( roles/logging.viewer )

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

Estos roles predefinidos contienen los permisos necesarios para crear instancias y gestionar el mantenimiento de instancias. Para ver los permisos exactos que se requieren, expanda la sección Permisos requeridos :

Es posible que también pueda obtener estos permisos con roles personalizados u otros roles predefinidos .

Limitaciones

Puede ver notificaciones del próximo evento de mantenimiento de una instancia solo si la instancia utiliza un tipo de máquina de una de las siguientes familias de máquinas:

• Familias de máquinas optimizadas para aceleradores :

  • A3

  • A2

  • G2

• Familias de máquinas de uso general :

  • C4A

  • C4

  • C3D

  • C3

• Familias de máquinas con memoria optimizada :

  • X4

  • M3

  • M2

  • M1

• Familias de máquinas con almacenamiento optimizado :

  • Z3

Resumen de notificaciones de mantenimiento

Google envía notificaciones sobre el próximo mantenimiento del host a través de varios métodos. Cuando se abre la ventana de mantenimiento, Google Cloud realiza automáticamente el mantenimiento de su instancia. Al monitorear las próximas ventanas de mantenimiento de su instancia, puede preparar de manera proactiva sus cargas de trabajo para manejar el próximo mantenimiento con una interrupción mínima.

Las instancias informáticas 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 : reciba notificaciones de los eventos de mantenimiento con mucha antelación para fines de planificación.
• Monitoreo y planificación : use Cloud Logging para realizar un seguimiento de su programa de mantenimiento. Utilice incidentes y alertas para mantenerse informado.
• Control de mantenimiento bajo demanda : inicie el mantenimiento durante el período de notificación para actualizar sus instancias cuando se ajuste a su cronograma.

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"
    "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á un mensaje similar al siguiente:

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

Definiciones de estado de mantenimiento

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

• canReschedule : si el mantenimiento se puede iniciar manualmente durante el período de notificación para esta instancia.
  • TRUE : el mantenimiento activado por el cliente se puede realizar durante el período de notificación.
  • FALSE : el mantenimiento activado por el cliente no se puede realizar en esta instancia. Esto suele ocurrir durante el período en el que la instancia está en mantenimiento o si el tipo de instancia no admite el mantenimiento bajo demanda.
• lastWindowStartTime : la última hora a la que se puede mover la ventana de mantenimiento.
• MaintenanceStatus : 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 ha comenzado.
• tipo : el tipo de mantenimiento a realizar.
  • NONE : No hay mantenimiento programado para esta instancia.
  • SCHEDULED : Para mantenimiento disruptivo, Compute Engine proporciona un aviso mínimo de 7 días para la mayoría de los casos.; Las instancias X4 reciben un aviso con aproximadamente 60 días de anticipación.
  • UNSCHEDULED : debido a que el mantenimiento representa actualizaciones críticas, Compute Engine intenta brindar un aviso con la mayor anticipación posible, pero generalmente es mucho menor que para los eventos de mantenimiento programados.
• windowEndTime : el final de la ventana de tiempo en la que se produce el mantenimiento.
• windowStartTime : el inicio de la ventana de tiempo en la que se produce el mantenimiento.

Comportamientos del estado de mantenimiento

Al gestionar eventos de mantenimiento, verifique los valores de canReschedule y maintenanceStatus . Cuando se combinan, estos campos indican qué acciones puede o no tomar con respecto a la reprogramación de un evento de mantenimiento:

• canReschedule=True y maintenanceStatus=Pending : puede iniciar manualmente el evento de mantenimiento para la instancia antes de la hora de inicio programada.
• canReschedule=False y maintenanceStatus=Ongoing : el mantenimiento está en marcha y no se puede reprogramar.
• canReschedule=False y maintenanceStatus=Pending : su instancia no admite eventos de mantenimiento activados manualmente.

Ver notificaciones de mantenimiento

Puede encontrar notificaciones de mantenimiento consultando sus instancias informáticas, el servidor de metadatos o utilizando Cloud Logging.

Verificar instancias para una notificación de evento de mantenimiento

Utilice la CLI de Google Cloud, REST o consulte el servidor de metadatos para ver si hay un próximo evento de mantenimiento del host para su instancia.

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

  resourceStatus:
    upcomingMaintenance:
      canReschedule: true
      latestWindowStartTime: '2025-01-15T12:00:01Z'
      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"
    "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"

Consulte Cloud Logging para ver una notificación de evento de mantenimiento

Compute Engine crea eventos del sistema en los registros de auditoría de la nube para una instancia para eventos de mantenimiento. Puede ver estos eventos antes, durante y después de un evento de mantenimiento mediante Cloud Logging y Logs Explorer .

Ejemplos de notificaciones de mantenimiento

Aparece una notificación de evento de mantenimiento para una instancia en el Explorador de registros con valores similares a los siguientes:

• methodName : "compute.instances.upcomingMaintenance"
• metadata :
  • maintenanceStatus : "PENDING"
  • 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"
  • 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, uno de los siguientes eventos del sistema se registra en los registros de auditoría:

• Para instancias configuradas para usar migración en vivo durante eventos de mantenimiento, un evento del sistema con methodName: "compute.instances.migrateOnHostMaintenance" .
• Para instancias configuradas para finalizar durante eventos de mantenimiento, 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." }

Configurar alertas para notificaciones de mantenimiento del host

Puede configurar una política de alertas basada en registros para buscar eventos de notificación de mantenimiento específicos y enviar alertas mediante un canal de notificación .

Para obtener más información, lea Configurar alertas basadas en registros y Crear y administrar canales de notificación .

¿Qué sigue?

• Aprenda a establecer una política de mantenimiento de host .
• Aprenda cómo recibir avisos de migración en vivo .
• Aprenda a activar manualmente un evento de mantenimiento del host
• Aprenda a administrar políticas de alertas basadas en registros mediante la consola de Google Cloud para Monitoring o mediante la API de Monitoring.