Creare criteri di avviso con una condizione basata su PromQL (console)

In questa pagina viene descritto come creare un criterio di avviso con una connessione basata su PromQL utilizzando la console Google Cloud.

Prima di iniziare

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

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

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

  2. Assicurati di acquisire familiarità con i concetti generali dei criteri di avviso e PromQL in Cloud Monitoring. Per ulteriori informazioni, consulta i seguenti argomenti:

  3. Configura i canali di notifica che vuoi utilizzare per ricevere avvisi. Per motivi di ridondanza, ti consigliamo di creare più tipi di canali di notifica. Per ulteriori informazioni, vedi Creare e gestire i canali di notifica.

  4. Se la query PromQL nel criterio di avviso utilizza un modello la metrica deve esistere già.

Crea criteri di avviso PromQL

Per creare un criterio di avviso con una condizione basata su PromQL da nella 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 Monitoraggio.

  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 con l'opzione Lingua. Il pulsante di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti. consente di formattare la query.

  5. Inserisci la query PromQL per selezionare i dati da monitorare. Se l'opzione Esecuzione automatica non è abilitata, fai clic su Esegui query.

    Ad esempio, la seguente query riassume la percentuale di Dati di logging della fatturazione importati 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, vedrai un grafico. Per uno progetto, questa query ha prodotto il seguente risultato:

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

  6. Fai clic su Avanti e configura l'attivatore di avviso.

    1. Seleziona un valore per l'attivatore di avviso. Questo valore specifica il numero di serie temporali restituite dalla query soddisfare l'operazione di avviso prima che il criterio di avviso attivata. Puoi scegliere tra i seguenti criteri:

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

    2. Seleziona una Finestra di ripetizione. Questo campo definisce per quanto tempo sia soddisfatta prima dell'attivazione del criterio di avviso.

      Il valore predefinito è 0 sec. Con questa impostazione, una singola la misurazione può generare una notifica. Per ulteriori informazioni e vedi un esempio Impostazioni relative al periodo e alla durata di allineamento.

    3. Per selezionare la frequenza con cui l'avviso valuta la query PromQL, scegli un valore per Intervallo di valutazione.

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

  7. Aggiungi canali di notifica.

  8. (Facoltativo) Aggiungi etichette dei criteri di avviso e documentazione.

  9. Fai clic su Nome avviso e inserisci un nome per il criterio di avviso.

  10. Fai clic su Crea criterio.

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