Monitora le estensioni VM

Questo documento descrive come monitorare le estensioni VM gestite dal gestore di estensioni VM sulle istanze Compute Engine utilizzando Cloud Monitoring. Il monitoraggio dell'integrità delle estensioni e del consumo di risorse ti aiuta a monitorare l'utilizzo della CPU e della memoria e a rilevare errori di installazione o di runtime nel tuo parco di VM.

In questo documento imparerai a completare le seguenti attività:

Prima di iniziare

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

    Seleziona la scheda relativa al modo in cui prevedi di utilizzare gli esempi in questa pagina:

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi e alle API Google Cloud , non devi configurare l'autenticazione.

    gcloud

    1. Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il comando seguente: 

      gcloud init
  • Imposta una regione e una zona predefinite.

    • 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, quindi accedi a gcloud CLI con la tua identità federata.

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

Prima di iniziare

Prima di monitorare le estensioni, completa i seguenti prerequisiti:

Autorizzazioni IAM obbligatorie

Per ottenere le autorizzazioni necessarie per monitorare le metriche, creare dashboard e configurare policy di avviso, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

Per ottenere le autorizzazioni necessarie per monitorare le metriche, creare dashboard e configurare policy di avviso, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Per visualizzare metriche e dashboard: Monitoring Viewer (roles/monitoring.viewer) sul progetto
  • Per creare e gestire dashboard e policy di avviso: Monitoring Editor (roles/monitoring.editor) 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 monitorare le metriche, creare dashboard e configurare policy di avviso. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per monitorare le metriche, creare dashboard e configurare policy di avviso sono necessarie le seguenti autorizzazioni:

  • Per visualizzare le dashboard: monitoring.dashboards.get sul progetto
  • Per creare dashboard: monitoring.dashboards.create sul progetto
  • Per configurare gli avvisi: monitoring.alertPolicies.create sul progetto

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

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

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Metriche disponibili per le estensioni VM

Le seguenti metriche sono disponibili per monitorare le estensioni VM in Monitoring:

Nome metrica Tipo di metrica Descrizione
Stato di applicazione delle estensioni VM compute.googleapis.com/vm_extensions/extension/enforcement_status Lo stato di applicazione di un'estensione VM di Compute Engine. Le etichette includono extension_name e status.

Per un elenco dei nomi delle estensioni, consulta Estensioni supportate.

I valori possibili per status includono:

  • ENFORCEMENT_STATE_UNSPECIFIED
  • INSTALLING
  • INSTALL_FAILED
  • INSTALLED
  • ROLLING_BACK
  • ROLLBACK_FAILED
  • ROLLED_BACK
  • INCOMPATIBLE
  • REMOVING
  • SERVICE_DISABLED
  • APPLYING_CONFIG
Stato di integrità delle estensioni VM compute.googleapis.com/vm_extensions/extension/health_status Lo stato di integrità di un'estensione VM. Le etichette includono extension_name e status.

Per un elenco dei nomi delle estensioni, consulta Estensioni supportate.

I valori possibili per status includono:

  • HEALTH_STATUS_UNSPECIFIED
  • STARTING
  • RUNNING
  • STOPPING
  • STOPPED
  • CRASHED
Utilizzo massimo della CPU dell'estensione VM compute.googleapis.com/vm_extensions/extension/cpu/max_usage Il tempo di CPU massimo utilizzato dall'estensione VM, espresso in percentuale.
Byte massimi di memoria utilizzati dall'estensione VM compute.googleapis.com/vm_extensions/extension/memory/used_bytes La memoria massima utilizzata dall'estensione VM, in byte.

Crea dashboard di monitoraggio personalizzate

Puoi creare dashboard di Monitoring con i grafici delle estensioni VM più pertinenti per il tuo caso d'uso. Per aggiungere un grafico a una dashboard, completa i seguenti passaggi:

  1. Nella console Google Cloud , seleziona Monitoring:

    Vai a Monitoraggio

  2. Nel riquadro di navigazione, seleziona Dashboard.
  3. Fai clic su Crea dashboard.
  4. Fai clic su Aggiungi widget.
  5. Nella finestra Aggiungi widget, per Dati, seleziona Metrica.
  6. Per selezionare una metrica, espandi il menu Seleziona una metrica e completa i seguenti passaggi:
    1. In Risorse attive, seleziona Istanza VM.
    2. In Categoria metrica, seleziona Vm_extensions.
    3. In Metrica, seleziona una metrica, ad esempio Stato di integrità dell'estensione VM. Per un elenco delle metriche disponibili, consulta Metriche disponibili per le estensioni VM.
    4. Fai clic su Applica.

Puoi aggiungere alla dashboard tutti i grafici che vuoi. Per saperne di più, consulta Crea e gestisci dashboard personalizzate.

Configura policy di avviso

Monitoring ti consente di creare avvisi e ricevere notifiche quando una metrica supera una soglia specificata. Ad esempio, puoi ricevere una notifica quando lo stato di integrità di un'estensione cambia in CRASHED.

Per creare una criterio di avviso, completa i seguenti passaggi:

  1. Nella console Google Cloud , seleziona Monitoraggio.

    Vai a Monitoraggio

  2. Nel riquadro di navigazione, seleziona Avvisi.
  3. Fai clic su Crea policy.
  4. Nella pagina Crea policy di avviso, configura la condizione di avviso completando i seguenti passaggi:
    1. Per selezionare una metrica, espandi il menu Seleziona una metrica e completa i seguenti passaggi:
      1. In Risorse attive, seleziona Istanza VM.
      2. In Categoria metrica, seleziona Vm_extensions.
      3. In Metrica, seleziona una metrica, ad esempio Stato di applicazione dell'estensione VM. Per un elenco delle metriche disponibili, consulta Metriche disponibili per le estensioni VM.
      4. Fai clic su Applica.
    2. Configura le condizioni di attivazione, ad esempio se l'etichetta status è uguale a INSTALL_FAILED.
  5. Segui le istruzioni per aggiungere canali di notifica e assegnare un nome alla policy.
  6. Fai clic su Crea policy.

Per saperne di più, consulta Crea policy di avviso.

Passaggi successivi