En este documento, se describe cómo configurar tu implementación de Google Kubernetes Engine a fin de que puedas usar el servicio administrado de Google Cloud Managed Service para Prometheus a fin de recopilar métricas de las métricas de estado de Kube State Metrics. Este documento te muestra cómo hacer lo siguiente:
- Configura Kube State Metrics para informar métricas.
- Configurar un recurso PodMonitoring a fin de que Managed Service para Prometheus recopile las métricas exportadas.
- Acceder a un panel en Cloud Monitoring para ver las métricas
- Configura reglas de alerta para supervisar las métricas
Estas instrucciones se aplican solo si usas la colección administrada con Managed Service para Prometheus. Si usas una colección con implementación automática, consulta el repositorio de origen para Kube State Metrics a fin de obtener información sobre la instalación.
Estas instrucciones se proporcionan como ejemplo y se espera que funcionen en la mayoría de los entornos de Kubernetes. Si tienes problemas para instalar una aplicación o un exportador debido a políticas restringidas de la organización o de seguridad, te recomendamos que consultes la documentación de código abierto a fin de obtener asistencia.
Requisitos previos
Para recopilar métricas de Kube State Metrics mediante Managed Service para Prometheus y la recopilación administrada, la implementación debe cumplir con los siguientes requisitos:
- Tu clúster debe ejecutar la versión 1.21.4-gke.300 o posterior de Google Kubernetes Engine.
- Debes ejecutar Managed Service para Prometheus con la colección administrada habilitada. Para obtener más información, consulta Primeros pasos con la recopilación administrada.
- Si quieres usar los paneles disponibles en Cloud Monitoring para la integración, debes usar la versión 2.4.2 o una posterior de
kube-state-metrics
.Para obtener más información sobre los paneles disponibles, consulta Instala los paneles.
Kube State Metrics administradas
GKE ofrece una implementación completamente administrada de Kube State Metrics como alternativa a la configuración de esta integración. El paquete instalable proporciona un conjunto bien definido y seleccionado de métricas de estado de kube que requiere menos esfuerzo para configurarse. Para obtener más información, consulta Paquete: Kube State Metrics.
Instala Kube State Metrics
Puedes usar la siguiente configuración para instalar Kube State Metrics:
Para aplicar los cambios de configuración desde un archivo local, ejecuta el siguiente comando:
kubectl apply -f FILE_NAME
También puedes usar Terraform para administrar tus opciones de configuración.
Define reglas y alertas
Puedes usar la siguiente configuración Rules
para definir alertas en las métricas:
Para aplicar los cambios de configuración desde un archivo local, ejecuta el siguiente comando:
kubectl apply -f FILE_NAME
También puedes usar Terraform para administrar tus opciones de configuración.
Para obtener más información sobre cómo aplicar reglas a tu clúster, consulta Evaluación y alertas de reglas administradas.
Esta configuración deRules
se adaptó de las reglas y alertas que se agregaron al repositorio kube-state-metrics.
Verifica la configuración
Puedes usar el explorador de métrocas para verificar que configuraste el exportador de forma correcta. Cloud Monitoring puede tardar uno o dos minutos en transferir las métricas.
Para verificar que se hayan transferido las métricas, haz lo siguiente:
-
En la consola de Google Cloud, ve a la página leaderboard Explorador de métricas:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea codeMQL o codeMQL.
- Verifica que PromQL esté seleccionado en el botón de activación PromQL. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
- Ingresa y ejecuta la siguiente consulta:
up{job="kube-state-metrics", cluster="CLUSTER_NAME", namespace="gmp-public"}
Instala paneles
Cloud Monitoring proporciona una biblioteca de paneles de muestra para integraciones. En la biblioteca de muestra, se incluyen los paneles “Prometheus” que puedes instalar para ver tus datos en la consola de Google Cloud.
Ten en cuenta que el panel Descripción general de Prometheus para el clúster de Kubernetes requiere que se instale Exportador de nodos. El panel Descripción general de Prometheus para Kubernetes requiere que estén instalados el Exportador de nodos y cAdvisor/Kubelet.
Para instalar un panel desde la biblioteca de muestra, haz lo siguiente:
-
En la consola de Google Cloud, ve a la página Paneles.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- Selecciona la pestaña Biblioteca de muestra.
- Elige la categoría Otros.
- Para ver una vista previa estática de un panel sin instalarlo, haz clic en Vista previa (opcional).
- Selecciona los paneles que deseas instalar y, luego, haz clic en Importar.
Para obtener más información sobre la instalación de paneles, consulta Instala paneles de muestra.
Soluciona problemas
Para obtener información sobre la solución de problemas de transferencia de métricas, consulta Problemas de recopilación de exportadores en Solución de problemas de transferencia.