Gestisci gli eventi sull'host nelle istanze di computing

Questo documento spiega come utilizzare le funzionalità di manutenzione dell'host disponibili nella suite Cluster Director. Spiega come monitorare, pianificare ed eseguire la manutenzione pianificata sulle istanze Compute Engine. Per gestire la manutenzione dei blocchi di capacità riservati, indipendentemente dal fatto che le istanze di computing siano in esecuzione, consulta Gestisci gli eventi sull'host nelle prenotazioni.

Se gestisci in modo proattivo gli eventi di manutenzione dell'host imminenti sulle tue istanze, puoi ridurre al minimo le interruzioni e mantenere prestazioni ottimali.

Prima di iniziare

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

Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

    Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente: 

    gcloud init

    Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire gli eventi di manutenzione dell'host nelle istanze di calcolo, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Compute Admin (roles/compute.admin) sul progetto
  • Per l'accesso di sola lettura agli audit log degli eventi di sistema: Logs Viewer (roles/logging.viewer) sul progetto

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 gestire gli eventi di manutenzione dell'host nelle istanze di computing. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per gestire gli eventi di manutenzione dell'host nelle istanze di computing sono necessarie le seguenti autorizzazioni:

  • Per visualizzare i dettagli di un'istanza: compute.instances.get sul progetto

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

Panoramica

Per ottimizzare la manutenzione delle tue istanze di Compute, completa i seguenti passaggi:

  1. Comprendere e gestire la manutenzione dell'host. Scopri la frequenza e il comportamento di manutenzione delle tue istanze in base alla serie di macchine e scopri come preparare il tuo workload per gestire la manutenzione dell'host. Queste informazioni ti aiutano a ridurre al minimo le interruzioni e a prevenire la perdita di dati.

  2. Configura gli avvisi di notifica. Crea avvisi basati su log per ricevere notifiche quando la manutenzione delle tue istanze viene pianificata, avviata o completata. Questo approccio ti aiuta a pianificare in modo proattivo le tue attività e a evitare tempi di inattività imprevisti.

  3. Gestire la manutenzione su più istanze. Visualizza se è stata pianificata la manutenzione delle tue istanze. Se necessario, puoi avviare manualmente la manutenzione delle tue istanze. Questo processo ti aiuta ad aumentare la resilienza dei tuoi workload per ospitare eventi, evitare tempi di inattività e massimizzare la disponibilità delle tue applicazioni.

Comprendere e gestire la manutenzione dell'host

Durante il ciclo di vita di un'istanza Compute Engine, la macchina host su cui viene eseguita l'istanza subisce diversi eventi dell'host. Un evento sull'host può includere quanto segue:

  • Manutenzione pianificata dell'infrastruttura Compute Engine.
  • Manutenzione di emergenza non pianificata per riparare l'infrastruttura Compute Engine dopo un errore dell'host o un report dell'host difettoso.

La tabella seguente descrive le funzionalità di manutenzione dell'host per i tipi di macchine ottimizzati per l'acceleratore:

Tipo di macchina Frequenza tipica degli eventi di manutenzione programmata Comportamento manutenzione Notifica avanzata per la manutenzione pianificata Notifiche avanzate per la manutenzione di emergenza Manutenzione on demand Simulare la manutenzione
A4X Max e A4X Almeno ogni 90 giorni Termina con Persistenza dei dati di SSD locali 90 giorni Se attivi le notifiche di emergenza, 7 giorni. In caso contrario, alcune ore. Sì No
A4 Almeno ogni 90 giorni Termina con Persistenza dei dati di SSD locali 90 giorni Se attivi le notifiche di emergenza, 7 giorni. In caso contrario, alcune ore. Sì No
A3 Ultra Almeno ogni 90 giorni Termina con Persistenza dei dati di SSD locali 90 giorni Se attivi le notifiche di emergenza, 7 giorni. In caso contrario, alcune ore. Sì No
A3 Mega e A3 High
(8 GPU)		 Almeno ogni 90 giorni Termina con Persistenza dei dati di SSD locali 90 giorni Se attivi le notifiche di emergenza, 7 giorni. In caso contrario, alcune ore. Sì Sì

