Gestionar eventos de host en máquinas virtuales H4D

En este documento se explica cómo usar las funciones de mantenimiento de host que están disponibles con las VMs H4D. Se explica cómo monitorizar, planificar y realizar el mantenimiento programado de las instancias de máquina virtual (VM). Para gestionar el mantenimiento de tus bloques de capacidad reservados, independientemente de si las VMs se están ejecutando en ellos o no, consulta Gestionar eventos de host en varias reservas.

Si gestionas de forma proactiva los eventos de mantenimiento del host de tus máquinas virtuales, puedes minimizar las interrupciones y mantener un rendimiento óptimo.

Antes de empezar

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

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

REST

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

    Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

    gcloud init

    Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre Google Cloud autenticación.

Roles obligatorios

Para obtener los permisos que necesitas para gestionar los eventos de mantenimiento del host en las VMs, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para gestionar los eventos de mantenimiento del host en las VMs. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

Para gestionar los eventos de mantenimiento del host en las VMs, se necesitan los siguientes permisos:

  • Para ver los detalles de una VM, haz lo siguiente: compute.instances.get en el proyecto

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

Información general

Para optimizar el mantenimiento de tus VMs, sigue estos pasos:

  1. Información sobre el mantenimiento de anfitriones Consulta información sobre la frecuencia y el mantenimiento de tus VMs en función de su serie de máquinas. Esta información te ayuda a minimizar las interrupciones en tus cargas de trabajo.

  2. Configura alertas de notificaciones. Crea alertas basadas en registros para recibir notificaciones cuando se programe, inicie o complete el mantenimiento de tus VMs. Este enfoque te ayuda a planificar tus actividades de forma proactiva y evitar tiempos de inactividad inesperados.

  3. Gestionar el mantenimiento de las VMs. Consulta si se ha programado el mantenimiento de tus máquinas virtuales. Si es necesario, puedes iniciar el mantenimiento manualmente en tus VMs. Este proceso te ayuda a aumentar la resiliencia de tus cargas de trabajo ante eventos de host, evitar el tiempo de inactividad y maximizar la disponibilidad de tus aplicaciones.

Información sobre el mantenimiento del host

Durante el ciclo de vida de una instancia de Compute Engine, la máquina host en la que se ejecuta tu instancia experimenta varios eventos del host. Un evento de host puede incluir el mantenimiento periódico de la infraestructura de Compute Engine o, en casos excepcionales, un error de host. Compute Engine también aplica algunas actualizaciones ligeras no disruptivas al hipervisor y a la red en segundo plano.

La serie de máquinas H4D ofrece las siguientes funciones relacionadas con el mantenimiento del host:

Tipo de máquina Frecuencia habitual de los eventos de mantenimiento programados Comportamiento de mantenimiento Notificación avanzada Mantenimiento bajo demanda Simular el mantenimiento
h4d-standard-192 Mínimo de 30 días Finalizar 7 días Sí No
h4d-highmem-192 Mínimo de 30 días Finalizar 7 días Sí No
h4d-highmem-192-lssd Mínimo de 30 días Termina con la persistencia de datos de SSD local 7 días Sí No

Las frecuencias de mantenimiento que se muestran en la tabla anterior son aproximaciones, no garantías. Es posible que Compute Engine realice tareas de mantenimiento con más frecuencia de vez en cuando.

Configurar alertas de notificaciones para máquinas virtuales

Puedes recibir notificaciones sobre eventos de mantenimiento programados, iniciados o completados de tus VMs creando políticas de alertas basadas en registros.

