Entradas Mensuales

Síguenos en:

Canal Oficial Telegram de elhacker.NET Grupo Facebook elhacker.NET Twitter elhacker.NET Canal Youtube elhacker.NET Comunidad Steam: Grupo elhacker.NET Mastodon

Entradas populares

PostHeaderIcon Módulo Nginx VTS (Virtual Host Traffic Status)


 El módulo VTS de NGINX ofrece supervisión del tráfico en tiempo real para tu servidor web. Proporciona estadísticas por host virtual, métricas del servidor de origen y seguimiento de los códigos de respuesta HTTP. Y lo mejor de todo es que te ofrece capacidades de supervisión al nivel de NGINX Plus sin el coste de una licencia comercial.


La supervisión del tráfico de tu servidor NGINX es fundamental para mantener una infraestructura web en buen estado. Sin la visibilidad adecuada, no es posible identificar cuellos de botella, realizar un seguimiento del uso del ancho de banda ni resolver problemas de rendimiento de forma eficaz.

 

El módulo «stub_status» integrado en NGINX solo proporciona recuentos básicos de conexiones. Muestra las conexiones activas, las conexiones aceptadas y las solicitudes gestionadas. Sin embargo, carece de detalles fundamentales como estadísticas por host, seguimiento del tiempo de respuesta y desglose de los códigos de estado HTTP.

Ejemplo respuesta stub_status:

Active connections: 200 
server accepts handled requests
 10007125 10007125 14605734 
Reading: 0 Writing: 125 Waiting: 78 


El módulo VTS de NGINX resuelve estas limitaciones. Realiza un seguimiento individual del tráfico de cada host virtual. Además, supervisa los servidores backend de origen, el rendimiento de la caché y los criterios de filtrado personalizados.

NGINX Plus cuesta miles de dólares al año por su panel de control. El módulo VTS ofrece una funcionalidad similar de forma gratuita. A continuación se muestra una comparación entre ambos:

 

Característica stub_status Módulo VTS NGINX Plus
Conexiones activas ✓ ✓ ✓
Estadísticas por host ✗ ✓ ✓
Monitorización de upstream ✗ ✓ ✓
Códigos de estado HTTP ✗ ✓ ✓
Seguimiento del tiempo de respuesta ✗ ✓ ✓
Estadísticas de caché ✗ ✓ ✓
Panel integrado ✗ ✓ ✓
Exportación a Prometheus ✗ ✓ ✓
Coste Gratis Gratis

$$$

 

Por lo tanto, el módulo VTS ofrece una excelente alternativa para aquellas organizaciones que necesitan una supervisión avanzada sin tener que hacer frente a los costes propios de una solución empresarial.


 

 Instalar VTS

Compilar: 

cd /tmp
NGINX_VER=$(nginx -v 2>&1 | grep -oE '[0-9]+\.[0-9]+\.[0-9]+')

wget "https://nginx.org/download/nginx-${NGINX_VER}.tar.gz"
tar -xzf "nginx-${NGINX_VER}.tar.gz"
git clone https://github.com/vozlt/nginx-module-vts.git

cd "nginx-${NGINX_VER}"
./configure --with-compat --add-dynamic-module=../nginx-module-vts
make modules 

 Añadir:

sudo cp objs/ngx_http_vhost_traffic_status_module.so /usr/lib64/nginx/modules/
sudo restorecon -v /usr/lib64/nginx/modules/ngx_http_vhost_traffic_status_module.so
rm -rf /tmp/nginx-${NGINX_VER}* /tmp/nginx-module-vts 

 Activar:

 Cargar el módulo en la primera línea de /etc/nginx/nginx.conf (antes de events y http):

load_module /usr/lib64/nginx/modules/ngx_http_vhost_traffic_status_module.so;

 

Activar la zona de memoria compartida dentro del bloque http { ... } de /etc/nginx/nginx.conf:

http {
    vhost_traffic_status_zone;
    ...
}

 Exponer el panel en un bloque server privado (por ejemplo, en el mismo bloque interno donde tuvieras stub_status, restringido a localhost o a tu IP):

server {
    listen 127.0.0.1:8080;
    server_name localhost;

    location /status {
        vhost_traffic_status_display;
        vhost_traffic_status_display_format html;
        allow 127.0.0.1;
        deny all;
    }
} 

 Configuración básica de VTS


Una configuración mínima de VTS requiere dos directivas. La primera habilita la zona de memoria compartida para las estadísticas. La segunda crea el punto final de visualización de estado.

A continuación se muestra un ejemplo de configuración básica:

load_module modules/ngx_http_vhost_traffic_status_module.so;

user nginx;
worker_processes auto;
worker_rlimit_nofile 4096;

