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 nel tuo parco risorse 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 i 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 Cloud de Confiance by S3NS . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Seleziona la scheda in base a come prevedi di utilizzare gli esempi in questa pagina:

    Console

    Quando utilizzi la console Cloud de Confiance per accedere ai servizi e alle API Cloud de Confiance by S3NS , 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 Cloud de Confiance .

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

Per monitorare le estensioni VM in Monitoring sono disponibili le seguenti metriche:

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, vedi Estensioni supportate.

I valori possibili per status sono i seguenti:

  • 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 della CPU dell'estensione VM compute.googleapis.com/vm_extensions/extension/cpu/max_usage Tempo massimo di CPU utilizzato dall'estensione VM espresso in percentuale.
Byte massimi utilizzati della memoria dell'estensione VM compute.googleapis.com/vm_extensions/extension/memory/used_bytes Memoria utilizzata massima dell'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:

  1. Nella console Cloud de Confiance , 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 integrità 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ù, 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.

  1. Nella console Cloud de Confiance , 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, 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 alla policy.
  6. Fai clic su Crea policy.

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

Passaggi successivi