Para crear una alerta sobre los eventos de mantenimiento de tus VMs, sigue este procedimiento. Repite este procedimiento con cada alerta que quieras crear.

  1. En la Google Cloud consola, ve a la página Explorador de registros:

    Ve al Explorador de registros.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Registro.

  2. Activa el interruptor Mostrar consulta.

  3. En el panel Consulta, crea una de las siguientes consultas. Estas consultas filtran las entradas de registro para identificar eventos de mantenimiento específicos. Si quieres usar varias consultas, repite este procedimiento para crear una alerta única para cada consulta.

    • Para recibir alertas cuando se programe el mantenimiento de una VM, sigue estos pasos:

      protoPayload.methodName="compute.instances.upcomingMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "scheduled"

    • Para recibir alertas cuando se abra la ventana de mantenimiento de una VM, sigue estos pasos:

      protoPayload.methodName="compute.instances.upcomingMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "ongoing"

    • Para recibir alertas cuando haya empezado el mantenimiento de una VM, sigue estos pasos:

      protoPayload.methodName="compute.instance.terminateOnHostMaintenance" severity>=DEFAULT

    • Para recibir alertas cuando se haya completado el mantenimiento de una VM, sigue estos pasos:

      protoPayload.methodName="compute.instances.upcomingMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "completed"

  4. Para validar la consulta, haga clic en Ejecutar consulta. Si la consulta es válida, en el panel Resultados de la consulta se muestran las entradas de registro que coinciden con la consulta.

  5. En la barra de herramientas de resultados de Consulta, haz clic en la lista Acciones y, a continuación, selecciona Crear alerta de registro. Se muestra el panel Crear política de alertas basada en registros.

  6. En la sección Información de la alerta, haga lo siguiente:

    1. En el campo Nombre de la política de alertas, escribe el nombre que quieras asignar a la política.

    2. En la lista Nivel de gravedad de la política, selecciona Advertencia (o un nivel de gravedad superior).

    3. Haz clic en Siguiente.

  7. En la sección Seleccionar los registros que se incluirán en la alerta, haz clic en Siguiente.

  8. En la sección Definir la frecuencia de las notificaciones y la duración del cierre automático, especifique lo siguiente:

    1. En la lista Tiempo entre notificaciones, selecciona la frecuencia con la que quieres recibir notificaciones.

    2. En la lista Duración del cierre automático de incidencias, selecciona el tiempo que debe transcurrir para que Cloud Logging deje de enviar notificaciones y cierre automáticamente la incidencia.

    3. Haz clic en Siguiente.

  9. En la sección ¿Quién debe recibir notificaciones?, especifica un canal de notificaciones para que Logging envíe notificaciones.

  10. Haz clic en Guardar.

Para ver ejemplos de notificaciones de eventos de mantenimiento en el Explorador de registros, consulta los ejemplos de notificaciones de mantenimiento en la documentación de Compute Engine.

Gestionar el mantenimiento en las VMs

Para ver y controlar el mantenimiento de tus máquinas virtuales, puedes hacer una o varias de las siguientes acciones:

Ver el estado de mantenimiento de las VMs

Para ver el estado y la hora programada del mantenimiento de tus VMs, consulta el valor del campo upcomingMaintenance en los metadatos de la instancia. Si una VM no contiene el campo upcomingMaintenance, no se programa ningún evento de mantenimiento del host para la VM. Para obtener más información sobre los campos de upcomingMaintenance, consulta las definiciones de estado de mantenimiento en la documentación de Compute Engine.

Además, si se programa el mantenimiento de una máquina virtual, el campo upcomingGroupMaintenance contiene el campo maintenanceReasons. Este campo describe por qué se ha programado el mantenimiento de tu VM, tal como se indica en la siguiente tabla:

Tipo de mantenimiento Motivo del mantenimiento Estado de las VMs
Mantenimiento planificado para el mantenimiento periódico
  • PLANNED_UPDATE: mantenimiento de infraestructura planificado
  • PLANNED_NETWORK_UPDATE: mantenimiento de red programado
 Se aplica a las máquinas virtuales en ejecución, detenidas o suspendidas.
