Criteri di avviso con PromQL

Questa pagina illustra 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 di 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 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 l'interfaccia alla gcloud CLI o il costrutto AlertPolicy nell'API Monitoring.

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

Le condizioni criterio di avviso PromQL possono fare riferimento a qualsiasi metrica in Cloud Monitoring, incluse le metriche di sistema di 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 ulteriori informazioni, consulta Mappare le metriche di monitoraggio a PromQL.

Limitazioni

Un criterio di avviso con una condizione basata su PromQL può avere una finestra di nuovo test di massimo 24 ore e un periodo di allineamento di massimo 24 ore. La somma della finestra di nuovo 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 provenienti da 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:

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 utilizzando direttamente 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 di regole di avviso e destinatari da Prometheus.

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