Proxy

Resumen

Zabbix proxy es un proceso que puede recopilar datos de monitorización de uno o más dispositivos monitorizados y enviar la información al server de Zabbix, trabajando esencialmente en nombre del server. Todos los datos recopilados se almacenan temporalmente de forma local y luego se transfieren al server de Zabbix al que pertenece el proxy.

El despliegue de un proxy es opcional, pero puede ser muy beneficioso para distribuir la carga de un único server de Zabbix. Si solo los proxy recopilan datos, el procesamiento en el server requiere menos CPU y E/S de disco.

Un Zabbix proxy es la solución ideal para la monitorización centralizada de ubicaciones remotas, sucursales y redes sin administradores locales.

Zabbix proxy requiere una base de datos independiente.

Tenga en cuenta que las bases de datos compatibles con Zabbix proxy son SQLite, MySQL y PostgreSQL.

Véase también: Using proxies in a distributed environment

Ejecutando proxy

Si se instala como paquete

El proxy de Zabbix se ejecuta como un proceso demonio. El proxy puede iniciarse ejecutando:

systemctl start zabbix-proxy

Esto funcionará en la mayoría de los sistemas GNU/Linux. En otros sistemas puede que necesite ejecutar:

/etc/init.d/zabbix-proxy start

De manera similar, para detener/reiniciar/ver el estado del proxy de Zabbix, utilice los siguientes comandos:

systemctl stop zabbix-proxy
systemctl restart zabbix-proxy
systemctl status zabbix-proxy
Iniciar manualmente

Si lo anterior no funciona, debe iniciarlo manualmente. Busque la ruta del binario zabbix_proxy y ejecute:

zabbix_proxy

Puede usar los siguientes parámetros de línea de comandos con Zabbix proxy:

-c --config <file>              Ruta al archivo de configuración
-f --foreground                 Ejecutar Zabbix proxy en primer plano
-R --runtime-control <option>   Realizar funciones administrativas
-T --test-config                Validar el archivo de configuración y salir
-h --help                       Mostrar esta ayuda
-V --version                    Mostrar el número de versión

Ejemplos de ejecución de Zabbix proxy con parámetros de línea de comandos:

zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf
zabbix_proxy --help
zabbix_proxy -V
Control en tiempo de ejecución

Opciones de control en tiempo de ejecución:

Option Description Target
config_cache_reload Recargar la caché de configuración. Se ignora si la caché se está cargando actualmente.
El proxy activo de Zabbix se conectará al server de Zabbix y solicitará los datos de configuración.
El proxy pasivo de Zabbix solicitará los datos de configuración al server de Zabbix la próxima vez que el server se conecte al proxy.
history_cache_clear=target Vaciar la caché de historial del item especificado por su ID.
Afecta a todos los valores del item, excepto el primero y el último.		 target - ID del item.
diaginfo[=<section>] Recopilar información de diagnóstico en el archivo de registro del proxy. historycache - estadísticas de la caché de historial;
preprocessing - estadísticas del gestor de preprocesamiento;
locks - lista de mutexes (está vacía en sistemas BSD).
snmp_cache_reload Recargar la caché SNMP: limpiar las propiedades del motor SNMP (engine time, engine boots, engine id, credentials) para todos los hosts. Úselo para forzar una limpieza global de la caché al solucionar problemas de SNMP.
housekeeper_execute Iniciar el procedimiento de housekeeping. Se ignora si el procedimiento de housekeeping está actualmente en curso.
log_level_increase[=<target>] Aumentar el nivel de registro; afecta a todos los procesos si no se especifica target.
No es compatible con sistemas BSD.		 process type - todos los procesos del tipo especificado (por ejemplo, poller).
Consulte todos los tipos de procesos del proxy.
process type,N - tipo de proceso y número (por ejemplo, poller,3)
pid - identificador de proceso (1 a 65535). Para valores mayores, especifique target como 'process type,N'.
log_level_decrease[=<target>] Disminuir el nivel de registro; afecta a todos los procesos si no se especifica target.
No es compatible con sistemas BSD.
prof_enable[=<target>] Habilitar el perfilado.
Afecta a todos los procesos si no se especifica target.
El perfilado habilitado proporciona detalles de todos los rwlocks/mutexes por nombre de función.		 process type - todos los procesos del tipo especificado (por ejemplo, history syncer).
Consulte todos los tipos de procesos del proxy.
process type,N - tipo de proceso y número (por ejemplo, history syncer,1).
pid - identificador de proceso (1 a 65535). Para valores mayores, especifique target como 'process type,N'.
scope - rwlock, mutex, processing se pueden usar con el tipo de proceso y número (por ejemplo, history syncer,1,processing) o con todos los procesos de un tipo (por ejemplo, history syncer,rwlock).
prof_disable[=<target>] Deshabilitar el perfilado.
Afecta a todos los procesos si no se especifica target.		 process type - todos los procesos del tipo especificado (por ejemplo, history syncer).
Consulte todos los tipos de procesos del proxy.
process type,N - tipo de proceso y número (por ejemplo, history syncer,1).
pid - identificador de proceso (1 a 65535). Para valores mayores, especifique target como 'process type,N'.

