Configura un avviso basato su query utilizzando MQL

Configura un avviso basato su query utilizzando MQL

Questo documento mostra come utilizzare Monitoring Query Language (MQL) per esplorare le metriche, creare grafici e configurare un avviso basato su query nella console Google Cloud. Se preferisci utilizzare l'API Cloud Monitoring, consulta Creazione di condizioni per i criteri di avviso.

In questo documento esegui le seguenti operazioni:

1. Creare un'istanza Compute Engine.

2. Vai all'editor di codice.

3. Esegui una query e crea un grafico.

4. Configurare un avviso basato su query.

Prima di iniziare

Per utilizzare MQL, devi creare un progetto Google Cloud e abilitare la fatturazione.

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

5. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

Quindi, configura le autorizzazioni e i canali di notifica.

1. Per ottenere le autorizzazioni necessarie per creare criteri di avviso con una condizione basata su MQL, chiedi all'amministratore di concederti il ruolo IAM Editor Monitoring (roles/monitoring.editor) per il tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

   Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

   Per ulteriori informazioni sui ruoli di Cloud Monitoring, consulta Controllare l'accesso con Identity and Access Management.

2. Assicurati di conoscere i concetti generali dei criteri di avviso, MQL e dell'editor di codice. Per ulteriori informazioni, consulta i seguenti argomenti:

   • Panoramica degli avvisi
   • Criteri di avviso con MQL
   • Utilizzare l'editor di codice per MQL

crea un'istanza Compute Engine

Per avere una risorsa Google Cloud da cui raccogliere le metriche, crea un'istanza Compute Engine completando questi passaggi:

1. Dal menu della console Google Cloud, seleziona Compute Engine.

   

2. Seleziona Crea istanza, quindi fai clic su Crea.

Nota: in caso di problemi durante la creazione di un'istanza, consulta la Guida rapida all'utilizzo di una VM Linux.

Vai all'editor di codice

Per iniziare a utilizzare MQL:

1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring e poi  Metrics Explorer:

   Vai a Metrics Explorer

2. Nella barra degli strumenti del riquadro del generatore di query, seleziona il pulsante il cui nome è  MQL o  PromQL.
3. Verifica che sia selezionato MQL nel pulsante di attivazione/disattivazione Lingua. Il pulsante di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.

Utilizza l'editor di codice per creare, testare ed eseguire query MQL.

Eseguire una query e creare un grafico

Crea una query che illustra l'utilizzo della CPU da parte dell'istanza:

1. Incolla la query seguente nell'editor di codice:

   fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
   | {
       top 1, max(val())
     ;
       bottom 1, min(val())
     }
   | union
   

   Questa query seleziona le serie temporali con l'utilizzo massimo e minimo della CPU per la creazione di grafici. Per maggiori informazioni su questa query, consulta Combinare le selezioni con union.

2. Fai clic su Esegui query. Il grafico mostra due righe che mostrano l'utilizzo massimo e minimo della CPU dell'istanza:

   

3. Per salvare il grafico, fai clic su Salva grafico. Assegna un nome al grafico e aggiungilo a una dashboard esistente o a una nuova. Quindi, fai clic su Salva.

Puoi accedere al grafico dalla pagina Panoramica di Monitoring oppure, se lo hai salvato in una dashboard, dalla pagina della dashboard.

Configura un avviso basato su query

Puoi creare un criterio di avviso per monitorare i risultati di una query. Per creare un criterio di avviso di questo tipo, completa i seguenti passaggi:

1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring e poi  Avvisi:

   Vai ad Avvisi

2. Nella pagina Avvisi, fai clic su Modifica canali di notifica. In questo passaggio, configurerai un indirizzo email per ricevere le notifiche di avviso.

   1. Nella pagina Canali di notifica, vai a Email e fai clic su Aggiungi nuovo.

   2. Inserisci nel campo Indirizzo email l'indirizzo email a cui vuoi che vengano inviate le notifiche di avviso.

   3. Inserisci una breve descrizione del canale, ad esempio "Avviso su chiamata", nel campo Nome visualizzato.

   4. Fai clic su Salva.

   5. Torna alla pagina Avvisi facendo clic su Indietro nell'intestazione della pagina.