La frequenza di manutenzione indicata nella tabella precedente ha solo valore indicativo. Può accadere che Compute Engine esegua la manutenzione con maggiore frequenza.

Per evitare di perdere dati o progressi, configura i carichi di lavoro in modo che gestiscano la manutenzione dell'host. Ad esempio, utilizza le seguenti tecniche per salvare i dati temporanei e i progressi prima che il carico di lavoro venga interrotto:

Configurare gli avvisi di notifica per le istanze di calcolo

Puoi ricevere notifiche relative agli eventi di manutenzione pianificati, avviati o completati per le tue istanze creando policy di avviso basate sui log.

Per creare un avviso per gli eventi di manutenzione delle tue istanze, completa la seguente procedura. Ripeti questa procedura per ogni avviso che vuoi creare.

  1. Nella console Google Cloud , vai alla pagina Esplora log:

    Vai a Esplora log

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

  2. Fai clic sul pulsante di attivazione/disattivazione Mostra query.

  3. Nel riquadro Query, crea una delle seguenti query. Queste query filtrano le voci di log per identificare eventi di manutenzione specifici. Se vuoi utilizzare più query, ripeti questa procedura per creare un avviso univoco per ogni query.

    • Per ricevere avvisi quando viene pianificata la manutenzione di un'istanza:

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

    • Per ricevere avvisi quando si apre il periodo di manutenzione per un'istanza:

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

    • Per ricevere avvisi quando è iniziata la manutenzione di un'istanza:

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

    • Per ricevere avvisi al termine della manutenzione di un'istanza:

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

  4. Per convalidare la query, fai clic su Esegui query. Se la query è valida, il riquadro Risultati delle query mostra le voci di log che corrispondono alla query.

  5. Nella barra degli strumenti dei risultati della query, fai clic sull'elenco Azioni e poi seleziona Crea avviso log. Viene visualizzato il riquadro Crea policy di avviso basata su log.

  6. Nella sezione Dettagli avviso, segui questi passaggi:

    1. Nel campo Nome criterio di avviso, inserisci un nome per il criterio.

    2. Nell'elenco Livello di gravità della policy, seleziona Avviso (o un livello di gravità superiore).

    3. Fai clic su Avanti.

  7. Nella sezione Scegli i log da includere nell'avviso, fai clic su Avanti.

  8. Nella sezione Imposta la frequenza delle notifiche e la durata della chiusura automatica, specifica quanto segue:

    1. Nell'elenco Tempo tra le notifiche, seleziona la frequenza con cui vuoi ricevere le notifiche.

    2. Nell'elenco Durata chiusura automatica incidenti, seleziona dopo quanto tempo Cloud Logging smette di inviare notifiche e chiude automaticamente l'incidente.

    3. Fai clic su Avanti.

  9. Nella sezione Chi dovrebbe ricevere le notifiche?, specifica un canale di notifica per Logging a cui inviare le notifiche.

  10. Fai clic su Salva.

Per visualizzare esempi di notifiche di eventi di manutenzione in Esplora log, consulta Esempi di notifiche relative alla manutenzione nella documentazione di Compute Engine.

Gestire la manutenzione tra le istanze di Compute

Puoi visualizzare e controllare la manutenzione delle tue istanze eseguendo una o più delle seguenti operazioni:

Visualizza lo stato di manutenzione delle istanze di calcolo

Puoi visualizzare lo stato e l'ora pianificata della manutenzione imminente per le tue istanze controllando il valore del campo upcomingMaintenance nei metadati dell'istanza. Se un'istanza non contiene il campo upcomingMaintenance, non è pianificato alcun evento di manutenzione dell'host per l'istanza. Per ulteriori informazioni sui campi in upcomingMaintenance, consulta Definizioni dello stato di manutenzione nella documentazione di Compute Engine.