Ejemplo de uso del control en tiempo de ejecución para recargar la caché de configuración del proxy:

zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R config_cache_reload

Ejemplo de uso del control en tiempo de ejecución para vaciar la caché de historial de un item:

zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R history_cache_clear=42243

Ejemplos de uso del control en tiempo de ejecución para recopilar información de diagnóstico:

# Recopilar toda la información de diagnóstico disponible en el archivo de registro del proxy:
zabbix_proxy -R diaginfo

# Recopilar estadísticas de la caché de historial en el archivo de registro del proxy:
zabbix_proxy -R diaginfo=historycache

Ejemplo de uso del control en tiempo de ejecución para recargar la caché SNMP:

zabbix_proxy -R snmp_cache_reload

Cuando una interfaz SNMPv3 se actualiza mediante la interfaz web de Zabbix, Zabbix recargará automáticamente las nuevas credenciales SNMPv3 para esa interfaz en la mayoría de los casos; use -R snmp_cache_reload solo si la sondeo sigue fallando después de cambiar las credenciales (por ejemplo, debido a inconsistencias de engineBoots/engineID o a dispositivos no conformes con RFC), o cuando necesite forzar una limpieza global de la caché SNMP para tareas de diagnóstico.

Ejemplo de uso del control en tiempo de ejecución para activar la ejecución de housekeeper:

zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R housekeeper_execute

Ejemplos de uso del control en tiempo de ejecución para cambiar el nivel de registro:

# Aumentar el nivel de registro de todos los procesos:
zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R log_level_increase

# Aumentar el nivel de registro del segundo proceso poller:
zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R log_level_increase=poller,2

# Aumentar el nivel de registro del proceso con PID 1234:
zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R log_level_increase=1234

# Disminuir el nivel de registro de todos los procesos http poller:
zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R log_level_decrease="http poller"
Usuario del proceso

Zabbix proxy está diseñado para ejecutarse como un usuario que no sea root. Se ejecutará como cualquier usuario que no sea root con el que se inicie. Por lo tanto, puede ejecutar proxy como cualquier usuario que no sea root sin ningún problema.

Si intenta ejecutarlo como 'root', cambiará a un usuario 'zabbix' codificado de forma fija, que debe estar presente en su sistema. Solo puede ejecutar proxy como 'root' si modifica el parámetro AllowRoot en el archivo de configuración de proxy en consecuencia.

Archivo de configuración

Consulte las opciones del archivo de configuración para obtener más detalles sobre la configuración de zabbix_proxy.

Tipos de procesos y hilos del proxy

  • agent poller - proceso de sondeo asíncrono para comprobaciones pasivas con un hilo de trabajo;
  • availability manager - proceso para actualizaciones de disponibilidad del host;
  • browser poller - sondeador para comprobaciones de items de navegador;
  • configuration syncer - proceso para gestionar la caché en memoria de los datos de configuración;
  • data sender - remitente de datos del proxy;
  • discovery manager - proceso gestor para el descubrimiento de dispositivos;
  • discovery worker - proceso para gestionar tareas de descubrimiento procedentes del discovery manager;
  • history syncer - escritor de la base de datos de historial;
  • housekeeper - proceso para eliminar el historial obsoleto de items;
  • http agent poller - proceso de sondeo asíncrono para comprobaciones HTTP con un hilo de trabajo;
  • http poller - sondeador de monitorización web;
  • icmp pinger - sondeador para comprobaciones icmpping;
  • internal poller - sondeador para comprobaciones internas;
  • ipmi manager - gestor del sondeador IPMI;
  • ipmi poller - sondeador para comprobaciones IPMI;
  • java poller - sondeador para comprobaciones Java;
  • odbc poller - sondeador para comprobaciones ODBC;
  • poller - sondeador normal para comprobaciones pasivas;
  • preprocessing manager - gestor de tareas de preprocesamiento con hilos de trabajo de preprocesamiento;
  • preprocessing worker - hilo para el preprocesamiento de datos;
  • self-monitoring - proceso para recopilar estadísticas internas del server;
  • snmp poller - proceso de sondeo asíncrono para comprobaciones SNMP con un hilo de trabajo (walk[OID] y get[OID] items únicamente);
  • snmp trapper - trapper para traps SNMP;
  • task manager - proceso para la ejecución remota de tareas solicitadas por otros componentes (por ejemplo, cerrar un problema, reconocer un problema, comprobar ahora el valor de un item, funcionalidad de comando remoto);
  • trapper - trapper para comprobaciones activas, traps y comunicación del proxy;
  • unreachable poller - sondeador para dispositivos inalcanzables;
  • vmware collector - recopilador de datos de VMware responsable de la obtención de datos de los servicios de VMware.

