Creare criteri di avviso basati su PromQL (console)

Questa pagina descrive come creare criteri di avviso basati su PromQL utilizzando la console Google Cloud.

Prima di iniziare

  1. Per ottenere le autorizzazioni necessarie per creare criteri di avviso basati su PromQL nella console Google Cloud, chiedi all'amministratore di concederti il ruolo IAM Editor di monitoraggio (roles/monitoring.editor) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

    Potresti anche riuscire a 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 e di PromQL in Cloud Monitoring. Per ulteriori informazioni, consulta i seguenti argomenti:

  3. Configura i canali di notifica che vuoi utilizzare per ricevere eventuali avvisi. Per motivi di ridondanza, ti consigliamo di creare più tipi di canali di notifica. Per saperne di più, consulta la pagina Creare e gestire i canali di notifica.

  4. Se la query PromQL nel criterio di avviso fa riferimento a qualsiasi metrica, le metriche devono già esistere in Monitoring quando crei il criterio di avviso.

Crea criteri di avviso PromQL

Per creare un criterio di avviso basato su PromQL dalla console Google Cloud, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina  Avvisi:

    Vai ad Avvisi

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

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

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

  4. Verifica che PromQL sia selezionato 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.

  5. Inserisci la query PromQL che seleziona i dati da monitorare. Se l'opzione Esecuzione automatica non è attivata, fai clic su Esegui query.

    Ad esempio, la seguente query riassume la frequenza di importazione dei dati di registrazione della fatturazione in un intervallo di 60 secondi e determina se la frequenza riepilogata supera i 300 byte:

    sum(rate(logging_googleapis_com:billing_bytes_ingested{monitored_resource="global"}[60s]))>300

    Dopo aver eseguito la query, viene visualizzato un grafico. Per un progetto, questa query ha prodotto il seguente risultato:

    Grafico da una condizione di avviso PromQL dopo aver specificato l'avviso.

  6. Fai clic su Avanti e segui questi passaggi:

    1. Seleziona una Finestra di ripetizione test. Questo campo definisce per quanto tempo deve essere soddisfatta la condizione prima che venga attivata la criterio di avviso.

      Il valore predefinito è 0 sec. Con questa impostazione, una singola misurazione può generare una notifica. Per ulteriori informazioni e un esempio, consulta Impostazioni di periodo e durata dell'allineamento.

    2. Per selezionare la frequenza con cui gli avvisi valutano la query PromQL, scegli un valore per l'intervallo di valutazione.

    3. Inserisci un nome per la condizione e fai clic su Avanti.

  7. Fai clic su Avanti e segui questi passaggi:

    1. Aggiungi canali di notifica.

    2. Scegli un livello di gravità per gli incidenti.

    3. (Facoltativo) Aggiungi le etichette dei criteri di avviso e la documentazione.

    4. Inserisci un nome per il criterio di avviso.

  8. Fai clic su Crea criterio.

Per la procedura completa, vedi Gestire i criteri di avviso.