Supervisa los eventos de mantenimiento

En este documento, se describe cómo ver las operaciones de mantenimiento del host con la línea de comandos y con el panel de mantenimiento de GKE.

Ver las operaciones de mantenimiento del host puede ayudarte a mitigar las interrupciones de la carga de trabajo, en especial, para un clúster de GKE de larga duración con cargas de trabajo que podrían interrumpirse debido a interrupciones periódicas de la infraestructura.

Para obtener más detalles sobre el mantenimiento del host en GKE, consulta Comprende cómo realizar el mantenimiento del host en GKE.

Supervisa las notificaciones de mantenimiento

Antes de que una VM tenga un evento de mantenimiento programado, Compute Engine envía notificaciones a todas sus VMs. Estas notificaciones informan el inicio del período de mantenimiento de Compute Engine. Cuando la VM programa un mantenimiento próximo, pero no está activo, GKE agrega scheduled-maintenance-time a la etiqueta del nodo.

Para supervisar y detectar los próximos eventos de mantenimiento, debes ver las notificaciones de GKE y Compute Engine.

Visualiza el próximo mantenimiento en Compute Engine

Compute Engine emite notificaciones cuando los nodos y sus VMs subyacentes están programados para eventos de host disruptivos, y cuando estos eventos se activan. Las notificaciones incluyen información sobre la hora de inicio planificada, el tipo de evento y otros detalles.

Visualiza el próximo mantenimiento en GKE

En la versión 1.31.1-gke.2008000 de GKE y versiones posteriores, y para tipos de máquinas específicos, puedes supervisar los próximos eventos de mantenimiento.

• Para tipos de máquinas con GPUs o TPUs conectadas, 1.31.1-gke.2008000 o versiones posteriores
• Para tipos de máquinas Z3 con más de 18 TiB de SSD, 1.32.4-gke.1376000 o versiones posteriores
• Para tipos de máquinas H4D, 1.32.6-gke.1060000 o versiones posteriores
• Para c4a-highmem-96-metal, 1.35.0-gke.2232000 o versiones posteriores

Para ver los próximos eventos de mantenimiento, puedes hacer lo siguiente:

• Consulta las notificaciones a nivel del nodo. Para hacerlo, ejecuta el comando siguiente:

  kubectl get nodes -l cloud.google.com/scheduled-maintenance-time \
      -L cloud.google.com/scheduled-maintenance-time
  

  El resultado es similar a este:

  NAME                         STATUS    SCHEDULED-MAINTENANCE-TIME
  <gke-accelerator-node-name>  Ready     1733083200
  <gke-accelerator-node-name>  Ready     1733083200
  [...]
  

  La columna SCHEDULED-MAINTENANCE-TIME representa segundos, que se muestran en formato de hora de ciclo de entrenamiento de Unix.

• Consulta estas notificaciones a nivel de los metadatos del nodo. Para ello, verifica las instancias para ver si hay una notificación de evento de mantenimiento .

• Para las familias de máquinas con optimización de acelerador que admiten el mantenimiento avanzado, puedes acceder al extremo upcoming-maintenance que proporciona información sobre los eventos de mantenimiento programados y que se iniciaron.

Visualiza eventos de Kubernetes para el mantenimiento del host

En GKE versión 1.35 y posteriores, se emiten eventos de Kubernetes que hacen un seguimiento del ciclo de vida del mantenimiento del host. Estos eventos de Kubernetes proporcionan visibilidad detallada de los períodos programados de Compute Engine, las operaciones en curso y los casos extremos, como las reparaciones o las cancelaciones, lo que te permite supervisar las interrupciones directamente en el entorno de Kubernetes.

Puedes ver estos eventos con las herramientas estándar de Kubernetes o a través de Cloud Logging:

1. Para ver los eventos de mantenimiento recientes, usa el siguiente comando kubectl:

   kubectl get events -n kube-system --field-selector involvedObject.kind=Node
   

   Los eventos de Kubernetes se conservan en el clúster durante 60 minutos, por lo que este comando solo genera estos eventos recientes por nodo.

2. Para ver eventos en Cloud Logging, haz lo siguiente:

   1. Ve a la página Explorador de registros en la Cloud de Confiance consola:

      Ir al Explorador de registros

   2. Usa la siguiente consulta:

   resource.type="k8s_node"
   log_id("events")
   jsonPayload.metadata.annotations."maintenance.gke.io/category"="HostMaintenance"
   

Eventos del ciclo de vida de mantenimiento

Los eventos del ciclo de vida de mantenimiento se emiten en los recursos de nodos de Kubernetes. En la siguiente tabla, se describen los eventos que emite GKE durante el ciclo de vida de mantenimiento del host de Compute Engine:

Información de la carga útil del evento

Si la información sobre los próximos eventos de mantenimiento está disponible a través de Compute Engine, cada evento también incluye una carga útil que contiene datos de anotación con la siguiente información:

• Detalles del período de Compute Engine: Incluye windowStartTime, windowEndTime y latestWindowStartTime.
• Metadatos de mantenimiento: El estado del ciclo de mantenimiento en el momento del evento, el motivo del mantenimiento (el motivo se puede enumerar como SCHEDULED o UNSCHEDULED) y si el período de Compute Engine se puede reprogramar.
• Metadatos de Kubernetes: Incluye Cluster_name, nodepool_name y node_name.

Vista de las operaciones de mantenimiento del host en el panel de mantenimiento de GKE

El panel de mantenimiento de GKE proporciona una vista consolidada de las operaciones de mantenimiento del host. El panel proporciona visibilidad integral de las actividades de mantenimiento en los niveles de clúster, grupo de nodos y nodo.

El panel se basa en Estadísticas de observabilidad. Muestra los ciclos de mantenimiento, los estados de los nodos y las métricas históricas de tiempo de inactividad.

¿Qué sigue?

• Obtén información para administrar la interrupción de nodos durante el mantenimiento del host.
• Obtén información para realizar el mantenimiento del host para nodos que ejecutan cargas de trabajo de acelerador.
• Obtén información sobre los períodos de mantenimiento y las exclusiones de GKE.