Dopo aver disegnato Google Cloud Managed Service per Prometheus, puoi eseguire query sui dati inviati al servizio gestito e visualizzare i risultati in grafici e dashboard.
Questo documento descrive gli ambiti delle metriche, che determinano i dati su cui puoi eseguire query, e come utilizzare Cloud Monitoring per recuperare e utilizzare i dati raccolti.
Tutte le interfacce di query per Managed Service per Prometheus sono configurate per recuperare i dati da Monarch utilizzando l'API Cloud Monitoring. Se esegui query su Monarch anziché sui dati dei server Prometheus locali, ottieni un monitoraggio globale su larga scala.
Prima di iniziare
Se non hai ancora eseguito il deployment del servizio gestito, configura la raccolta gestita o la raccolta con deployment automatico. Puoi saltare questo passaggio se ti interessa solo eseguire query sulle metriche di Cloud Monitoring utilizzando PromQL.
Ambiti di query e metriche
I dati su cui puoi eseguire query sono determinati dall'ambito delle metriche del costrutto Cloud Monitoring, indipendentemente dal metodo utilizzato per eseguire query sui dati.
Un ambito delle metriche di monitoraggio è un costrutto di sola lettura che consente di eseguire query sui dati delle metriche appartenenti a più progetti Google Cloud. Ogni ambito delle metriche è ospitato da un progetto Google Cloud designato, chiamato progetto di definizione.
Per impostazione predefinita, un progetto è il progetto di definizione dell'ambito per il proprio ambito delle metriche, che contiene le metriche e la configurazione per quel progetto. Un progetto di definizione dell'ambito può avere più di un progetto monitorato nel suo ambito delle metriche e le metriche e le configurazioni di tutti i progetti monitorati nell'ambito delle metriche sono visibili al progetto di definizione dell'ambito. Un progetto monitorato può anche appartenere a più ambiti di metriche.
Quando esegui query sulle metriche in un progetto di definizione dell'ambito e questo progetto ospita un ambito delle metriche multi-project, puoi recuperare i dati da più progetti. Se l'ambito delle metriche contiene tutti i progetti, le query e le regole vengono valutate a livello globale.
Per ulteriori informazioni sull'ambito dei progetti e sull'ambito delle metriche, consulta Ambiti delle metriche. Per informazioni sulla configurazione dell'ambito delle metriche per più progetti, consulta Visualizzare le metriche per più progetti.
Dati di Managed Service per Prometheus in Cloud Monitoring
Managed Service per Prometheus condivide il backend di archiviazione dei dati, Monarch, con Cloud Monitoring. Puoi utilizzare tutti gli strumenti forniti da Cloud Monitoring con i dati raccolti da Managed Service per Prometheus. Ad esempio, puoi utilizzare Metrics Explorer, come descritto in Console Google Cloud per il monitoraggio, e puoi impostare avvisi in base a queste metriche. Puoi anche importare le dashboard di Grafana in Cloud Monitoring.
Quando utilizzi i dati delle metriche, inclusi i dati di Managed Service per Prometheus, in Cloud Monitoring, puoi utilizzare gli strumenti di query forniti da Cloud Monitoring:
Eseguire query utilizzando PromQL in Cloud Monitoring
Il modo più semplice per eseguire query sui dati di Prometheus è utilizzare la pagina Metrics Explorer di Cloud Monitoring nella console Google Cloud. Per verificare che i dati di Prometheus vengano raccolti correttamente:
-
Nella console Google Cloud, vai alla pagina leaderboard Esplora metriche:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante code MQL o code PromQL.
Verifica che PromQL sia selezionato nel pulsante di attivazione/disattivazione Lingua. Il pulsante di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.
Inserisci la seguente query nell'editor e poi fai clic su Esegui query:
up
Se i dati vengono importati, viene visualizzato un grafico come il seguente:
Per informazioni su come eseguire query sulle metriche di sistema di Cloud Monitoring utilizzando PromQL, consulta PromQL per le metriche di Cloud Monitoring.
Per ulteriori informazioni sull'utilizzo di PromQL in Metrics Explorer e nei grafici di Cloud Monitoring, consulta PromQL in Cloud Monitoring.
Altre opzioni di query in Cloud Monitoring
Per visualizzare i dati di Prometheus come serie temporali di Cloud Monitoring e per creare grafici e dashboard, puoi anche utilizzare le interfacce basate su menu o MQL. Di seguito è riportata una semplice query in Metrics Explorer:
-
Nella console Google Cloud, vai alla pagina leaderboard Esplora metriche:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Specifica i dati da visualizzare nel grafico. Oltre a utilizzare il pulsante PromQL descritto in precedenza, puoi anche utilizzare l'interfaccia basata su menu. Per creare una query:
Nel riquadro Query Builder, fai clic su "Seleziona una metrica".
Nel campo di ricerca, digita "up/" per filtrare l'elenco, quindi seleziona Prometheus Target, Up e Prometheus/up/gauge.
Fai clic su "Applica".
Il grafico risultante da questa query mostra gli stessi dati del grafico mostrato nell'esempio PromQL.
Le query create utilizzando l'interfaccia basata su menu possono essere convertite in PromQL selezionato il pulsante PromQL. Questa traduzione potrebbe non convertire correttamente le funzioni di istogramma o altri operatori insoliti.
La risorsa prometheus_target
In Cloud Monitoring, i dati delle serie temporali vengono scritti in base a un tipo di risorsa monitorata. Per le metriche Prometheus, il tipo di risorsa monitorata è
prometheus_target. Le query di monitoraggio per le metriche Prometheus non scritte in PromQL devono specificare questo tipo di risorsa.
La risorsa prometheus_target ha le seguenti etichette, che puoi utilizzare per filtrare e manipolare i dati sottoposti a query:
project_id: l'identificatore del progetto Google Cloud associato a questa risorsa.location: la posizione fisica (regione Google Cloud) in cui vengono memorizzati i dati. Questo valore corrisponde in genere alla regione del cluster GKE o dell'istanza Compute Engine. Se i dati vengono raccolti da un deployment AWS o on-premise, il valore potrebbe essere la regione Google Cloud più vicina.cluster: il cluster GKE o un concetto correlato; potrebbe essere vuoto.namespace: lo spazio dei nomi GKE o un concetto correlato; potrebbe essere vuoto.job: l'etichetta del job del target Prometheus, se nota; potrebbe essere vuota per i risultati della valutazione delle regole.instance: l'etichetta dell'istanza del target Prometheus, se nota; potrebbe essere vuota per i risultati della valutazione delle regole.
I valori di queste etichette vengono impostati durante la raccolta.
Passaggi successivi
- Configura gli avvisi PromQL utilizzando Cloud Monitoring.
- Importa le dashboard di Grafana in Cloud Monitoring.