Inoltre, se per un'istanza è pianificata la manutenzione, il campo upcomingGroupMaintenance contiene il campo maintenanceReasons. Questo campo descrive il motivo per cui è stata pianificata la manutenzione per la tua istanza, come descritto nella tabella seguente:

Tipo di manutenzione Motivo della manutenzione Stato dell'istanza di computing
Manutenzione pianificata dopo la segnalazione di un host difettoso FAILURE_GPU_CUSTOMER_REPORTED Si applica solo alle istanze in esecuzione sull'host che hai segnalato come difettoso.
Manutenzione pianificata per la manutenzione regolare
  • PLANNED_UPDATE: manutenzione pianificata dell'infrastruttura
  • PLANNED_NETWORK_UPDATE: manutenzione di rete pianificata
 Si applica alle istanze in esecuzione, arrestate o sospese.
Manutenzione di emergenza non pianificata
  • FAILURE_DISK: manutenzione non pianificata pianificata a causa di un errore con un disco collegato a un'istanza.
  • FAILURE_GPU: manutenzione non pianificata pianificata a causa di un errore correlato alla GPU.
  • FAILURE_GPU_TEMPERATURE: manutenzione non pianificata programmata a causa di un errore correlato alla GPU dopo che la GPU ha raggiunto una temperatura elevata.
  • FAILURE_GPU_XID: manutenzione non pianificata dopo aver ricevuto un messaggio Xid a causa di un errore correlato alla GPU.
  • FAILURE_INFRA: manutenzione non pianificata pianificata a causa di un errore dell'infrastruttura.
  • FAILURE_INTERFACE: manutenzione non pianificata programmata a causa di un errore con la NIC.
  • FAILURE_MEMORY: manutenzione non pianificata pianificata a causa di un errore nella memoria di un'istanza.
  • FAILURE_NETWORK: manutenzione non pianificata programmata a causa di un errore di rete.
  • FAILURE_NVLINK: manutenzione non pianificata programmata a causa di un errore con NVLink.
 Si applica solo alle istanze in esecuzione.

Per visualizzare il campo maintenanceReasons in un'istanza, devi utilizzare gcloud CLI o l'API REST. Per visualizzare lo stato di manutenzione di più istanze di computing contemporaneamente, devi utilizzare la console Google Cloud o l'API REST. In caso contrario, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze VM.

    Vai a Istanze VM

  2. Nella colonna Stato della manutenzione, Compute Engine mostra lo stato di manutenzione delle istanze. Se non vedi questa colonna nella tabella Istanze VM, fai clic su view_column Opzioni di visualizzazione delle colonne, seleziona la casella di controllo Stato della manutenzione e poi fai clic su Ok.

gcloud

Per visualizzare lo stato di manutenzione di un'istanza, utilizza il comando gcloud compute instances describe con il flag --flatten=resourceStatus.upcomingMaintenance:

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

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza

  • ZONE: la zona in cui esiste l'istanza

L'output è simile a uno dei seguenti:

  • Se per la tua istanza è pianificato un evento di manutenzione dell'host, l'output è simile al seguente:

    ---
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'

  • Se per la tua istanza non è pianificato un evento di manutenzione dell'host, l'output è simile al seguente:

    ---
null

REST

Per visualizzare lo stato di manutenzione delle tue istanze, effettua una delle seguenti richieste GET. Quando effettui una richiesta, devi includere il parametro di query fields per mostrare solo il nome, il tipo di macchina e la manutenzione imminente per un'istanza. Devi includere anche il parametro di query filter per filtrare le istanze solo in base a un tipo di macchina specifico.

  • Per visualizzare le istanze in tutte le zone: metodo 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

  • Per visualizzare le istanze in una zona specifica: metodo 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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui hai creato le istanze.

  • ZONE: la zona in cui esistono le istanze.

  • MACHINE_TYPE: il tipo di macchina in base al quale vuoi filtrare le istanze.