3. Nella pagina Avvisi, fai clic su Crea criterio.

   Questa pagina illustra i passaggi per creare un criterio di avviso:

   1. Descrivi ciò per cui vuoi inviare un avviso.
   2. Fornire informazioni su come risolvere questo problema.
   3. Specificare un canale di notifica per l'avviso.

4. Per descrivere gli elementi per cui vuoi visualizzare l'avviso, fai clic su Nuova condizione. Questa azione apre l'editor di condizioni basato su modulo.

   1. In Modalità di configurazione dei criteri, seleziona Editor di codice (MQL o PromQL).

   2. Verifica che sia selezionato MQL nel pulsante di attivazione/disattivazione Lingua. Il pulsante di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.

   3. Inserisci la query che seleziona i dati da monitorare nell'editor di codice. La seguente query attiva un avviso quando il tempo di utilizzo della CPU della tua istanza rimane superiore a 20 secondi:

      fetch gce_instance::compute.googleapis.com/instance/cpu/usage_time
      | window 1m
      | condition val() > 20 's'
      

      L'operazione condition stabilisce la soglia di rendimento per cui vuoi inviare un avviso. Per maggiori informazioni su condition e su altre operazioni di avviso, consulta Avvisi nel riferimento MQL.

      Se è abilitata l'opzione Esecuzione automatica, il grafico MQL mostra i dati selezionati e una linea di soglia:

      

   4. Per configurare l'attivatore di avviso, fai clic su Avanti:

      1. Nel menu Trigger di avviso, seleziona il numero di serie temporali che deve soddisfare l'operazione di avviso prima che possa essere attivato il criterio di avviso. Puoi scegliere tra i seguenti criteri:

         • Un'unica serie temporale.
         • Un numero specifico di serie temporali.
         • Una percentuale della serie temporale.
         • Tutte le serie temporali.

      2. (Facoltativo) Espandi il menu Opzioni avanzate e inserisci o seleziona un valore nel campo Attiva quando la condizione è soddisfatta per questo periodo di tempo.

         Questo campo definisce per quanto tempo la condizione deve essere soddisfatta prima che venga attivato il criterio di avviso. La finestra di nuovo test non corrisponde alla finestra di allineamento utilizzata nella query MQL. Per saperne di più sulla relazione tra questi valori, consulta Periodo di allineamento e durata.

      3. Inserisci un nome per la condizione, ad esempio "Condizione MQL di base".

5. Per configurare le notifiche, la documentazione e il nome del criterio di avviso, fai clic su Avanti.

   1. Seleziona il canale di notifica che hai creato in precedenza.

   2. Scegli un livello di gravità.

   3. Inserisci il testo da inviare con qualsiasi notifica di avviso nel campo Documentazione. Questo testo fornisce in genere a chi risponde informazioni che li aiuta ad affrontare il problema. Per questo esercizio, inserisci "L'utilizzo della CPU ha superato i 20 secondi".

   4. Inserisci un nome per il criterio di avviso nel campo Nome criterio di avviso. Questo valore consente di distinguere le notifiche da criteri di avviso diversi.

6. Salva il criterio facendo clic su Crea criterio.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi:

1. Vai alla pagina Identity and Access Management nella console Google Cloud:

   Vai alle impostazioni progetto

2. Fai clic su Spegni e segui le istruzioni.

Passaggi successivi

• Scopri di più sull'utilizzo dell'editor di codice.
• Esplora una serie di esempi di MQL.
• Scopri di più sui criteri di avviso basati su MQL.
• Scopri come richiamare le query MQL dall'API Cloud Monitoring.
• Esplora i dettagli di MQL nel Riferimento MQL.
• Leggi le nostre risorse su DevOps ed esplora il programma di ricerca di DORA.