Criteri di avviso con PromQL

Questa pagina illustra diversi metodi per creare criteri di avviso con una query PromQL nella relativa condizione.

I criteri di avviso con una condizione basata su PromQL offrono un'alternativa open source all'utilizzo delle query MQL (Monitoring Query Language) per configurare le condizioni dei criterio di avviso. Puoi utilizzare le query PromQL per creare condizioni complesse con funzionalità quali rapporti, soglie dinamiche e metriche combinate.

Se utilizzi Prometheus in ambienti esterni a Google Cloud o se utilizzi gli avvisi in Managed Service per Prometheus, puoi eseguire la migrazione delle regole di avviso di Prometheus ai criteri di avviso con una condizione basata su PromQL. In questo modo puoi gestire tutti i criteri di avviso in Cloud Monitoring.

Puoi anche importare dashboard Grafana in Cloud Monitoring.

• Per informazioni generali sull'utilizzo di PromQL in Monitoring, consulta PromQL in Cloud Monitoring.
• Per informazioni generali sui criteri di avviso, consulta Comportamento dei criteri di avviso basati su metriche.

Panoramica

Puoi creare criteri di avviso con una condizione basata su PromQL nei seguenti modi:

• Crea un criterio di avviso nella console Google Cloud e definisci una query PromQL nell'editor di codice.

• Crea un criterio di avviso con una condizione basata su PromQL utilizzando gcloud CLI o il costrutto AlertPolicy nell'API Monitoring.

• Esegui la migrazione delle regole di avviso e dei canali di notifica Prometheus a Cloud Monitoring utilizzando Google Cloud CLI.

Gli incidenti creati da un criterio di avviso con una condizione basata su PromQL vengono visualizzati nella console Google Cloud insieme agli altri incidenti. Puoi interagire con questi incidenti nella console Google Cloud.

Nota: gli incidenti creati da un criterio di avviso con una condizione basata su PromQL non seguono la durata della chiusura automatica del criterio di avviso. L'incidente viene invece chiuso automaticamente quando raggiunge un periodo di tempo prestabilito dopo l'ultima volta che la condizione è stata soddisfatta. Questo tempo è il più grande tra i 270 secondi e il doppio dell'intervallo di valutazione della condizione.

Le condizioni criterio di avviso PromQL possono fare riferimento a qualsiasi metrica in Cloud Monitoring, comprese le metriche di sistema di Google Cloud, le metriche personalizzate e basate su log e le metriche Prometheus. Devi tradurre i nomi delle metriche non Prometheus nella sintassi delle metriche PromQL. Per ulteriori informazioni, consulta Mappatura delle metriche di Monitoring a PromQL.

Limitazioni

Un criterio di avviso con una condizione basata su PromQL può avere una finestra di test di massimo 24 ore e un periodo di allineamento di massimo 24 ore. La somma della finestra di ripetizione del test e del periodo di allineamento deve essere al massimo di 25 ore.

Se la regola di avviso Prometheus fa riferimento a una metrica personalizzata, devi prima avere un descrittore della metrica personalizzata equivalente in Cloud Monitoring.

Prezzi

In generale, le metriche di sistema di Cloud Monitoring sono gratuite, mentre quelle di sistemi, agenti o applicazioni esterni non lo sono. Le metriche fatturabili vengono fatturate in base al numero di byte o al numero di campioni importati.

Per ulteriori informazioni sui prezzi di Cloud Monitoring, consulta i seguenti documenti:

• Riepilogo dei prezzi di Cloud Monitoring.
• Prezzi di Cloud Monitoring.

Passaggi successivi

Per informazioni sull'utilizzo della console Google Cloud per creare criteri di avviso con una query PromQL nella condizione, consulta Creare criteri di avviso con una condizione basata su PromQL (console).

Per informazioni su come creare criteri di avviso con PromQL direttamente utilizzando l'API Cloud Monitoring, consulta Creare criteri di avviso con una condizione basata su PromQL (API).

Per informazioni su come eseguire la migrazione delle regole di avviso PromQL ai criteri di avviso con una query PromQL, consulta Eseguire la migrazione delle regole e dei ricevitori di avviso da Prometheus.

Per informazioni sull'importazione delle dashboard di Grafana, consulta Importare le dashboard di Grafana in Cloud Monitoring.