Se per un'istanza è pianificato un evento di manutenzione dell'host, l'istanza contiene il campo upcomingMaintenance:

{
  "items": [
    {
      "name": "vm-01",
      "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/a3-ultragpu-8g",
      "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"
        }
      }
    },
    ...
  ]
}

(Facoltativo) Per restringere ulteriormente un elenco di istanze, imposta il parametro di query filter su un'espressione di filtro diversa.

Server di metadati

Per visualizzare lo stato di manutenzione di un'istanza:

  1. Se non l'hai ancora fatto, connettiti all'istanza Linux o Windows.

  2. Per visualizzare la pianificazione della manutenzione imminente, esegui una query sull'endpoint upcoming-maintenance:

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

    Se per la tua istanza è pianificato un evento di manutenzione dell'host, l'output è simile al seguente:

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

    Se non è pianificato un evento di manutenzione dell'host, l'output è simile al seguente:

    { }

  3. Per visualizzare lo stato attuale della manutenzione di una VM, esegui una query sull'endpoint maintenance-event:

    curl http://metadata.google.internal/computeMetadata/v1/instance/maintenance-event -H "Metadata-Flavor: Google"

    Per saperne di più sull'output di queste query, consulta Esamina gli output.

Avviare manualmente la manutenzione sulle istanze di computing

Puoi avviare manualmente la manutenzione delle tue istanze anziché attendere l'ora pianificata.

A seconda dello stato di manutenzione di un'istanza, si verifica quanto segue:

Stato di manutenzione Descrizione Cosa vedi
Pianificato Compute Engine ha pianificato la manutenzione dell'istanza. Puoi avviare manualmente la manutenzione prima dell'orario pianificato.
  • Nella console Google Cloud , lo stato della manutenzione viene visualizzato come Pronto per l'esecuzione - verrà eseguito il giorno DATE.
  • In gcloud CLI o nell'API REST, Compute Engine imposta il campo maintenanceStatus su PENDING.
In corso La manutenzione è in corso. Non puoi riprogrammarlo.
  • Nella console Google Cloud , lo stato della manutenzione viene visualizzato come In esecuzione.
  • In gcloud CLI o nell'API REST, Compute Engine imposta il campo maintenanceStatus su ONGOING.
Completa La manutenzione è terminata. Compute Engine ha rimosso tutte le notifiche di manutenzione dall'istanza.
  • Nella console Google Cloud , lo stato di manutenzione viene visualizzato come Aggiornato.
  • In gcloud CLI o nell'API REST, Compute Engine imposta il campo maintenanceStatus su COMPLETE.

Puoi avviare manualmente la manutenzione per più istanze contemporaneamente o per singole istanze. Per più istanze, utilizza la console Google Cloud o, per le istanze situate nella stessa zona, gcloud CLI. Per le istanze singole seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze VM.

    Vai a Istanze VM

  2. Seleziona le righe delle istanze in cui vuoi avviare la manutenzione.

  3. Fai clic su Esegui manutenzione.

  4. Per confermare, fai clic su Esegui manutenzione.

gcloud

Per avviare manualmente la manutenzione di una o più istanze nella stessa zona, utilizza il comando gcloud compute instances perform-maintenance:

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

Sostituisci quanto segue:

  • INSTANCE_NAMES: un elenco di nomi di istanze separati da spazi, ad esempio vm-01 vm-02 vm-03.

  • ZONE: la zona in cui esistono le istanze.

REST

Per avviare manualmente la manutenzione di un'istanza, invia una richiesta POST al metodo instances.performMaintenance:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui hai creato l'istanza

  • ZONE: la zona in cui esiste l'istanza

  • INSTANCE_NAME: il nome dell'istanza

Passaggi successivi