error_log /var/log/nginx/error.log warn;
pid /var/run/nginx.pid;

events {
    worker_connections 1024;
}

http {
    include /etc/nginx/mime.types;
    default_type application/octet-stream;

    server_tokens off;
    sendfile on;
    keepalive_timeout 65;

    # Enable VTS shared memory zone
    vhost_traffic_status_zone;

    server {
        listen 80 default_server;
        server_name _;

        location / {
            root /usr/share/nginx/html;
            index index.html;
        }

        # VTS status page
        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;

            # Restrict access to localhost only
            allow 127.0.0.1;
            deny all;
        }
    }
} 

 

Cómo entender el panel de control de VTS


El módulo VTS ofrece un panel de control HTML integrado. Muestra métricas en tiempo real en un formato fácil de leer. El panel de control se actualiza automáticamente sin necesidad de actualizar la página.


Sección de métricas principales

La sección superior muestra estadísticas de todo el servidor:

  •     Conexiones: conexiones activas, de lectura, de escritura y en espera
  •     Solicitudes: total de solicitudes procesadas desde el último reinicio
  •     Zonas del servidor: desglose del tráfico por host virtual

Zonas de servidor

Cada host virtual aparece como una zona de servidor independiente. Para cada zona, VTS realiza un seguimiento de:

  •     Recuento de solicitudes: total de solicitudes recibidas
  •     Bytes entrantes/salientes: consumo de ancho de banda
  •     Códigos de respuesta: recuentos de 1xx, 2xx, 3xx, 4xx y 5xx
  •     Tiempo de respuesta: tiempo medio de procesamiento de las solicitudes


Zonas de origen

Si utilizas NGINX como proxy inverso, VTS supervisa cada backend de origen. Puedes ver qué servidores gestionan el tráfico e identificar los backends que no funcionan correctamente.

 

Formatos de salida para la integración


El módulo VTS admite múltiples formatos de salida. Esta flexibilidad permite la integración con diversos sistemas de supervisión.
Panel de control en HTML

El formato HTML ofrece un panel de control visual para la supervisión manual: 

location /status {
    vhost_traffic_status_display;
    vhost_traffic_status_display_format html;
} 

 

API JSON

Utiliza el formato JSON para el acceso programático:

curl -s 'http://localhost/status/format/json' 

 

La respuesta JSON incluye todas las métricas en un formato estructurado. Analiza estos datos con herramientas como jq para su procesamiento automatizado.

Métricas de Prometheus

Para la integración con Prometheus, utiliza el formato de Prometheus: 

curl -s 'http://localhost/status/format/prometheus' 

 Esto devuelve métricas en el formato de exposición de Prometheus:

# HELP nginx_vts_info Nginx info
# TYPE nginx_vts_info gauge
nginx_vts_info{hostname="example.com",module_version="v0.2.5",version="1.28.1"} 1
# HELP nginx_vts_main_connections Nginx connections
# TYPE nginx_vts_main_connections gauge
nginx_vts_main_connections{status="active"} 1
nginx_vts_main_connections{status="reading"} 0
nginx_vts_main_connections{status="writing"} 1
nginx_vts_main_connections{status="waiting"} 0 

 Añade este punto final a tu configuración de recopilación de datos de Prometheus para realizar un seguimiento continuo.

 

Configuración avanzada: supervisión de múltiples sitios web


Los entornos de producción suelen alojar varios sitios web. El módulo VTS realiza un seguimiento de cada host virtual por separado. Esto permite analizar el ancho de banda y el rendimiento de cada sitio web. Para obtener más detalles sobre la configuración de varios dominios, consulta nuestra guía sobre hosts virtuales de NGINX.

A continuación se muestra un ejemplo de configuración de múltiples sitios web: 

http {
    vhost_traffic_status_zone;

    # Main website
    server {
        listen 80;
        server_name example.com;

        location / {
            root /var/www/example.com;
            index index.html;
        }
    }

    # Blog subdomain
    server {
        listen 80;
        server_name blog.example.com;

        location / {
            root /var/www/blog;
            index index.html;
        }
    }

    # API server
    server {
        listen 80;
        server_name api.example.com;

        location / {
            proxy_pass http://backend_api;
        }
    }

    # Status dashboard - restricted access
    server {
        listen 80;
        server_name status.example.com;

        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
            allow 10.0.0.0/8;
            allow 127.0.0.1;
            deny all;
        }
    }
} 

 

Cada bloque de servidor genera sus propias estadísticas. Puedes consultarlas individualmente en la sección «Zonas de servidor» del panel de control.


Filtrado personalizado del tráfico