Mantenimiento de emergencia no planificado
  • FAILURE_DISK: mantenimiento no programado programado debido a un error con un disco conectado a una VM.
  • FAILURE_INFRA: mantenimiento no programado programado debido a un error en la infraestructura.
  • FAILURE_INTERFACE: mantenimiento no planificado programado debido a un error con la NIC.
  • FAILURE_MEMORY: mantenimiento no programado programado debido a un error con la memoria de una VM.
  • FAILURE_NETWORK: mantenimiento no planificado programado debido a un error en la red.
 Solo se aplica a las máquinas virtuales en ejecución.

Para ver el campo maintenanceReasons de una VM, debes usar la CLI de gcloud o la API REST. Para ver el estado de mantenimiento de varias máquinas virtuales simultáneamente, debes usar la Google Cloud consola o la API REST. De lo contrario, selecciona una de las siguientes opciones:

Consola

  1. En la consola de Google Cloud , ve a la página Instancias de VM.

    Ir a instancias de VM

  2. En la columna Estado de mantenimiento, Compute Engine muestra el estado de mantenimiento de tus VMs. Si no ves esta columna en la tabla Instancias de VM, haz clic en view_column Opciones de visualización de columnas, selecciona la casilla Estado de mantenimiento y, a continuación, haz clic en Aceptar.

gcloud

Para ver el estado de mantenimiento de una VM, usa el comando gcloud compute instances describe con la marca --flatten=resourceStatus.upcomingMaintenance:

gcloud compute instances describe VM_NAME \
    --flatten=resourceStatus.upcomingMaintenance \
    --zone=ZONE

Haz los cambios siguientes:

  • VM_NAME: el nombre de la VM.

  • ZONE: la zona en la que se encuentra la VM.

La salida es similar a una de las siguientes:

  • Si se ha programado un evento de mantenimiento del host para tu VM, el resultado será similar al siguiente:

    ---
canReschedule: true
latestWindowStartTime: '2025-11-01T19:00:00Z'
maintenanceReasons:
- 'PLANNED_UPDATE'
- 'PLANNED_NETWORK_UPDATE'
maintenanceStatus: 'PENDING'
type: 'SCHEDULED'
windowEndTime: '2025-11-01T22:00:00Z'
windowStartTime: '2025-11-01T19:00:00Z'

  • Si no se ha programado ningún evento de mantenimiento del host para tu VM, el resultado será similar al siguiente:

    ---
null

REST

Para ver el estado de mantenimiento de tus VMs, haz una de las siguientes GET solicitudes. Cuando hagas una solicitud, debes incluir el parámetro de consulta fields para mostrar solo el nombre, el tipo de máquina y el mantenimiento programado de una VM. También debe incluir el parámetro de consulta filter para filtrar solo las VMs por un tipo de máquina específico.

  • Para ver las VMs de todas las zonas, usa el método instances.aggregatedList.

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/instances?fields=items.name,items.machineType,items.upcomingMaintenance&filter=machineType%3AMACHINE_TYPE

  • Para ver las VMs de una zona concreta, usa el método instances.list.

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances?fields=items.name,items.machineType,items.upcomingMaintenance&filter=machineType%3AMACHINE_TYPE

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto en el que has creado las máquinas virtuales.

  • ZONE: la zona en la que se encuentran las VMs.

  • MACHINE_TYPE: el tipo de máquina por el que quieres filtrar las VMs.

Si se programa un evento de mantenimiento de host para una VM, esta contendrá el campo upcomingMaintenance:

{
  "items": [
    {
      "name": "vm-01",
      "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/machineTypes/h4d-highmem-192-lssd",
      "resourceStatus": {
        "upcomingMaintenance": {
          "canReschedule": true,
          "latestWindowStartTime": "2024-11-01T19:00:00Z",
          "maintenanceStatus": "PENDING",
          "maintenanceReasons": [
            "PLANNED_UPDATE",
            "PLANNED_NETWORK_UPDATE"
          ],
          "type": "SCHEDULED",
          "windowEndTime": "2024-11-01T22:00:00Z",
          "windowStartTime": "2024-11-01T19:00:00Z"
        }
      }
    },
    ...
  ]
}

