Surveiller et planifier un événement de maintenance de l'hôte

Chaque instance de machine virtuelle (VM) ou instance bare metal utilise une stratégie de maintenance de l'hôte pour déterminer le comportement de l'instance lors d'une opération de maintenance. Certaines instances offrent la possibilité supplémentaire d'afficher le calendrier de maintenance à l'avance.

Cette page explique comment surveiller et planifier un événement de maintenance de l'hôte sur les instances Compute Engine.

Avant de commencer

• Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud . Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :
  

  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

  Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à 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.

  Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud .

Rôles requis

Pour obtenir les autorisations nécessaires pour créer des instances et gérer leur maintenance, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

• Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1)
• Pour accéder en lecture seule aux journaux d'audit des événements système : Lecteur de journaux (roles/logging.viewer)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour créer des instances et gérer leur maintenance. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Limites

Vous ne pouvez afficher les notifications concernant un événement de maintenance à venir pour une instance que si celle-ci utilise un type de machine de l'une des familles de machines suivantes :

• Familles de machines optimisées pour les accélérateurs :

  • A3

  • A2

  • G2

• Familles de machines à usage général :

  • C4A

  • C4

  • C3D

  • C3

• Familles de machines à mémoire optimisée :

  • X4

  • M3

  • M2

  • M1

• Familles de machines optimisées pour le stockage :

  • Z3

Présentation des notifications de maintenance

Google envoie des notifications pour les opérations de maintenance à venir sur les hôtes via plusieurs méthodes. Lorsque l'intervalle de maintenance s'ouvre, Google Cloud effectue automatiquement la maintenance de votre instance. En surveillant les prochains intervalles de maintenance de votre instance, vous pouvez préparer vos charges de travail de manière proactive pour gérer les opérations de maintenance à venir avec un minimum d'interruption.

Les instances de calcul compatibles avec les notifications d'événements de maintenance présentent les caractéristiques suivantes :

• Moins d'événements de maintenance : en général, les instances avec des intervalles de maintenance récurrents devraient rencontrer moins d'événements de maintenance.
• Notification de maintenance plus longue : recevez des notifications bien à l'avance pour les événements de maintenance afin de pouvoir vous organiser.
• Surveillance et planification : utilisez Cloud Logging pour suivre votre calendrier de maintenance. Restez informé grâce aux incidents et aux alertes.
• Contrôle de maintenance à la demande : démarrez la maintenance pendant la période de notification pour mettre à jour vos instances selon votre planning.

Les informations sur un événement de notification à venir sont présentées de la manière suivante :

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 aucun événement de maintenance n'est prévu, un message semblable à celui-ci s'affiche :

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

Définitions des états de maintenance

Les définitions d'état suivantes permettent de comprendre les réponses fournies aux requêtes concernant la maintenance de l'hôte pour une instance. Elles fournissent des informations sur l'événement de maintenance. Google Cloud CLI, REST et le serveur de métadonnées utilisent ces mêmes réponses :

• canReschedule : indique si la maintenance peut être démarrée manuellement pendant la période de notification pour cette instance.
  • TRUE : la maintenance déclenchée par le client peut être effectuée pendant la période de notification.
  • FALSE : la maintenance déclenchée par le client ne peut pas être effectuée sur cette instance. Cela se produit souvent pendant la période de maintenance de l'instance ou si le type d'instance n'est pas compatible avec la maintenance à la demande.
• latestWindowStartTime : heure la plus tardive vers laquelle la période de maintenance peut être déplacée.
• machineType : type de machine de l'instance, par exemple x4-megamem-960-metal ou c4-highmem-192.
• maintenanceStatus : état actuel de l'événement de maintenance.
  • ONGOING : l'opération de maintenance est en cours.
  • PENDING : l'opération de maintenance est planifiée, mais n'a pas encore commencé.
• type : type de maintenance à effectuer.
  • NONE : aucune maintenance n'est prévue pour cette instance.
  • SCHEDULED : en cas de maintenance perturbatrice, Compute Engine fournit un préavis d'au moins sept jours pour la plupart des instances. Les instances X4 reçoivent un préavis d'environ 60 jours.
  • UNSCHEDULED : étant donné que la maintenance représente des mises à jour critiques, Compute Engine s'efforce de fournir un préavis aussi long que possible, mais il est généralement beaucoup plus court que pour les événements de maintenance planifiés.
• windowEndTime : fin de la période au cours de laquelle la maintenance est effectuée.
• windowStartTime : début de la période au cours de laquelle la maintenance est effectuée.

Comportements des états de maintenance

Lorsque vous gérez des événements de maintenance, vérifiez les valeurs de canReschedule et maintenanceStatus. Combinés, ces champs indiquent les actions que vous pouvez ou ne pouvez pas effectuer concernant la reprogrammation d'un événement de maintenance :

• canReschedule=True et maintenanceStatus=Pending : vous pouvez démarrer manuellement l'événement de maintenance pour l'instance avant l'heure de début prévue.
• canReschedule=False et maintenanceStatus=Ongoing : la maintenance est en cours et ne peut pas être reprogrammée.
• canReschedule=False et maintenanceStatus=Pending : votre instance n'est pas compatible avec les événements de maintenance déclenchés manuellement.

Afficher les notifications de maintenance

Vous pouvez trouver les notifications de maintenance en interrogeant vos instances de calcul, le serveur de métadonnées ou en utilisant Cloud Logging.

Vérifier les instances pour une notification d'événement de maintenance

Utilisez Google Cloud CLI, REST ou interrogez le serveur de métadonnées pour voir s'il y a un événement de maintenance de l'hôte à venir pour votre instance.

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"

Rechercher une notification d'événement de maintenance dans Cloud Logging

Compute Engine crée des événements système dans Cloud Audit Logs pour une instance lors d'événements de maintenance. Vous pouvez afficher ces événements avant, pendant et après un événement de maintenance à l'aide de Cloud Logging et de l'explorateur de journaux.

Exemples de notifications de maintenance

Une notification d'événement de maintenance pour une instance s'affiche dans l'explorateur de journaux avec des valeurs semblables à celles-ci :

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

Lorsque l'événement de maintenance commence, un nouvel événement d'information s'affiche dans les journaux avec des valeurs semblables à celles-ci :

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

Lors de l'événement de maintenance, en fonction de la configuration de la règle de maintenance de l'hôte pour l'instance, l'un des événements système suivants est consigné dans les journaux d'audit :

• Pour les instances configurées pour utiliser la migration à chaud lors des événements de maintenance, un événement système avec methodName: "compute.instances.migrateOnHostMaintenance".
• Pour les instances configurées pour s'arrêter lors des événements de maintenance, un événement système avec methodName: "compute.instances.terminateOnHostMaintenance".

Une fois l'événement de maintenance terminé, un nouvel événement d'information s'affiche dans les journaux d'audit avec des valeurs semblables à celles ci-dessous :

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

Configurer des alertes pour les notifications de maintenance de l'hôte

Vous pouvez configurer une règle d'alerte basée sur les journaux pour rechercher des événements de notification de maintenance spécifiques et envoyer des alertes à l'aide d'un canal de notification.

Pour en savoir plus, consultez les pages Configurer des alertes basées sur les journaux et Créer et gérer des canaux de notification.

Étapes suivantes

• Découvrez comment définir une stratégie de maintenance d'hôte.
• Découvrez comment recevoir des notifications de migration à chaud.
• Découvrez comment déclencher manuellement un événement de maintenance de l'hôte.
• Découvrez comment gérer les règles d'alerte basées sur les journaux à l'aide de la console Google Cloud pour Monitoring ou de l'API Monitoring.