Questo documento descrive come configurare il deployment di Google Kubernetes Engine in modo da poter utilizzare Google Cloud Managed Service per Prometheus per raccogliere metriche da Kube State Metrics. Questo documento mostra come:
- Configura Kube State Metrics per generare report sulle metriche.
- Accedi a una dashboard in Cloud Monitoring per visualizzare le metriche.
- Configura regole di avviso per monitorare le metriche.
Queste istruzioni si applicano solo se utilizzi la raccolta gestita con Managed Service per Prometheus. Se utilizzi la raccolta autogestita, consulta il repository di origine per Kube State Metrics per informazioni sull'installazione.
Queste istruzioni sono fornite come esempio e dovrebbero funzionare nella maggior parte degli ambienti Kubernetes. Se hai difficoltà a installare un'applicazione o un exporter a causa di norme di sicurezza o organizzative restrittive, ti consigliamo di consultare la documentazione open source per ricevere assistenza.
Prerequisiti
Per raccogliere le metriche da Kube State Metrics utilizzando Managed Service per Prometheus e la raccolta gestita, il deployment deve soddisfare i seguenti requisiti:
- Il cluster deve eseguire Google Kubernetes Engine versione 1.28.15-gke.2475000 o successive.
- Devi eseguire Managed Service per Prometheus con la raccolta gestita abilitata. Per maggiori informazioni, consulta la guida introduttiva alla raccolta gestita.
- Per utilizzare le dashboard disponibili in Cloud Monitoring per l'integrazione, devi utilizzare
kube-state-metrics
versione 2.4.2 o successive.Per ulteriori informazioni sulle dashboard disponibili, vedi Installare le dashboard.
Kube State Metrics gestito
GKE offre un deployment completamente gestito di kube state metrics come alternativa alla configurazione di questa integrazione. Il pacchetto installabile fornisce un set selezionato di metriche di stato di Kube che richiede meno sforzo per la configurazione. Questa integrazione fornisce metriche aggiuntive, ma richiede anche più impegno per la configurazione. Per esaminare il pacchetto selezionato prima di decidere quale utilizzare, consulta Pacchetto: Kube State Metrics.
Installa Kube State Metrics
Puoi utilizzare la seguente configurazione per installare Kube State Metrics:
Per applicare le modifiche alla configurazione da un file locale, esegui questo comando:
kubectl apply -f FILE_NAME
Puoi anche utilizzare Terraform per gestire le configurazioni.
Definisci regole e avvisi
Puoi utilizzare la seguente configurazione Rules
per definire
gli avvisi sulle tue metriche:
Per applicare le modifiche alla configurazione da un file locale, esegui questo comando:
kubectl apply -f FILE_NAME
Puoi anche utilizzare Terraform per gestire le configurazioni.
Per saperne di più sull'applicazione delle regole al cluster, vedi Valutazione e avvisi delle regole gestite.
Questa configurazione diRules
è stata adattata dalle regole e dagli avvisi forniti al repository kube-state-metrics.
Verificare la configurazione
Puoi utilizzare Metrics Explorer per verificare di aver configurato correttamente Kube State Metrics. Potrebbero essere necessari uno o due minuti prima che Cloud Monitoring acquisisca le metriche.
Per verificare che le metriche vengano importate, 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 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 ti consente di formattare la query.
- Inserisci ed esegui la seguente query:
up{job="kube-state-metrics", cluster="CLUSTER_NAME", namespace="gmp-public"}
Installare dashboard
Cloud Monitoring fornisce una raccolta di dashboard di esempio per le integrazioni. La libreria di esempi include dashboard "Prometheus", che puoi installare per visualizzare i tuoi dati nella console Google Cloud .
Tieni presente che la dashboard Panoramica di Prometheus del cluster Kubernetes richiede l'installazione di Node Exporter. Il dashboard Panoramica di Prometheus Pod Kubernetes richiede l'installazione di Node Exporter e cAdvisor/Kubelet.
Per installare una dashboard dalla libreria di esempi:
-
Nella console Google Cloud , vai alla pagina
Dashboard:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Seleziona la scheda Libreria di esempi.
- Scegli la categoria Altro.
- (Facoltativo) Per visualizzare un'anteprima statica di una dashboard senza installarla, fai clic su Anteprima.
- Seleziona i dashboard che vuoi installare, poi fai clic su
Importa.
Per saperne di più sull'installazione delle dashboard, consulta Installare dashboard di esempio.
Risoluzione dei problemi
Per informazioni sulla risoluzione dei problemi di importazione delle metriche, vedi Problemi di raccolta dagli esportatori in Risoluzione dei problemi lato importazione.