Monitora le estensioni VM

Il monitoraggio dell'integrità e delle prestazioni delle estensioni VM ti aiuta a gestire l'utilizzo delle risorse e a risolvere i problemi nella tua flotta di istanze Compute Engine. Puoi utilizzare le dashboard di Cloud Monitoring per visualizzare l'utilizzo delle risorse, ad esempio il consumo di CPU o memoria, e configurare criteri di avviso per ricevere notifiche quando si verifica un evento, ad esempio un errore di installazione.

Questo documento descrive come monitorare le estensioni VM gestite dal gestore di estensioni VM sulle istanze Compute Engine utilizzando Cloud Monitoring e ti aiuta a svolgere le seguenti operazioni:

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 a come prevedi di utilizzare gli esempi in questa pagina:

    Console

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

    gcloud

    1. 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.

  • 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.

      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 .

Prima di iniziare

Prima di monitorare le estensioni, assicurati di aver completato le seguenti operazioni:

Ruoli IAM richiesti

Per ottenere le autorizzazioni necessarie per monitorare le metriche e creare dashboard, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto.

Per ottenere le autorizzazioni necessarie per monitorare le metriche e gestire i dashboard, 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 e gestire i dashboard. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per monitorare le metriche e gestire i dashboard 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 il monitoraggio delle estensioni VM in Monitoring:

Nome metrica Tipo di metrica Descrizione
Stato di applicazione dell'estensione 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, vedi Estensioni supportate.

I valori possibili per status sono:

  • ENFORCEMENT_STATE_UNSPECIFIED
  • INSTALLING
  • INSTALL_FAILED
  • INSTALLED
  • ROLLING_BACK
  • ROLLBACK_FAILED
  • ROLLED_BACK
  • INCOMPATIBLE
  • REMOVING
  • SERVICE_DISABLED
  • APPLYING_CONFIG
Stato di integrità dell'estensione 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, vedi Estensioni supportate.

I valori possibili per status sono:
  • HEALTH_STATUS_UNSPECIFIED
  • STARTING
  • RUNNING
  • STOPPING
  • STOPPED
  • CRASHED
Utilizzo massimo CPU estensione VM compute.googleapis.com/vm_extensions/extension/cpu/max_usage Tempo massimo di CPU utilizzato dall'estensione VM espresso in percentuale.
Byte massimi di memoria utilizzati dall'estensione VM compute.googleapis.com/vm_extensions/extension/memory/used_bytes Memoria utilizzata massima dell'estensione VM in byte.

Creare 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:

  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, seleziona Metrica per Dati.
  6. Per selezionare la metrica, espandi il menu Seleziona una metrica e poi segui questi passaggi:
    1. Per Risorse attive, seleziona Istanza VM.
    2. Per Categoria metrica, seleziona Vm_extensions.
    3. Per Metrica, seleziona una metrica, ad esempio Stato di integrità dell'estensione VM. Per un elenco delle metriche disponibili, consulta Metriche disponibili per il monitoraggio delle estensioni VM.
    4. Fai clic su Applica.

Puoi aggiungere alla dashboard tutti i grafici che vuoi. Per saperne di più, vedi 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.

  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 criterio di avviso, definisci le condizioni di avviso e i canali di notifica.
    1. Per selezionare la metrica, espandi il menu Seleziona una metrica e poi segui questi passaggi:
      1. Per Risorse attive, seleziona Istanza VM.
      2. Per Categoria metrica, seleziona Vm_extensions.
      3. Per Metrica, seleziona una metrica, ad esempio Stato di applicazione dell'estensione VM. Per un elenco delle metriche disponibili, consulta Metriche disponibili per il monitoraggio delle estensioni VM.
      4. Fai clic su Applica.
    2. Configura le condizioni di attivazione, ad esempio controllando se l'etichetta status è INSTALL_FAILED.
  5. Segui le istruzioni per aggiungere canali di notifica e assegnare un nome al criterio.
  6. Fai clic su Crea policy.

Per saperne di più, consulta Creare criteri di avviso.

Passaggi successivi