Marcio Cunha

NGINX lento? Cómo monitorear conexiones con stub_status

¿Tu NGINX responde lentamente? Descubre cómo usar el módulo stub_status para identificar cuellos de botella en conexiones simultáneas y optimizar tu servidor.

Marcio Cunha•3 min
También disponible en:PortuguêsEnglish
Resumen
  • El módulo stub_status ofrece métricas en tiempo real sobre el tráfico del servidor web.
  • Las conexiones altas en estados reading o writing indican cuellos de botella en el backend.
  • La activación del módulo requiere solo una directiva simple en el archivo de configuración.
  • La monitorización constante evita que los límites de conexiones simultáneas causen caídas.
  • El seguimiento vía stub_status es complementario a otras herramientas de diagnóstico en Linux.

¿Por qué tu NGINX tarda en responder?

Cuando un servidor web empieza a presentar alta latencia, la primera reacción suele ser reiniciar el servicio. Sin embargo, sin entender si el problema reside en conexiones bloqueadas, agotamiento de recursos o cuellos de botella en el backend, solo estás aplicando un parche temporal. NGINX, reconocido por su alto rendimiento, tiene una herramienta nativa llamada stub_status, que funciona como un panel de control básico para entender qué ocurre bajo el capó.

Entendiendo el módulo stub_status en la práctica

El stub_status es un módulo que muestra el estado actual de las conexiones de forma minimalista. Indica, por ejemplo, cuántas conexiones están esperando lectura, cuántas se están procesando y cuántas están inactivas (keep-alive). En la práctica, esto significa que puedes ver al instante si tu servidor está siendo sobrecargado por tráfico inesperado o si existe una aplicación lenta bloqueando tus trabajadores (workers).

Para verificar si tu binario de NGINX cuenta con este módulo, ejecuta el comando nginx -V 2>&1 | grep -o with-http_stub_status_module. Si el comando retorna la cadena, estás listo para configurar. De lo contrario, deberás recompilar NGINX, un proceso poco frecuente hoy en día, ya que la mayoría de los paquetes de distribución incluyen esta funcionalidad por defecto.

Cómo habilitar y consultar el estado

Configurar la monitorización toma pocos minutos. Debes crear o editar un bloque de ubicación (location) dentro de tu archivo de configuración (generalmente en /etc/nginx/sites-available/default o similar). Añade el siguiente fragmento de código:

location /nginx_status { stub_status; allow 127.0.0.1; deny all; }

Tras recargar NGINX con nginx -t && systemctl reload nginx, podrás acceder a http://localhost/nginx_status. Recuerda restringir el acceso a este endpoint a tu dirección IP, evitando exponer métricas internas a curiosos o atacantes. El resultado será un texto simple con números que revelan el pulso de tu servidor web.

Interpretando los cuellos de botella

Al observar las métricas, enfócate en los estados de las conexiones. Si el número de conexiones en reading es alto, el servidor tiene dificultades leyendo las cabeceras de los clientes, lo que sugiere problemas de red. Si el número de conexiones en writing es constante y elevado, tu NGINX podría estar esperando el procesamiento de un backend lento (como PHP-FPM o un clúster de microservicios), algo muy común en sistemas complejos, donde el problema no está en el servidor web, sino en cómo el sistema gestiona la carga y los pods.

El siguiente paso en la investigación

El stub_status es solo el principio. Si identificas que el problema no es NGINX, sino las conexiones TCP que llegan o salen del servidor, utiliza herramientas más profundas de diagnóstico. Puedes realizar una inspección detallada de red usando el comando tcpdump para capturar paquetes específicos, o monitorear el estado de las conexiones TCP con la utilidad ss, asegurando así una visión completa de la pila de comunicación.

Conclusión

Dominar la monitorización básica de tu servidor es un diferencial importante para cualquier ingeniero que busque estabilidad. Al integrar stub_status en tus rutinas de observabilidad, dejas de adivinar dónde está el error y pasas a tener datos concretos para tomar decisiones, ya sea ajustando timeouts o aumentando la capacidad de tus servidores.

La estabilidad de una infraestructura no proviene solo de hardware potente, sino de una gestión inteligente de los recursos. Utiliza las métricas nativas, automatiza la recolección si es necesario y nunca ignores las señales que envía el sistema antes de que ocurra un fallo grave.