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 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. Eseguendo query su Monarch anziché sui server Prometheus locali, ottieni 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 di cui è stato eseguito il deployment in modo autonomo. Puoi saltare questa procedura se vuoi solo eseguire l'esecuzione di query sulle metriche di Cloud Monitoring 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 la 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, chiamato progetto di ambito.
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 tale progetto. Un progetto di definizione dell'ambito può includere più di un progetto monitorato 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 query sulle metriche in un progetto di definizione dell'ambito e se questo progetto ospita un ambito delle metriche multiprogetto, puoi recuperare i dati da più progetti. Se l'ambito delle metriche contiene tutti i tuoi progetti, le query e le regole vengono valutate a livello globale.
Per ulteriori informazioni sulla definizione dell'ambito dei progetti e delle metriche, consulta Ambiti delle metriche. Per informazioni sulla configurazione dell'ambito delle metriche multiprogetto, consulta Visualizzare le metriche per più progetti.
Managed Service per i dati di Prometheus in Cloud Monitoring
Managed Service per Prometheus condivide il backend di archiviazione 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 Monitoring, e impostare avvisi in base a queste metriche. Puoi anche importare le tue dashboard Grafana in Cloud Monitoring.
Quando lavori con dati delle metriche, compresi i dati di Managed Service per Prometheus, in Cloud Monitoring, puoi utilizzare gli strumenti di query forniti da Cloud Monitoring:
Esecuzione di 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, procedi nel seguente modo:
-
Nel pannello di navigazione della console Google Cloud, seleziona Monitoring e poi leaderboard Metrics Explorer:
Nella barra degli strumenti del riquadro del generatore di query, seleziona il pulsante il cui nome è 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 fai clic su Esegui query:
up
Se i dati vengono importati, vedrai un grafico simile al 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 nei grafici di Metrics Explorer e 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 per creare grafici e dashboard, puoi anche utilizzare le interfacce basate su menu o MQL. Di seguito è riportata una query semplice in Metrics Explorer:
-
Nel pannello di navigazione della console Google Cloud, seleziona Monitoring e poi leaderboard Metrics Explorer:
Specifica i dati da visualizzare nel grafico. Oltre a utilizzare il pulsante PromQL descritto in precedenza, puoi utilizzare anche l'interfaccia basata su menu. Per creare una query, procedi nel seguente modo:
Nel riquadro Query Builder, fai clic su "Seleziona una metrica".
Nel campo di ricerca, digita "up/" per filtrare l'elenco, quindi seleziona Target Prometheus, quindi Su e infine 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 selezionando il pulsante PromQL. Questa traduzione potrebbe non convertire correttamente le funzioni dell'istogramma o altri operatori non comuni.
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 di Prometheus, il tipo di risorsa monitorata è prometheus_target. Le query di monitoraggio per le metriche di 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 di Google Cloud) in cui sono archiviati i dati. Questo valore corrisponde in genere alla regione del cluster GKE o dell'istanza di 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; potrebbero essere vuoti.namespace: lo spazio dei nomi GKE o il concetto correlato (potrebbe essere vuoto).job: l'etichetta del job della destinazione Prometheus, se nota; potrebbe essere vuota per i risultati della valutazione delle regole.instance: l'etichetta dell'istanza della destinazione 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.
- Importare le dashboard di Grafana in Cloud Monitoring.