4 Proxy

Descripción general

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

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

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

El proxy de Zabbix requiere una base de datos independiente.

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

Consulte también: Uso de proxies en un entorno distribuido

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 al binario zabbix_proxy y ejecute:

zabbix_proxy

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

-c --config <archivo>              ruta al archivo de configuración
-f --foreground                    ejecutar Zabbix proxy en primer plano
-R --runtime-control <opción>      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 de tiempo de ejecución

Opciones de control de 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 del server de Zabbix la próxima vez que el server se conecte al proxy.
history_cache_clear=target Borrar 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: borrar las propiedades del motor SNMP (tiempo del motor, reinicios del motor, ID del motor, credenciales) para todos los hosts. Úselo para forzar una limpieza global de la caché al solucionar problemas de SNMP.
housekeeper_execute Iniciar el procedimiento de limpieza. Se ignora si el procedimiento de limpieza está actualmente en curso.
log_level_increase[=<target>] Aumentar el nivel de registro; afecta a todos los procesos si no se especifica target.
No compatible con sistemas BSD.		 process type - Todos los procesos del tipo especificado (por ejemplo, poller)
Vea todos los tipos de procesos y threads 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 compatible con sistemas BSD.
prof_enable[=<target>] Habilitar profiling.
Afecta a todos los procesos si no se especifica target.
El profiling 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)
Vea todos los tipos de procesos y threads 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 pueden usarse con el tipo y número de proceso (por ejemplo, history syncer,1,processing) o con todos los procesos del tipo (por ejemplo, history syncer,rwlock)
prof_disable[=<target>] Deshabilitar profiling.
Afecta a todos los procesos si no se especifica target.		 process type - Todos los procesos del tipo especificado (por ejemplo, history syncer)
Vea todos los tipos de procesos y threads 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 de 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 de tiempo de ejecución para borrar 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 de 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 de tiempo de ejecución para recargar la caché SNMP:

zabbix_proxy -R snmp_cache_reload

Cuando una interfaz SNMPv3 se actualiza mediante la UI 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 recolección sigue fallando después de cambiar las credenciales (por ejemplo, debido a inconsistencias de engineBoots/engineID o dispositivos no RFC), o cuando necesite forzar una limpieza global de la caché SNMP para solucionar problemas.

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

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

Ejemplos de uso del control de 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"
Proceso de usuario

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

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

Archivo de configuración

Consulte las opciones del archivo de configuración para obtener 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 de host
  • browser poller - sondeador para comprobaciones de item 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 del discovery manager
  • history syncer - escritor de historial en la base de datos
  • housekeeper - proceso para eliminar el historial de item obsoleto
  • http agent poller - proceso de sondeo asíncrono para comprobaciones HTTP con un hilo de trabajo
  • http poller - sondeador para monitorización web
  • icmp pinger - sondeador para comprobaciones icmpping
  • internal poller - sondeador para comprobaciones internas
  • ipmi manager - gestor de sondeadores 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 servidor
  • snmp poller - proceso de sondeo asíncrono para comprobaciones SNMP con un hilo de trabajo (solo items walk[OID] y get[OID])
  • snmp trapper - receptor de traps SNMP
  • task manager - proceso para la ejecución remota de tareas solicitadas por otros componentes (por ejemplo, cerrar problema, reconocer problema, comprobar valor de item ahora, funcionalidad de comando remoto)
  • trapper - receptor para comprobaciones activas, traps, comunicación con proxy
  • unreachable poller - sondeador para dispositivos inalcanzables
  • vmware collector - recolector de datos de VMware responsable de recopilar datos de servicios VMware

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

El archivo de log 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. Todos los demás permisos están denegados.

Se pueden monitorizar varios tipos de procesos del proxy de Zabbix utilizando el item interno zabbix[process,<type>,<mode>,<state>].

Estadísticas de transacciones del history syncer

El título del proceso history syncer muestra estadísticas detalladas sobre las transacciones del history syncer.

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 valores de métricas en la base de datos;
  • Tiempo dedicado a actualizar datos de métricas (estado, errores).
Procedimiento de limpieza

El proxy de Zabbix tiene el proceso housekeeper que elimina el historial y las tendencias de los item obsoletos. 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 limpieza del server de Zabbix, el proceso housekeeper del proxy no utiliza la tabla housekeeper, sino que elimina todos los datos obsoletos una vez por cada ciclo de limpieza.

Plataformas compatibles

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

Búfer de memoria

El búfer de memoria permite almacenar datos nuevos (valores de item, descubrimiento de red, autorregistro de host) en el búfer y cargarlos al server de Zabbix sin acceder a la base de datos. El búfer de memoria se introdujo para el proxy en Zabbix 7.0.

En las instalaciones anteriores a Zabbix 7.0, los datos recopilados se almacenaban en la base de datos antes de cargarse al server de Zabbix. Para 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 búfer 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 búfer de memoria (parámetro ProxyMemoryBufferSize).

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

En modo memoria, se utilizará el búfer de memoria; sin embargo, no hay protección contra la pérdida de datos. Si el proxy se detiene o la memoria se llena en exceso, 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 el tamaño del búfer de memoria y la antigüedad máxima de los datos en el búfer, respectivamente.

Tenga en cuenta que, si la configuración entra 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 elementos de texto puedan interpretarse correctamente. La mayoría de los sistemas modernos similares a Unix tienen una configuración regional UTF-8 por defecto, sin embargo, hay algunos sistemas donde esto puede necesitar configurarse específicamente.

Cálculo de colas durante el mantenimiento

El proxy de Zabbix no es consciente de los periodos de mantenimiento; consulte Cálculo de colas durante el mantenimiento para más detalles.