Si quieres acotar aún más la lista de VMs, puedes definir el parámetro de consulta filter con otra expresión de filtro.

Servidor de metadatos

Para ver el estado de mantenimiento de una VM, haz lo siguiente:

  1. Si aún no lo has hecho, conéctate a tu Linux o VM de Windows.

  2. Consulta el servidor de metadatos de la siguiente manera:

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

    Si se ha programado un evento de mantenimiento del host para tu VM, el resultado será similar al siguiente:

    "Upcoming maintenance": {
  "can_reschedule": "true",
  "latest_window_start_time": "2024-12-01T19:00:01Z",
  "maintenance_reasons": [
    "PLANNED_UPDATE",
    "PLANNED_NETWORK_UPDATE"
  ],
  "maintenance_status": "PENDING",
  "type": "SCHEDULED",
  "window_end_time": "2024-12-01T21:00:01Z",
  "window_start_time": "2024-12-01T19:00:01Z"
}

    Si no se ha programado ningún evento de mantenimiento del host, el resultado será similar al siguiente:

    { }

Iniciar manualmente el mantenimiento en máquinas virtuales

Puedes iniciar el mantenimiento de tus VMs manualmente en lugar de esperar a la hora programada.

En función del estado de mantenimiento de una VM, ocurre lo siguiente:

Estado de mantenimiento Descripción Lo que ves
Programado Compute Engine ha programado el mantenimiento de la VM. Puedes iniciar el mantenimiento manualmente antes de la hora programada.
  • En la Google Cloud consola, el estado del mantenimiento se muestra como Listo para ejecutarse: se ejecutará el DATE.
  • En la CLI de gcloud o en la API REST, Compute Engine asigna el valor PENDING al campo maintenanceStatus.
En curso Se está llevando a cabo el mantenimiento. No puedes volver a programarlo.
  • En la consola Google Cloud , el estado de mantenimiento se muestra como En curso.
  • En la CLI de gcloud o en la API REST, Compute Engine asigna el valor ONGOING al campo maintenanceStatus.
Completado El mantenimiento ha finalizado. Compute Engine ha eliminado todas las notificaciones de mantenimiento de la máquina virtual.
  • En la Google Cloud consola, el estado de mantenimiento se muestra como Actualizado.
  • En la CLI de gcloud o en la API REST, Compute Engine asigna el valor COMPLETE al campo maintenanceStatus.

Puedes iniciar el mantenimiento de varias VMs simultáneamente o de VMs concretas. Si tienes varias máquinas virtuales, usa la consola Google Cloud o, si las máquinas virtuales están en la misma zona, la CLI de gcloud. En el caso de las VMs individuales, selecciona una de las siguientes opciones:

Consola

  1. En la consola de Google Cloud , ve a la página Instancias de VM.

    Ir a instancias de VM

  2. Selecciona las filas de las VMs en las que quieras iniciar el mantenimiento.

  3. Haz clic en Ejecutar mantenimiento.

  4. Para confirmar la acción, haz clic en Ejecutar mantenimiento.

gcloud

Para iniciar manualmente el mantenimiento de una o varias VMs de la misma zona, usa el comando gcloud compute instances perform-maintenance:

gcloud compute instances perform-maintenance VM_NAMES \
    --zone=ZONE

Haz los cambios siguientes:

  • VM_NAMES: lista de nombres de máquinas virtuales separados por espacios. Por ejemplo, vm-01 vm-02 vm-03.

  • ZONE: la zona en la que se encuentran las VMs.

REST

Para iniciar manualmente el mantenimiento de una VM, haz una solicitud POST al método instances.performMaintenance:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/performMaintenance

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto en el que has creado la VM.

  • ZONE: la zona en la que se encuentra la VM.

  • VM_NAME: el nombre de la VM.