El archivo de registro del proxy puede utilizarse para observar estos tipos de procesos.

El archivo de registro del proxy se crea con permisos de lectura y escritura solo para el propietario del archivo. Además, el archivo es legible por el grupo propietario. Se deniegan todos los demás permisos.

Se pueden supervisar varios tipos de procesos del proxy de Zabbix mediante el internal item zabbix[process,<type>,<mode>,<state>].

Estadísticas de transacciones del sincronizador de historial

El título del proceso del sincronizador de historial muestra estadísticas detalladas sobre las transacciones del sincronizador de historial.

205276 ?        S      0:00  zabbix_proxy: history syncer #1 [processed 1 values in 0.001179 (0.001167,0.000000) sec, idle 1 sec]
205277 ?        S      0:00  zabbix_proxy: history syncer #2 [processed 0 values in 0.000022 (0.000000,0.000000) sec, idle 1 sec]

Los tiempos, en processed...in N (<timings>) sec, son:

  • Tiempo dedicado a escribir los valores de item en la base de datos.
  • Tiempo dedicado a actualizar los datos del item (estado, errores).
Procedimiento de housekeeping

El proxy de Zabbix tiene el proceso housekeeper que elimina el historial y las tendencias obsoletos de los item. Se ejecuta en ciclos, con una frecuencia determinada por HousekeepingFrequency, y el límite de eliminación por ciclo determinado por ProxyLocalBuffer y ProxyOfflineBuffer. A diferencia del procedimiento de housekeeping del server de Zabbix, el proceso housekeeper del proxy no usa la tabla housekeeper; elimina todos los datos obsoletos una vez por cada ciclo de housekeeping.

Plataformas compatibles

Zabbix proxy se ejecuta en la misma lista de plataformas compatibles que Zabbix server.

Buffer de memoria

El buffer de memoria permite almacenar nuevos datos (valores de item, descubrimiento de red, autoregistro de host) en el buffer y cargarlos en el server de Zabbix sin acceder a la base de datos. El buffer de memoria se ha introducido para el proxy en Zabbix 7.0.

En instalaciones anteriores a Zabbix 7.0, los datos recopilados se almacenaban en la base de datos antes de cargarlos en el server de Zabbix. En estas instalaciones, este sigue siendo el comportamiento predeterminado después de actualizar a Zabbix 7.0.

Para un rendimiento optimizado, se recomienda configurar el uso del buffer de memoria en el proxy. Esto es posible modificando el valor de ProxyBufferMode de disk (valor predeterminado codificado para instalaciones existentes) a hybrid (recomendado) o memory. También es necesario establecer el tamaño del buffer de memoria (parámetro ProxyMemoryBufferSize).

En el modo híbrido, el buffer está protegido contra la pérdida de datos vaciando los datos no enviados a la base de datos si el proxy se detiene, el buffer se llena o los datos son demasiado antiguos. Cuando todos los valores se han vaciado en la base de datos, el proxy vuelve a usar el buffer de memoria.

En el modo de memoria, se utilizará el buffer de memoria; sin embargo, no hay protección contra la pérdida de datos. Si el proxy se detiene o la memoria se sobrecarga, los datos no enviados se descartarán.

El modo híbrido (ProxyBufferMode=hybrid) se aplica a todas las instalaciones nuevas desde Zabbix 7.0.

Parámetros adicionales como ProxyMemoryBufferSize y ProxyMemoryBufferAge definen, respectivamente, el tamaño del buffer de memoria y la antigüedad máxima de los datos en el buffer.

Tenga en cuenta que, con una configuración en conflicto, el proxy mostrará un error y no podrá iniciarse, por ejemplo, si:

  • ProxyBufferMode está establecido en hybrid o memory y ProxyMemoryBufferSize es 0.
  • ProxyBufferMode está establecido en hybrid o memory y ProxyLocalBuffer no es 0.

Configuración regional

Tenga en cuenta que el proxy requiere una configuración regional UTF-8 para que algunos items textuales puedan interpretarse correctamente. La mayoría de los sistemas modernos tipo Unix tienen una configuración regional UTF-8 como predeterminada; sin embargo, hay algunos sistemas en los que puede ser necesario establecerla específicamente.

Cálculo de colas durante el mantenimiento

El proxy de Zabbix no tiene conocimiento de los periodos de mantenimiento; consulte Calculation of queues during maintenance para obtener más detalles.