Le query PromQL (Prometheus Query Language) in Cloud Monitoring ti consentono di creare policy di avviso con condizioni complesse, come rapporti tra metriche, soglie dinamiche basate su un'altra metrica e metriche combinate. Queste policy possono valutare fino a 2 anni di dati delle metriche.
Se utilizzi Prometheus in ambienti esterni a Google Cloud o utilizzi gli avvisi in Google Cloud Managed Service per Prometheus, puoi eseguire la migrazione delle regole di avviso di Prometheus alle policy di avviso basate su PromQL. La migrazione delle regole ti consente di gestire tutte le policy di avviso in Monitoring. Puoi anche importare le dashboard di Grafana in Cloud Monitoring. Per informazioni generali sull'utilizzo di PromQL e su come le policy di avviso valutano i dati, consulta PromQL in Cloud Monitoring e Comportamento delle policy di avviso basate su metriche.
Utilizza PromQL nelle policy di avviso di Cloud Monitoring
Puoi creare policy di avviso basate su PromQL nei seguenti modi:
Per creare una criterio di avviso nella console Google Cloud e definire una query PromQL nell'editor di codice, consulta Crea policy di avviso basate su PromQL (console).
Per creare una criterio di avviso basata su PromQL utilizzando gcloud CLI o il costrutto
AlertPolicynell'API Monitoring, consulta Crea policy di avviso basate su PromQL (API).Per eseguire la migrazione delle regole di avviso e dei canali di notifica di Prometheus a Cloud Monitoring utilizzando Google Cloud CLI, consulta Esegui la migrazione delle regole di avviso e dei ricevitori da Prometheus.
Gli avvisi creati da una criterio di avviso basata su PromQL vengono visualizzati nella console Google Cloud insieme agli altri avvisi. Puoi interagire con questi avvisi nella console Google Cloud .
Le condizioni della criterio di avviso basata su PromQL possono fare riferimento a qualsiasi metrica in Cloud Monitoring, incluse le metriche di sistema Google Cloud , le metriche personalizzate e basate su log e le metriche di Prometheus. Devi tradurre i nomi delle metriche non Prometheus nella sintassi delle metriche PromQL. Per saperne di più, consulta Mappatura delle metriche di Monitoring su PromQL.
Esegui query su oltre 2 anni di dati delle metriche
A differenza di altri tipi di criterio di avviso che supportano solo l'esecuzione di query su dati delle metriche di 25 ore, puoi utilizzare PromQL per generare avvisi su dati delle metriche fino a 2 anni. Ciò supporta casi d'uso come:
- Rilevamento di anomalie confrontando gli ultimi 5 minuti con lo stesso periodo di 5 minuti di una settimana fa.
- Esecuzione di una criterio di avviso di burn rate lento di 7 giorni.
- Ottenere il valore medio dell'ultimo mese e inviare un avviso se l'ora di dati più recente si discosta di più di 3 deviazioni standard da questa media.
- Utilizzo della funzione
predict_linearsull'ultima settimana di dati per verificare se supererai una soglia il giorno successivo.
Le policy di avviso PromQL che operano sulle ultime 25 ore di dati, come definito dalla somma del periodo di allineamento e di qualsiasi variazione temporale causata dall'utilizzo del modificatore offset, possono essere valutate ogni 30 secondi.
Le policy che operano su dati meno recenti vengono valutate con minore frequenza, con il periodo minimo determinato da quanto indietro nel tempo guarda la criterio di avviso:
| Intervallo di lookback delle query | Intervallo di valutazione minimo (predefinito) |
|---|---|
| Fino a 25 ore1 | 30 secondi |
| Da 25 ore a 8 giorni | 5 minuti |
| 8-16 giorni | 1 ora |
| 16-32 giorni | 2 ore |
| Da 32 a 93 giorni | 6 ore |
| Da 93 giorni a 2 anni | 12 ore |
1 Alcune metriche dei servizi Google Cloud supportano solo intervalli di valutazione di 30 secondi per un massimo di 23 ore e 30 minuti.
Assicurati di impostare le durate di rate in modo che siano almeno pari all'intervallo di valutazione, in modo che la criterio di avviso non perda dati. Ad esempio, se l'intervallo di valutazione è di 1 ora, la query dovrebbe essere simile a rate(metric[1h]).
Le condizioni che operano su più di 25 ore di dati hanno una scadenza della query di 2 minuti, che corrisponde alla scadenza in Metrics Explorer. Se la query PromQL non scade in Metrics Explorer, non scadrà nell'avviso.
Le policy di avviso PromQL sono molto più affidabili quando operano sugli ultimi 25 ore di dati. Per la massima affidabilità,
assicurati che la somma della finestra di riapprovazione, del periodo di allineamento e di qualsiasi variazione temporale
causata dall'utilizzo del modificatore offset sia al massimo di 25 ore.
Le finestre di riapprovazione sono disabilitate per le query di avviso PromQL che accedono a dati più vecchi di 25 ore.
Puoi inviare avvisi solo per le ultime 25 ore di dati per le metriche personalizzate (il prefisso custom.googleapis.com) e le metriche basate su log definite dall'utente (il prefisso logging.googleapis.com/user/).
Limitazioni
Non aggiungere filtri che utilizzano etichette dei metadati di sistema alle policy di avviso basate su PromQL.
Una criterio di avviso basata su PromQL può avere una finestra di nuovo test di massimo 24 ore. Se utilizzi una finestra di riapprovazione, la somma della finestra di riapprovazione, del periodo di allineamento e di qualsiasi variazione temporale causata dall'utilizzo del modificatore offset deve essere al massimo di 25 ore.
Se la regola di avviso di Prometheus fa riferimento a una metrica, devi prima avere un descrittore della metrica equivalente in Cloud Monitoring prima di creare la criterio di avviso basata su PromQL. Tuttavia, puoi eseguire l'override di questa convalida configurando la criterio di avviso basata su PromQL con l'API Cloud Monitoring. Per saperne di più, consulta Disabilita il controllo dell'esistenza delle metriche.
Se la criterio di avviso monitora un rapporto di metriche, imposta la durata su almeno il doppio dell'intervallo di valutazione. Durate più brevi possono generare falsi avvisi. Per saperne di più, consulta Falsi avvisi dovuti ad anomalie nel calcolo del rapporto.