Agentes y módulos generados por el plugin

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

El módulo statusStatus se crea siempre para cada fila,agente, independientementecon 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 los tokens de monitorización, con el fin de alertar ante estados DOWN/MAINT/STOP.ejecución. El resto de campos numéricos se incluyen como módulos generic_data (enteros/decimal)valores instantáneos) o generic_data_stringgeneric_data_inc (cadenas)contadores incrementales con cálculo de tasa por segundo), siguiendo el formato <pxnameprefix>_<svname>_<campoMetricName>.

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

pxname:Status: NombreEstado del proxyendpoint stub_status (frontend/backend/listener).1=UP, svname: Nombre del servicio (FRONTEND/BACKEND/server name).
qcur: Peticiones actualmente en cola.
qmax: Máximo de peticiones en cola.
scur: Sesiones actuales.
smax: Máximo de sesiones.
slim: Límite de sesiones configurado.
stot: Sesiones acumuladas.
bin: Bytes recibidos.
bout: Bytes enviados.
dreq: Peticiones denegadas (seguridad).
dresp: Respuestas denegadas (seguridad).
ereq: Errores de petición.
econ: Errores de conexión hacia el backend.
eresp: Errores de respuesta.
wretr: Reintentos de conexión.
wredis: Reenvíos a otro servidor.
status: Estado (UP/DOWN/MAINT/STOP/...)0=DOWN) — siempre se monitoriza.monitoriza weight:(generic_proc).
PesoActive_connections: totalConexiones /activas pesototales, 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 servidor.
act: Servidores activoscliente (backend)generic_data).
/Writing: servidorConexiones activo.escribiendo bck:respuesta Servidoresal cliente o procesando petición (generic_data).
Waiting: Conexiones keep-alive inactivas esperando la siguiente petición (generic_data).

Mapeo de backup (backend) / servidortipos de backup.módulo

chkfail:Chequeos TransicionesUP->DOWN.lastchg:Segundosdesde segundo).rate_lim:Límiteconfigurado 5-7).check_duration:Tiempo sobrelasúltimas1024peticiones.últimosegundotranscurrido.

Métrica	Tipo de saludmódulo fallidos.Pandora chkdown: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 última transición UP<->DOWN. downtime: Tiempo total de caída (segundos). qlimit: Maxqueue configurado para el servidor. pid: Process ID. iid: ID único del proxy. sid: ID del servidor (único dentro del proxy). throttle: Porcentaje de throttle actual. lbtot: Veces que el servidor fue seleccionado. tracked: ID del proxy/servidor si el tracking está habilitado. type: Tipo (0=frontend, 1=backend, 2=server, 3=socket). rate: Sesionestasa por segundo (últimoautomá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 nuevasAccepts, sesiones/s.NGINX rate_max:está Máximodescartando 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 sesioneslectura porde segundo. check_status: Estado del último health check. check_code: Código del checkcabeceras (capagauge).
Writing	generic_data	Conexiones en ms del último health check. hrsp_1xx: Respuestas HTTP con código 1xx. hrsp_2xx: Respuestas HTTP con código 2xx. hrsp_3xx: Respuestas HTTP con código 3xx. hrsp_4xx: Respuestas HTTP con código 4xx. hrsp_5xx: Respuestas HTTP con código 5xx. hrsp_other: Respuestas HTTP con otros códigos. hanafail: Detalleestado de checks de salud fallidos. req_rate: Peticiones HTTP por segundo. req_rate_max: Máximo de peticiones HTTP por segundo. req_tot: Total de peticiones HTTP recibidas. cli_abrt: Transferencias abortadas por el cliente. srv_abrt: Transferencias abortadas por el servidor. comp_in: Bytes de respuesta HTTP alimentados al compresor. comp_out: Bytes de respuesta HTTP emitidos por el compresor. comp_byp: Bytes que pasaron por alto al compresor HTTP. comp_rsp: Respuestas HTTP que fueron comprimidas. lastsess: Segundos desde la última sesión asignada. last_chk: Contenido/error del último health check. last_agt: Contenido/error del último agent check. qtime: Tiempo medio de cola (ms) sobre las últimas 1024 peticiones. ctime: Tiempo medio de conexión (ms) sobre las últimas 1024 peticiones. rtime: Tiempo medioescritura de respuesta (ms)gauge).
Waiting	generic_data	Conexiones ttime:keep-alive Tiempo medio total de sesióninactivas (ms) sobre las últimas 1024 peticiones. agent_status: Estado del último agent check. agent_code: Código numérico reportado por el agent. agent_duration: Tiempo en ms del último agent check. check_desc: Descripción legible de check_status. agent_desc: Descripción legible de agent_status. check_rise: Parámetro rise del servidor para los checks. check_fall: Parámetro fall del servidor para los checks. check_health: Valor del health check del servidor. agent_rise: Parámetro rise del agent. agent_fall: Parámetro fall del agent. agent_health: Parámetro health del agent. addr: Dirección:puerto o socket unix. cookie: Valor de cookie del servidor o nombre de cookie del backend. mode: Modo del proxy (tcp, http, health, unknown)gauge). algo:Un Algoritmovalor dealto balanceo.es conn_rate:normal Conexionescon durantekeep-alive elhabilitado.

conn_rate_max:

Marcadores Mayor conn_rate conocido. conn_tot: Número acumulado de conexiones. intercepted: Peticiones interceptadas acumuladas. dcon: Peticiones denegadas por reglas tcp-request connection. dses: Peticiones denegadas por reglas tcp-request session. 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: statusnginx:metric_status:<url_saneada> se
traduce
• 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 un valor numérico según el siguiente mapeo: 5=UP, 4=OPEN, 3=NOLB, 2=MAINT, 1=STOP/STOPPING, 0=DOWN, lo que permite configurar alertas en base a umbralesnivel de warning (2-4) y critical (0-2).dominio.