Dopo aver eseguito il deployment di 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 è possibile 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. L'esecuzione di query su Monarch anziché sui dati provenienti da server Prometheus locali offre un monitoraggio globale su larga scala.
Prima di iniziare
Se non hai già eseguito il deployment del servizio gestito, configura la raccolta gestita o la raccolta con deployment autonomo. Puoi saltare questo passaggio se ti interessa eseguire query sulle metriche di Cloud Monitoring solo utilizzando PromQL.
Ambiti di query e metriche
I dati su cui è possibile eseguire query sono determinati dall'ambito delle metriche del costrutto di Cloud Monitoring, indipendentemente dal metodo utilizzato per eseguire query sui dati.
Un ambito delle metriche di Monitoring è 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, denominato progetto di ambito.
Per impostazione predefinita, un progetto è il progetto di definizione dell'ambito per il proprio ambito delle metriche e l'ambito delle metriche contiene le metriche e la configurazione del progetto. Un progetto di definizione dell'ambito può avere più progetti monitorati nell'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ù di un ambito delle metriche.
Quando esegui una query sulle metriche in un progetto di definizione dell'ambito e se quel progetto di ambito ospita un ambito delle metriche con più progetti, 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 delle metriche, consulta Ambiti delle metriche. Per informazioni sulla configurazione dell'ambito delle metriche per più progetti, consulta Visualizzare le metriche per più progetti.
Managed Service per i dati 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 Esplora metriche, come descritto in Console Google Cloud per Monitoring, e puoi impostare avvisi in base a queste metriche. Puoi anche importare le tue dashboard Grafana in Cloud Monitoring.
Quando si lavora con i dati delle metriche, compresi i dati di Managed Service per Prometheus, in Cloud Monitoring è possibile utilizzare gli strumenti di query forniti da Cloud Monitoring:
Esecuzione di query con PromQL in Cloud Monitoring
Il modo più semplice per eseguire query sui dati Prometheus è utilizzare la pagina Metrics Explorer di Cloud Monitoring nella console Google Cloud. Per verificare che i dati di Prometheus vengano raccolti correttamente, segui questi passaggi:
-
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 di creazione di query, seleziona il pulsante con il nome code MQL o code PromQL.
Verifica che l'opzione PromQL sia selezionata nell'opzione di attivazione/disattivazione Lingua. L'opzione di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che ti consente di formattare la query.
Inserisci la seguente query nell'editor, quindi fai clic su Esegui query:
up
Se i dati vengono importati, vedrai un grafico come il seguente:
Per informazioni su come eseguire query sulle metriche di sistema di Cloud Monitoring utilizzando PromQL, consulta Le metriche di PromQL per 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 Prometheus come serie temporali di Cloud Monitoring e creare grafici e dashboard, puoi anche utilizzare le interfacce basate su menu, o MQL. Di seguito viene mostrata una query semplice 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 Target Prometheus, seleziona Up e infine Prometheus/up/gauge.
Fai clic su "Applica".
Il grafico risultante da questa query mostra gli stessi dati del grafico mostrato nell'esempio di PromQL.
Le query create utilizzando l'interfaccia basata su menu possono essere convertite in PromQL selezionando il pulsante PromQL. Questa traduzione potrebbe non convertire correttamente le funzioni dell'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 località fisica (regione Google Cloud) in cui sono archiviati 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 il concetto correlato; potrebbe essere vuoto.namespace: lo spazio dei nomi GKE o il 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
- Configurare gli avvisi PromQL utilizzando Cloud Monitoring.
- Importare le dashboard di Grafana in Cloud Monitoring.