Skip to main content

Discovery

Este plugin puede integrarse con el Discovery de Pandora FMS.

Para ello se debe cargar el paquete ".disco" que puede descargar desde la librería de Pandora FMS:

https://pandorafms.com/library/

Una vez cargado, se podrán monitorizar las instancias de HAProxyNGINX creando tareas de Discovery desde la sección Management > Discovery > Application > HAProxyNGINX

Para cada tarea se solicitarán los siguientes datos mínimos en el paso HAProxyNGINX Basic:

  • HAProxyNGINX StatsStatus URLs: URLs del endpoint de estadísticasstub_status de HAProxy,NGINX, separadas por comas o una por línea. Cada URL generará un agente.
  • Username: usuario del endpoint de HAProxyNGINX si requiere autenticación básica,sica HTTP, opcional
  • Password: contraseña del endpoint de HAProxyNGINX si requiere autenticación básica,sica HTTP, opcional
  • Verify SSL: activo si es necesario verificar que la URL tenga certificado SSL, por defecto inactivo
  • Transfer mode: modo de transferencia (native o tentacle), opcional
  • Tentacle IP: ip del tentacle, opcional
  • Tentacle port: Puerto del tentacle, opcional

En el paso HAProxyNGINX Advanced se podrán configurar opciones adicionales:

  • Module prefix: prefijo para añadir a todos los nombres de módulos creados, opcional
  • MonitorRequest frontends:timeout: habilitatiempo máximo de espera para la monitorizaciópetición deHTTP filasen desegundos, tipo frontendopcional (type=0),por opcional
    • defecto
  • Monitor backends: habilita la monitorización de filas de tipo backend (type=1), opcional
  • Monitor servers: habilita la monitorización de filas de tipo server (type=2), opcional10)
  • Allow list: expresión regular para incluir únicamente los módulos cuyo nombre coincida, opcional
  • Deny list: expresión regular para excluir módulos cuyo nombre coincida, opcional

Las tareas completadas con éxito tendrán un resumen de ejecución con la siguiente información:

  • Total agents : Número total de agentes generados por la tarea.
  • Total modules: Número total de módulos generados por la tarea.

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étricaTipo de módulo Pandora FMSDescripción
Statusgeneric_procEstado del endpoint (1=reachable, 0=DOWN). Permite configurar alertas críticas cuando el valor es 0.
Active_connectionsgeneric_dataConexiones activas actuales (gauge). Incluye conexiones en lectura, escritura y espera.
Acceptsgeneric_data_incConexiones aceptadas acumuladas. Pandora FMS calcula la tasa por segundo automáticamente.
Handledgeneric_data_incConexiones gestionadas acumuladas. Pandora FMS calcula la tasa por segundo automáticamente. Si la tasa es menor que la de Accepts, NGINX está descartando conexiones.
Requestsgeneric_data_incPeticiones procesadas acumuladas. Pandora FMS calcula la tasa por segundo automáticamente (peticiones/s).
Readinggeneric_dataConexiones en estado de lectura de cabeceras (gauge).
Writinggeneric_dataConexiones en estado de escritura de respuesta (gauge).
Waitinggeneric_dataConexiones 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