Cómo habilitar la página de estado de NGINX


Nginx es un software de servidor web, equilibrador de carga y proxy inverso de código abierto, de alto rendimiento, confiable, escalable y totalmente extensible. Tiene un lenguaje de configuración simple y fácil de entender. También admite una multitud de módulos tanto estáticos (que han existido en Nginx desde la primera versión) como dinámicos (introducidos en la versión 1.9.11).

Uno de los módulos importantes en Nginx es el módulo ngx_http_stub_status_module que proporciona acceso a la información básica de estado de Nginx a través de una "página de estado". Muestra información como la cantidad total de conexiones de clientes activas, las aceptadas y las manejadas, la cantidad total de solicitudes y la cantidad de conexiones de lectura, escritura y espera.

En la mayoría de las distribuciones de Linux, la versión de Nginx viene con ngx_http_stub_status_module habilitado. Puede verificar si el módulo ya está habilitado o no usando el siguiente comando.

# nginx -V 2>&1 | grep -o with-http_stub_status_module

Si ve --with-http_stub_status_module como salida en la terminal, significa que el módulo de estado está habilitado. Si el comando anterior no devuelve ningún resultado, debe compilar NGINX desde la fuente utilizando –with-http_stub_status_module como parámetro de configuración como se muestra.

# wget http://nginx.org/download/nginx-1.13.12.tar.gz
# tar xfz nginx-1.13.12.tar.gz
# cd nginx-1.13.12/
# ./configure --with-http_stub_status_module
# make
# make install

Después de verificar el módulo, también deberá habilitar el módulo stub_status en el archivo de configuración de NGINX /etc/nginx/nginx.conf para configurar una URL localmente accesible (por ejemplo, http://www.example.com/nginx_status) para el página de estado.

location /nginx_status {
 	stub_status;
 	allow 127.0.0.1;	#only allow requests from localhost
 	deny all;		#deny all other hosts	
 }

Asegúrese de reemplazar 127.0.0.1 con la dirección IP de su servidor y también asegúrese de que esta página sea accesible solo para usted.

Después de realizar cambios de configuración, asegúrese de verificar la configuración de nginx en busca de errores y reinicie el servicio nginx para efectuar los cambios recientes utilizando los siguientes comandos.

# nginx -t
# nginx -s reload 

Después de recargar el servidor nginx, ahora puede visitar la página de estado de Nginx en la siguiente URL usando el programa curl para ver sus métricas.

# curl http://127.0.0.1/nginx_status
OR
# curl http://www.example.com/nginx_status

Importante: El módulo ngx_http_stub_status_module ha sido reemplazado por el módulo ngx_http_api_module en la versión Nginx 1.13.0.

¡Eso es todo! En este artículo, mostramos cómo habilitar la página de estado de Nginx en Linux. Utilice el formulario de comentarios a continuación para hacer cualquier pregunta.