En este documento, se describe cómo configurar la implementación de Google Kubernetes Engine a fin de que puedas usar Google Cloud Managed Service para Prometheus para recopilar métricas del servicio de PROMEX para HAProxy. Este documento te muestra cómo hacer lo siguiente:
- Configurar el servicio de PROMEX para que HAProxy informe las métricas.
- Configurar un recurso PodMonitoring para 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 la colección implementada de forma automática, consulta la documentación de HAProxy para 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.
Para obtener más información, consulta HAProxy.
Requisitos previos
A fin de recopilar métricas del servicio de PROMEX para HAProxy mediante el servicio administrado para Prometheus y la colecció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 de HAProxy, debes usar la versión 2.4 de
haproxy_promex
o una posterior.Para obtener más información sobre los paneles disponibles, consulta Visualiza los paneles.
frontend
adecuado en la configuración.
La mayoría de las imágenes oficiales de Docker para versiones superiores o iguales a la 2.4 se compilan con este servicio habilitado.
El siguiente ejemplo de configuración se compiló con la documentación de HAProxy Enterprise. Funciona con Community Edition y se puede modificar para satisfacer necesidades específicas:
Modifica la configuración de HAProxy
Modifica la configuración de HAProxy como se muestra en el siguiente ejemplo:
Debes agregar cualquier línea precedida por el símbolo +
a tu configuración.
Para aplicar los cambios de configuración desde un archivo local, ejecuta el siguiente comando:
kubectl apply -n NAMESPACE_NAME -f FILE_NAME
También puedes usar Terraform para administrar tus opciones de configuración.
Si deseas verificar que el servicio de PROMEX para HAProxy emite métricas en los extremos esperados, haz lo siguiente:
- Configura la redirección de puertos mediante el siguiente comando:
kubectl -n NAMESPACE_NAME port-forward POD_NAME 8404
- Accede al extremo
localhost:8404/metrics
mediante el navegador o la utilidadcurl
en otra sesión de la terminal.
Define un recurso PodMonitoring
Para el descubrimiento de destinos, el operador de Managed Service para Prometheus requiere un recurso PodMonitoring que corresponda al exportador de HAProxy en el mismo espacio de nombres.
Puedes usar la siguiente configuración de PodMonitoring:
Asegúrate de que los valores de los camposport
y matchLabels
coincidan con los de los Pods de HAProxy que deseas supervisar.
HAProxy expone métricas de los destinos definidos en la opción de configuración bind
. Esta opción requiere que un usuario defina la dirección IP y el puerto que se escuchará en la recopilación de métricas.
Para aplicar los cambios de configuración desde un archivo local, ejecuta el siguiente comando:
kubectl apply -n NAMESPACE_NAME -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 de HAProxy:
Para aplicar los cambios de configuración desde un archivo local, ejecuta el siguiente comando:
kubectl apply -n NAMESPACE_NAME -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.
Verifica la configuración
Puedes usar el Explorador de métricas para verificar que configuraste correctamente el exportador de HAProxy. 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:
Dirígete al 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="haproxy", cluster="CLUSTER_NAME", namespace="NAMESPACE_NAME"}
Ver paneles
La integración de Cloud Monitoring incluye el panel HAProxy Prometheus Overview. Los paneles se instalan automáticamente cuando configuras la integración. También puedes ver vistas previas estáticas de los paneles sin instalar la integración.
Para ver un panel instalado, 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 Lista de paneles.
- Elige la categoría Integraciones.
- Haz clic en el nombre del panel, por ejemplo, DHAProxy Prometheus Overview.
Para obtener una vista previa estática del panel, haz lo siguiente:
-
En la consola de Google Cloud, ve a la página Integraciones:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- Haz clic en el filtro de la plataforma de implementación Kubernetes Engine.
- Localiza la integración de HAProxy y haz clic en Ver detalles.
- Selecciona la pestaña Paneles.
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.