Skip to main content

Agentes y módulos generados por el plugin

El plugin creará un agente por cada URL de NGINX indicada. El nombre del agente se calcula aplicando un hash MD5 sobre el netloc de la URL (host:port), y el alias se corresponde con dicho netloc (por ejemplo, 192.168.0.10). En cada agente se incluirán los módulos obtenidos al parsear el texto plano del endpoint stub_status de NGINX.

El módulo Status se crea siempre para cada agente, con valor 1 si el endpoint es alcanzable, indicando que NGINX está funcionando. Si el endpoint no es alcanzable, el plugin reporta el error en la información de ejecución. El resto de campos numéricos se incluyen como módulos generic_data (valores instantáneos) o generic_data_inc (contadores incrementales con cálculo de tasa por segundo), siguiendo el formato <prefix><MetricName>.

Los campos disponibles en el stub_status de NGINX, y que dan lugar a módulos, son:

Status: Estado del endpoint stub_status (1=UP, 0=DOWN) — siempre se monitoriza (generic_proc).
Active_connections: Conexiones activas totales, incluyendo las en espera (generic_data).
Accepts: Conexiones aceptadas acumuladas desde el inicio de NGINX (generic_data_inc, tasa por segundo).
Handled: Conexiones gestionadas acumuladas desde el inicio de NGINX (generic_data_inc, tasa por segundo).
          Si el valor es menor que Accepts, NGINX está descartando tráfico.
Requests: Peticiones de cliente procesadas acumuladas desde el inicio de NGINX (generic_data_inc, tasa por segundo).
Reading: Conexiones leyendo cabeceras de petición del cliente (generic_data).
Writing: Conexiones escribiendo respuesta al cliente o procesando petición (generic_data).
Waiting: Conexiones keep-alive inactivas esperando la siguiente petición (generic_data).

Mapeo de tipos de módulo

Métrica Tipo de módulo Pandora FMS Descripción
Status generic_proc Estado del endpoint (1=reachable, 0=DOWN). Permite configurar alertas críticas cuando el valor es 0.
Active_connections generic_data Conexiones activas actuales (gauge). Incluye conexiones en lectura, escritura y espera.
Accepts generic_data_inc Conexiones aceptadas acumuladas. Pandora FMS calcula la tasa por segundo automáticamente.
Handled generic_data_inc Conexiones gestionadas acumuladas. Pandora FMS calcula la tasa por segundo automáticamente. Si la tasa es menor que la de Accepts, NGINX está descartando conexiones.
Requests generic_data_inc Peticiones procesadas acumuladas. Pandora FMS calcula la tasa por segundo automáticamente (peticiones/s).
Reading generic_data Conexiones en estado de lectura de cabeceras (gauge).
Writing generic_data Conexiones en estado de escritura de respuesta (gauge).
Waiting generic_data Conexiones keep-alive inactivas (gauge). Un valor alto es normal con keep-alive habilitado.

Marcadores extra_data

El plugin asigna identificadores estables en el campo extra_data de cada agente y módulo, siguiendo el formato nginx:<kind>:<identifier>, para permitir su identificación posterior desde la consola, dashboards, extensiones o consultas SQL:

  • Agente: nginx:target:<url_saneada> — identifica el target NGINX monitorizado.
  • Módulo Status: nginx:metric_status:<url_saneada>
  • Módulos de métricas: nginx:metric_<metric_name>:<url_saneada> — por ejemplo nginx:metric_active_connections:..., nginx:metric_accepts:..., etc.

Estos marcadores no contienen ni el nombre del agente ni el del módulo, sino el identificador externo (la URL del target), que es estable y significativo a nivel de dominio.

Back to top