Monitora e pianifica un evento di manutenzione dell'host

Ogni istanza di macchina virtuale (VM) o bare metal utilizza una policy di manutenzione host per determinare il comportamento dell'istanza durante un'operazione di manutenzione. Alcune istanze offrono l'opzione aggiuntiva di visualizzare la pianificazione della manutenzione in anticipo.

Questa pagina spiega come monitorare e pianificare un evento di manutenzione dell'host sulle istanze Compute Engine.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:
  

  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

  Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a 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.

  Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare istanze e gestire la manutenzione delle istanze, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

• Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1)
• Per l'accesso di sola lettura agli audit log degli eventi di sistema: Visualizzatore log (roles/logging.viewer)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare istanze e gestire la manutenzione delle istanze. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Puoi visualizzare le notifiche per l'evento di manutenzione imminente di un'istanza solo se l'istanza utilizza un tipo di macchina di una delle seguenti famiglie di macchine:

• Famiglie di macchine ottimizzate per l'acceleratore:

  • A3

  • A2

  • G2

• Famiglie di macchine per uso generico:

  • C4A

  • C4

  • C3D

  • C3

• Famiglie di macchine ottimizzate per la memoria:

  • X4

  • M3

  • M2

  • M1

• Famiglie di macchine ottimizzate per l'archiviazione:

  • Z3

Panoramica delle notifiche relative alla manutenzione

Google invia notifiche per la manutenzione imminente dell'host tramite diversi metodi. Quando si apre il periodo di manutenzione, Google Cloud esegue automaticamente la manutenzione dell'istanza. Monitorando i prossimi periodi di manutenzione della tua istanza, puoi preparare in modo proattivo i tuoi workload per gestire la manutenzione imminente con un'interruzione minima.

Le istanze di calcolo che supportano le notifiche degli eventi di manutenzione hanno le seguenti caratteristiche:

• Meno eventi di manutenzione: in generale, le istanze con intervalli di manutenzione ricorrenti dovrebbero registrare meno eventi di manutenzione.
• Notifica di manutenzione più lunga: ricevi una notifica degli eventi di manutenzione con largo anticipo per pianificare.
• Monitoraggio e pianificazione: utilizza Cloud Logging per monitorare la pianificazione della manutenzione. Utilizza incidenti e avvisi per rimanere informato.
• Controllo della manutenzione on demand: avvia la manutenzione durante il periodo di notifica per aggiornare le istanze quando è più comodo per te.

Le informazioni su un evento di notifica imminente vengono presentate in modo simile al seguente:

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

Se non è previsto alcun evento di manutenzione imminente, viene visualizzato un messaggio simile al seguente:

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

Definizioni degli stati di manutenzione

Le seguenti definizioni di stato spiegano le risposte alle query sulla manutenzione dell'host per un'istanza. Forniscono informazioni relative all'evento di manutenzione. Google Cloud CLI, REST e il server di metadati utilizzano le stesse risposte:

• canReschedule: indica se la manutenzione può essere avviata manualmente durante il periodo di notifica per questa istanza.
  • TRUE: la manutenzione attivata dal cliente può essere eseguita durante il periodo di notifica.
  • FALSE: su questa istanza non è possibile eseguire la manutenzione attivata dal cliente. Questo problema si verifica spesso durante il periodo in cui l'istanza è in fase di manutenzione o se il tipo di istanza non supporta la manutenzione on demand.
• latestWindowStartTime: l'ultima ora in cui è possibile spostare il periodo di manutenzione.
• machineType: il tipo di macchina dell'istanza, ad esempio x4-megamem-960-metal o c4-highmem-192.
• maintenanceStatus: lo stato attuale dell'evento di manutenzione.
  • ONGOING: l'operazione di manutenzione è in corso.
  • PENDING: l'operazione di manutenzione è pianificata, ma non è ancora iniziata.
• type: il tipo di manutenzione da eseguire.
  • NONE: per questa istanza non è pianificata alcuna manutenzione.
  • SCHEDULED: per la manutenzione distruttiva, Compute Engine fornisce un preavviso minimo di 7 giorni per la maggior parte delle istanze; le istanze X4 ricevono un preavviso di circa 60 giorni.
  • UNSCHEDULED: Poiché la manutenzione rappresenta aggiornamenti critici, Compute Engine tenta di fornire un preavviso il più ampio possibile, ma di solito è molto inferiore rispetto agli eventi di manutenzione pianificata.
• windowEndTime: la fine dell'intervallo di tempo in cui viene eseguita la manutenzione.
• windowStartTime: l'inizio del periodo di tempo in cui viene eseguita la manutenzione.

Comportamenti dello stato della manutenzione

Quando gestisci gli eventi di manutenzione, controlla i valori di canReschedule e maintenanceStatus. Se combinati, questi campi indicano le azioni che puoi o non puoi intraprendere in merito alla riprogrammazione di un evento di manutenzione:

• canReschedule=True e maintenanceStatus=Pending: puoi avviare manualmente l'evento di manutenzione per l'istanza prima dell'ora di inizio pianificata.
• canReschedule=False e maintenanceStatus=Ongoing: la manutenzione è in corso e non può essere riprogrammata.
• canReschedule=False e maintenanceStatus=Pending: la tua istanza non supporta gli eventi di manutenzione attivati manualmente.

Visualizzare le notifiche di manutenzione

Puoi trovare le notifiche di manutenzione eseguendo query sulle istanze di calcolo, sul server di metadati o utilizzando Cloud Logging.

Controllare le istanze per una notifica di evento di manutenzione

Utilizza Google Cloud CLI, REST o esegui query sul server di metadati per verificare se è previsto un evento di manutenzione host imminente per la tua istanza.

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"

Controlla Cloud Logging per una notifica di evento di manutenzione

Compute Engine crea eventi di sistema negli audit log di Cloud per un'istanza per gli eventi di manutenzione. Puoi visualizzare questi eventi prima, durante e dopo un evento di manutenzione utilizzando Cloud Logging e Esplora log.

Esempi di notifiche relative alla manutenzione

Una notifica di evento di manutenzione per un'istanza viene visualizzata in Esplora log con valori simili ai seguenti:

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

Quando inizia l'evento di manutenzione, nei log viene visualizzato un nuovo evento informativo con valori simili ai seguenti:

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

Durante l'evento di manutenzione, a seconda della configurazione dei criteri di manutenzione dell'host per l'istanza, viene registrato uno dei seguenti eventi di sistema nei log di controllo:

• Per le istanze configurate per utilizzare la migrazione live durante gli eventi di manutenzione, un evento di sistema con methodName: "compute.instances.migrateOnHostMaintenance".
• Per le istanze configurate per essere terminate durante gli eventi di manutenzione, un evento di sistema con methodName: "compute.instances.terminateOnHostMaintenance".

Al termine dell'evento di manutenzione, nei log di controllo viene visualizzato un nuovo evento informativo con valori simili ai seguenti:

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

Configurare gli avvisi per le notifiche di manutenzione dell'attività

Puoi configurare un criterio di avviso basato su log per cercare eventi di notifica di manutenzione specifici e inviare avvisi utilizzando un canale di notifica.

Per saperne di più, leggi Configurare gli avvisi basati sui log e Creare e gestire i canali di notifica.

Passaggi successivi

• Scopri come impostare una policy di manutenzione dell'host.
• Scopri come ricevere notifiche relative alla migrazione live.
• Scopri come attivare manualmente un evento di manutenzione dell'host
• Scopri come gestire le policy di avviso basate su log utilizzando la console Google Cloud per Monitoring o l'API Monitoring.