Criteri di avviso con PromQL

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

I criteri di avviso con una condizione basata su PromQL forniscono un'alternativa open source all'utilizzo delle query Monitoring Query Language (MQL) per configurare le condizioni dei criterio di avviso. Puoi utilizzare le query PromQL per creare condizioni complesse con funzionalità come 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 tuoi criteri di avviso in Cloud Monitoring.

Puoi anche importare le dashboard di Grafana in Cloud Monitoring.

Panoramica

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

  • 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 la struttura AlertPolicy nell'API Monitoring.

  • Esegui la migrazione dei canali di notifica e delle regole di avviso Prometheus in 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.

Le condizioni del criterio di avviso PromQL possono fare riferimento a qualsiasi metrica in Cloud Monitoring, incluse le metriche di sistema di Google Cloud, quelle personalizzate e basate su log e le metriche di Prometheus. Devi tradurre i nomi delle metriche non Prometheus nella sintassi delle metriche PromQL. Per maggiori informazioni, consulta la pagina relativa alla 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 nuovo e del periodo di allineamento deve essere al massimo di 25 ore.

Se la regola di avviso di 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 provenienti da sistemi, agenti o applicazioni esterni. Le metriche fatturabili vengono fatturate in base al numero di byte o al numero di campioni importati.

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

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 di avviso e dei ricevitori da Prometheus.

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