El módulo VTS admite filtros de tráfico personalizados. Estos filtros permiten clasificar el tráfico según cualquier variable de NGINX. Entre los casos de uso más habituales se incluyen el seguimiento por agente de usuario, país o volumen de almacenamiento.
Filtrado por agente de usuario

Realiza un seguimiento por separado del tráfico procedente de diferentes clientes: 

server {
    listen 80;
    server_name example.com;

    # Track by User-Agent type
    vhost_traffic_status_filter_by_set_key $http_user_agent agent::*;

    location / {
        root /var/www/example.com;
        index index.html;
    }
} 

 

Esta configuración genera estadísticas independientes para cada cadena de User-Agent única. Podrás identificar el tráfico de bots, los usuarios de dispositivos móviles y navegadores específicos.


Filtrado por país mediante GeoIP


Si tienes instalado el módulo GeoIP, podrás realizar un seguimiento del tráfico por país. Nuestra guía de GeoIP2 para NGINX explica cómo configurar el filtrado geográfico: 

http {
    geoip_country /usr/share/GeoIP/GeoIP.dat;

    vhost_traffic_status_zone;
    vhost_traffic_status_filter_by_set_key $geoip_country_code country::*;

    server {
        listen 80;
        server_name example.com;
        # ... rest of configuration
    }
} 

Esta configuración muestra qué países generan más tráfico hacia tu servidor.


Supervisión de los servidores de origen


El módulo VTS realiza un seguimiento automático del rendimiento de los servidores de origen. Esta función resulta muy valiosa para las implementaciones con equilibrio de carga. Puedes optimizar aún más tus conexiones con los servidores de origen utilizando el keepalive de origen para la agrupación de conexiones.

A continuación se muestra un ejemplo de supervisión de servidores de origen: 

 

http {
    vhost_traffic_status_zone;

    upstream backend_api {
        server 192.168.1.10:8080;
        server 192.168.1.11:8080;
        server 192.168.1.12:8080;
    }

    server {
        listen 80;
        server_name api.example.com;

        location / {
            proxy_pass http://backend_api;
        }
    }
} 

 El panel de control muestra métricas para cada servidor de origen:

  •     Número de solicitudes por servidor de fondo
  •     Tiempos de respuesta por servidor
  •     Códigos de estado HTTP de cada servidor de fondo
  •     Ponderación del servidor y estado de funcionamiento


Esta información ayuda a identificar rápidamente los servidores de fondo lentos o con fallos.


Limitación del tráfico con VTS


Además de la supervisión, el módulo VTS puede limitar el tráfico. Utiliza esta función para evitar el abuso del ancho de banda o aplicar políticas de uso justo.

Limitación por zona de servidor

Limitar el tráfico total de un host virtual:

server {
    listen 80;
    server_name example.com;

    # Limit to 100 requests per second
    vhost_traffic_status_limit_traffic server:example.com 100rps;

    location / {
        root /var/www/example.com;
        index index.html;
    }
} 

 

Filtrar por zona de filtro

Aplica límites a criterios de filtro específicos:

http {
    vhost_traffic_status_zone;

    # Limit Googlebot to 10 requests per second
    vhost_traffic_status_limit_traffic_by_set_key $http_user_agent agent::Googlebot 10rps;

    server {
        listen 80;
        server_name example.com;
        vhost_traffic_status_filter_by_set_key $http_user_agent agent::*;
        # ... rest of configuration
    }
} 

Esto protege tu servidor de los rastreadores agresivos, al tiempo que permite el tráfico normal.


Persistencia de las estadísticas tras los reinicios


Por defecto, las estadísticas de VTS se reinician cuando se reinicia NGINX. La función «dump» conserva las estadísticas tras los reinicios.

Activar la persistencia de las estadísticas: 

http {
    vhost_traffic_status_zone;
    vhost_traffic_status_dump /var/lib/nginx/vts.db;

    # ... rest of configuration
} 

Crea el directorio con los permisos adecuados:

mkdir -p /var/lib/nginx
chown nginx:nginx /var/lib/nginx 

 Ahora tus estadísticas de tráfico se conservan tras los reinicios de NGINX y del servidor.

Prácticas recomendadas de seguridad


Hacer pública la página de estado de VTS conlleva riesgos de seguridad. Las estadísticas revelan la arquitectura interna del servidor y los patrones de tráfico. Sigue estas prácticas de seguridad:
Restricción por dirección IP

Permite el acceso únicamente desde redes de confianza: 

location /status {
    vhost_traffic_status_display;
    vhost_traffic_status_display_format html;

    # Allow internal networks
    allow 10.0.0.0/8;
    allow 172.16.0.0/12;
    allow 192.168.0.0/16;
    allow 127.0.0.1;
    deny all;
} 

