Questo documento descrive l'utilizzo di Prometheus Query Language (PromQL) in Cloud Monitoring. PromQL fornisce un'alternativa alle interfacce basate su menu di Metrics Explorer e a Monitoring Query Language (MQL) per la creazione di grafici e dashboard.
Puoi utilizzare PromQL per eseguire query e tracciare i grafici dei dati di Cloud Monitoring dalle seguenti origini:
- I servizi Google Cloud, come Google Kubernetes Engine o Compute Engine, che scrivono le metriche descritte negli elenchi delle metriche di sistema di Cloud Monitoring.
- Metriche definite dall'utente, come metriche basate su log e metriche definite dall'utente di Cloud Monitoring.
- Google Cloud Managed Service per Prometheus, la soluzione multi-cloud completamente gestita per Prometheus di Google Cloud. Per informazioni sul servizio gestito, compreso il supporto da PromQL, consulta Google Cloud Managed Service per Prometheus.
Puoi anche utilizzare strumenti come Grafana per tracciare un grafico dei dati delle metriche importati in Cloud Monitoring. Le metriche disponibili includono le metriche di Managed Service per Prometheus e Cloud Monitoring documentate negli elenchi di metriche. Per informazioni sulla configurazione di Grafana e di altri strumenti basati sull'API Prometheus, consulta la documentazione di Managed Service per Prometheus su Grafana.
Puoi anche importare le tue dashboard Grafana in Cloud Monitoring.
Convenzioni di denominazione
Le convenzioni di denominazione e il modello delle metriche di Prometheus sono diversi da quelli utilizzati da Cloud Monitoring. Per utilizzare PromQL per eseguire query sui dati delle metriche di Monitoring, devi convertire i nomi di Cloud Monitoring in equivalenti compatibili con PromQL. Per informazioni sulle convenzioni di denominazione, consulta Mappatura delle metriche di Cloud Monitoring a PromQL.
Accesso a PromQL in Cloud Monitoring
Puoi utilizzare PromQL dalla scheda Codice nelle pagine seguenti della console Google Cloud:
- Metrics Explorer
- Aggiungi un grafico durante la creazione di dashboard personalizzate.
Per informazioni su come accedere e utilizzare l'editor, consulta Utilizzo dell'editor PromQL.
Regole e avvisi di Prometheus
Puoi utilizzare PromQL per creare regole di registrazione e avviso su qualsiasi metrica in Cloud Monitoring utilizzando gli avvisi di tipo Prometheus in Managed Service per Prometheus. Per maggiori informazioni, consulta Valutazione e avvisi delle regole gestite o Valutazione e avvisi di regole con deployment autonomo.
Apprendimento di PromQL
Per apprendere le nozioni di base sull'utilizzo di PromQL, consigliamo di consultare la documentazione open source. Le seguenti risorse possono aiutarti a iniziare:
Differenze PromQL
PromQL per Cloud Monitoring potrebbe funzionare in modo leggermente diverso rispetto a PromQL upstream. Per un elenco di queste differenze, consulta le differenze PromQL.