En este artículo veremos cómo monitorizar NGINX Ingress Controller sobre Kubernetes utilizando Prometheus y Grafana con el stack más común en producción. Partiremos de la instalación de kube prometheus stack y terminaremos con paneles listos, alertas básicas y buenas prácticas para observabilidad.
En Q2BSTUDIO somos una empresa de desarrollo de software, expertos en aplicaciones a medida y software a medida, especialistas en inteligencia artificial, ciberseguridad, servicios cloud AWS y Azure, servicios de inteligencia de negocio y power bi, además de automatización y agentes IA para empresas. Integramos observabilidad desde el diseño para que tus plataformas escalen con fiabilidad y seguridad. Conoce nuestros servicios cloud AWS y Azure y potencia tus decisiones con Business Intelligence y Power BI.
Requisitos previos recomendados: cluster de Kubernetes operativo, kubectl y Helm configurados, permisos de administrador de cluster y un Ingress Controller basado en ingress nginx o compatible con métricas Prometheus.
Instalación de kube prometheus stack con Helm: añade el repositorio de charts, actualiza índices e instala el stack en un espacio de nombres dedicado. Ejemplo de comandos habituales: helm repo add prometheus-community https://prometheus-community.github.io/helm-charts; helm repo update; helm install monitoring prometheus-community/kube-prometheus-stack --namespace monitoring --create-namespace. Este chart despliega Prometheus Operator, Prometheus, Alertmanager y Grafana, además de reglas y dashboards base para Kubernetes.
Habilitar métricas en NGINX Ingress Controller: si usas el chart oficial de ingress nginx, activa el endpoint de métricas y el ServiceMonitor para que Prometheus las recoja automáticamente. Ejemplo de valores típicos al instalar o actualizar con Helm: controller.metrics.enabled=true; controller.metrics.serviceMonitor.enabled=true; controller.metrics.serviceMonitor.namespace=monitoring; controller.metrics.service.annotations opcionales si quieres ajustar intervalos de scrape. Un comando de referencia sería: helm upgrade --install ingress-nginx ingress-nginx --repo https://kubernetes.github.io/ingress-nginx --namespace ingress-nginx --create-namespace --set controller.metrics.enabled=true --set controller.metrics.serviceMonitor.enabled=true --set controller.metrics.serviceMonitor.namespace=monitoring. Esto crea el ServiceMonitor adecuado y expone el puerto de métricas, habitualmente 10254.
Validación rápida: verifica que el ServiceMonitor esté creado en monitoring y que el target de ingress nginx aparezca como up en Prometheus. Comprueba también que las métricas existan con una consulta sencilla como up{job=ingress-nginx} o inspeccionando series que comienzan por nginx_ingress_controller_ según la versión del controlador.
Paneles en Grafana: expón Grafana del stack con un Service tipo LoadBalancer o mediante port-forward y accede con las credenciales iniciales del chart. Importa un dashboard de la comunidad específico para NGINX Ingress Controller o utiliza los que el chart incluye por defecto. Es recomendable un panel que muestre solicitudes por segundo, latencia p50 p90 p99 por Ingress o servicio, códigos 4xx y 5xx, conexiones activas, tamaño de respuestas y saturación de los pods del controlador.
Consultas PromQL útiles para comenzar: tasa de errores 5xx por Ingress con rate(nginx_ingress_controller_requests{status=~5..}[5m]); latencia p95 por Ingress con histogram_quantile 0.95 sum by le,ingress rate(nginx_ingress_controller_request_duration_seconds_bucket[5m]); tráfico por ruta con sum by path rate(nginx_ingress_controller_requests[5m]); conexiones activas con avg by pod nginx_ingress_controller_nginx_process_connections. Ajusta nombres de métricas según tu versión del controlador.
Alertas recomendadas en PrometheusRule: pico sostenido de 5xx superior al umbral que definas, subida de latencia p95 por encima del objetivo durante varios minutos, número de conexiones o uso de CPU y memoria del controlador cercano a límites, y caídas de endpoints de backends detrás del Ingress. Estas alertas pueden enviarse a Slack, correo u otras integraciones mediante Alertmanager.
Buenas prácticas de producción: etiqueta tus Ingress y Services con metadatos de entorno y aplicación para facilitar filtros en Grafana; limita la cardinalidad de etiquetas como path o host si son extremadamente variables; usa retención de datos acorde a tus necesidades de auditoría; versiona dashboards y reglas en Git; y combina los paneles operativos con cuadros de mando ejecutivos en herramientas de analítica como power bi para cerrar el ciclo de valor con negocio.
Cómo te ayuda Q2BSTUDIO: integramos observabilidad desde el primer sprint en arquitecturas cloud nativas, definimos SLIs y SLOs, creamos dashboards y pipelines de datos y conectamos métricas técnicas con KPIs de negocio. Si necesitas optimizar costes, mejorar resiliencia o acelerar go to market, nuestro equipo de ingeniería y ciencia de datos está listo para ayudarte con soluciones de ia para empresas, ciberseguridad, agentes IA, y modernización en la nube. Descubre cómo impulsamos tu infraestructura con servicios cloud AWS y Azure.
Conclusión: con kube prometheus stack y Grafana puedes monitorizar NGINX Ingress Controller de forma robusta y escalable en Kubernetes. Habilita métricas, recoge datos con ServiceMonitor, despliega dashboards accionables y define alertas que protejan la experiencia de tus usuarios. En Q2BSTUDIO unimos ingeniería, inteligencia artificial y analítica avanzada para que la observabilidad sea un acelerador real de tu negocio.