Utilizar la autenticación básica

Añade protección mediante contraseña para mayor seguridad. Consulta nuestra guía completa sobre la autenticación básica de NGINX con htpasswd para obtener instrucciones detalladas de configuración:

location /status {
    vhost_traffic_status_display;
    vhost_traffic_status_display_format html;

    auth_basic "VTS Status";
    auth_basic_user_file /etc/nginx/.htpasswd;

    allow 10.0.0.0/8;
    deny all;
} 

Crea el archivo de contraseñas:

htpasswd -c /etc/nginx/.htpasswd admin

 Desactivar los tokens del servidor

Ocultar la información sobre la versión de NGINX en las respuestas:

http {
    server_tokens off;
    # ... rest of configuration
} 

Esto impide que los atacantes aprovechen las vulnerabilidades específicas de cada versión.

Integración con Grafana


Combina las métricas de VTS Prometheus con Grafana para obtener visualizaciones atractivas. Esta configuración permite realizar análisis de tendencias históricas y configurar alertas. Si tu infraestructura utiliza Graphite en lugar de Prometheus, el módulo NGINX para Graphite envía las métricas de NGINX directamente a Graphite sin necesidad de un exportador intermedio.
Crear una tarea de recopilación de datos de Prometheus

Añade lo siguiente a tu archivo prometheus.yml: 

scrape_configs:
  - job_name: 'nginx-vts'
    static_configs:
      - targets: ['nginx-server:80']
    metrics_path: /status/format/prometheus 

 

Importar un panel de Grafana


La comunidad ofrece paneles de Grafana ya creados para las métricas de VTS. Importa el panel con el ID 2949 del repositorio de paneles de Grafana para empezar rápidamente.



Configura alertas para las métricas críticas:


    Altas tasas de errores 5xx
    Picos de tráfico inusuales
    Tiempos de respuesta lentos
    Fallos del servidor backend
Ejemplo panel ID 24237:

Solución de problemas comunes


El módulo no se carga

Si NGINX no se inicia tras añadir el módulo, comprueba el registro de errores:

tail -f /var/log/nginx/error.log

 Entre las causas más comunes se incluyen:

    Ruta del módulo incorrecta en la directiva `load_module`
    Incompatibilidad entre la versión del módulo y la versión de NGINX
    Falta la directiva de zona de memoria compartida

Las estadísticas no aparecen

Si el panel de control no muestra datos, comprueba lo siguiente:

  •     Que la directiva `vhost_traffic_status_zone` se encuentre en el bloque `http`
  •     Que el tráfico llegue a tu servidor (comprueba los registros de acceso)
  •     Que se pueda acceder a la ubicación del estado

Errores de permiso denegado

Si te aparecen errores de permiso al acceder a la página de estado:

# Check SELinux status
getenforce

# If enforcing, add the proper context
semanage fcontext -a -t httpd_sys_content_t "/var/lib/nginx(/.*)?"
restorecon -Rv /var/lib/nginx 

Configuración completa para producción

A continuación se presenta una configuración completa y lista para producción que combina todas las mejores prácticas: 

load_module modules/ngx_http_vhost_traffic_status_module.so;

user nginx;
worker_processes auto;
worker_rlimit_nofile 4096;

error_log /var/log/nginx/error.log warn;
pid /var/run/nginx.pid;

events {
    worker_connections 1024;
}

http {
    include /etc/nginx/mime.types;
    default_type application/octet-stream;

    server_tokens off;
    sendfile on;
    keepalive_timeout 65;

    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$http_x_forwarded_for"';

    access_log /var/log/nginx/access.log main;

    # VTS Configuration
    vhost_traffic_status_zone;
    vhost_traffic_status_dump /var/lib/nginx/vts.db;

    # Upstream backends
    upstream app_servers {
        server 192.168.1.10:8080 weight=3;
        server 192.168.1.11:8080 weight=2;
        server 192.168.1.12:8080 backup;
    }

    # Main application server
    server {
        listen 80;
        server_name example.com www.example.com;

        vhost_traffic_status_filter_by_set_key $http_user_agent agent::*;

        location / {
            proxy_pass http://app_servers;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }

        location /static {
            alias /var/www/static;
            expires 30d;
        }
    }

    # Monitoring server - internal access only
    server {
        listen 8080;
        server_name _;

        allow 10.0.0.0/8;
        allow 127.0.0.1;
        deny all;

        # HTML dashboard
        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }

        # Prometheus metrics
        location /metrics {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format prometheus;
        }

        # JSON API
        location /status/json {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format json;
        }
    }
} 

 

Fuentes:

https://www.getpagespeed.com/server-setup/nginx/nginx-vts-module