1 Proxies
Resumen
Un Zabbix proxy puede recopilar datos de rendimiento y disponibilidad en nombre del Zabbix server. De este modo, un proxy puede asumir parte de la carga de recopilación de datos y descargar al Zabbix server.
Además, usar un proxy es la forma más sencilla de implementar una supervisión centralizada y distribuida, cuando todos los agents y proxies informan a un único Zabbix server y todos los datos se recopilan de forma centralizada.
Un Zabbix proxy se puede usar para:
- Supervisar ubicaciones remotas
- Supervisar ubicaciones con comunicaciones poco fiables
- Descargar al Zabbix server al supervisar miles de dispositivos
- Simplificar el mantenimiento de la supervisión distribuida

El proxy requiere solo una conexión TCP con el Zabbix server. De este modo, es más fácil atravesar un firewall, ya que solo necesita configurar una regla de firewall.
Zabbix proxy debe usar una base de datos independiente. Si se apunta a la base de datos del Zabbix server, la configuración se dañará.
Todos los datos recopilados por el proxy se almacenan localmente antes de enviarse al server. De este modo, no se pierde ningún dato debido a problemas de comunicación temporales con el server. Los parámetros ProxyLocalBuffer y ProxyOfflineBuffer en el archivo de configuración del proxy controlan durante cuánto tiempo se conservan los datos localmente.
Puede ocurrir que un proxy, que recibe los últimos cambios de configuración directamente desde la base de datos del Zabbix server, tenga una configuración más actualizada que el Zabbix server, cuya configuración puede no actualizarse tan rápido debido al valor de CacheUpdateFrequency. Como resultado, el proxy puede empezar a recopilar datos y enviarlos al Zabbix server, que ignora esos datos.
Zabbix proxy es un recopilador de datos. No calcula triggers, no procesa eventos ni envía alertas. Para obtener una visión general de las funciones del proxy, revise la siguiente tabla:
| Function | Supported by proxy | |
|---|---|---|
| Items | ||
| Zabbix agent checks | Yes | |
| Zabbix agent checks (active) | Yes 1 | |
| Simple checks | Yes | |
| Trapper items | Yes | |
| SNMP checks | Yes | |
| SNMP traps | Yes | |
| IPMI checks | Yes | |
| JMX checks | Yes | |
| Log file monitoring | Yes | |
| Internal checks | Yes | |
| SSH checks | Yes | |
| Telnet checks | Yes | |
| External checks | Yes | |
| Dependent items | Yes | |
| Script items | Yes | |
| Browser items | Yes | |
| Built-in web monitoring | Yes | |
| Item value preprocessing | Yes | |
| Network discovery | Yes | |
| Active agent autoregistration | Yes | |
| Low-level discovery | Yes 2 | |
| Remote commands | Yes | |
| Calculating triggers | No | |
| Processing events | No | |
| Event correlation | No | |
| Sending alerts | No | |
[1] Para asegurarse de que un agent solicite al proxy (y no al
server) las comprobaciones activas, el proxy debe estar incluido en el
parámetro ServerActive del archivo de configuración del agent.
[2] Para LLD, Zabbix proxy solo recopila y preprocesa
los datos y luego los envía al Zabbix server para su
procesamiento posterior.
Protección contra la sobrecarga
Si el server de Zabbix estuvo caído durante algún tiempo y los proxies recopilaron una gran cantidad de datos, y luego el server se inicia, puede sobrecargarse (el uso de la caché de historial se mantiene en 95-100% durante algún tiempo). Esta sobrecarga podría provocar una degradación del rendimiento, en la que las comprobaciones se procesan más lentamente de lo que deberían. Se implementó una protección frente a este escenario para evitar los problemas que surgen debido a la sobrecarga de la caché de historial.
Cuando la caché de historial del server de Zabbix está llena, el acceso de escritura a la caché de historial se limita, lo que detiene los procesos de recopilación de datos del server. El caso más común de sobrecarga de la caché de historial es después de un tiempo de inactividad del server, cuando los proxies están cargando los datos recopilados. Para evitar esto, se añadió la limitación de proxy (actualmente no se puede deshabilitar).
El server de Zabbix dejará de aceptar datos de los proxies cuando el uso de la caché de historial alcance el 80%. En su lugar, esos proxies se colocarán en una lista de limitación. Esto continuará hasta que el uso de la caché baje al 60%. Entonces el server comenzará a aceptar datos de los proxies uno por uno, según lo definido por la lista de limitación. Esto significa que el primer proxy que intentó cargar datos durante el período de limitación será atendido primero y, hasta que termine, el server no aceptará datos de otros proxies.
Este modo de limitación continuará hasta que el uso de la caché vuelva a alcanzar el 80%, baje al 20% o la lista de limitación quede vacía. En el primer caso, el server dejará de aceptar datos de proxy nuevamente. En los otros dos casos, el server comenzará a funcionar normalmente, aceptando datos de todos los proxies.
La información anterior se puede ilustrar en la siguiente tabla:
| Uso de escritura de la caché de historial |
Modo del server de Zabbix | Acción del server de Zabbix |
|---|---|---|
| Alcanza el 80% | Espera | Deja de aceptar datos de proxy, pero mantiene una lista de limitación (lista priorizada de proxies que se contactarán más adelante). |
| Baja al 60% | Limitado | Comienza a procesar la lista de limitación, pero sigue sin aceptar datos de proxy. |
| Baja al 20% | Normal | Descarta la lista de limitación y comienza a aceptar datos de proxy normalmente. |
Puede usar el item interno zabbix[wcache,history,pused] para correlacionar este comportamiento del server de Zabbix con una métrica.
Configuración
Una vez que haya instalado y configurado un proxy, es hora de configurarlo en el frontend de Zabbix.
Añadir proxies
Para configurar un proxy en Zabbix frontend:
- Vaya a: Administration → Proxies
- Haga clic en Create proxy

| Parameter | Description | |
|---|---|---|
| Proxy name | Introduzca el nombre del proxy. Debe ser el mismo nombre que en el parámetro Hostname del archivo de configuración del proxy. | |
| Proxy group | Seleccione un grupo de proxy para el balanceo de carga/alta disponibilidad del proxy. | |
| Address for active agents | Introduzca la dirección a la que deben conectarse los agentes activos o los remitentes monitorizados. Compatible solo con agentes Zabbix 7.0 o posteriores. Esta dirección se usa para conectarse tanto a proxies activos como pasivos. Este campo solo está disponible si se selecciona un grupo de proxy en el campo Proxy group. |
|
| Address | Dirección IP/nombre DNS al que conectarse. | |
| Port | Número de puerto TCP (10051 por defecto) al que conectarse. Se admiten macros de usuario. | |
| Proxy mode | Seleccione el modo de proxy. Active - el proxy se conectará al server de Zabbix y solicitará datos de configuración Passive - el server de Zabbix se conecta al proxy Tenga en cuenta que, sin comunicaciones cifradas, los datos de configuración del proxy (sensibles) pueden quedar disponibles para terceros que tengan acceso al puerto trapper del server de Zabbix cuando se usa un proxy activo. Esto es posible porque cualquiera puede hacerse pasar por un proxy activo y solicitar datos de configuración si no se realiza autenticación o si las direcciones del proxy no están limitadas en el campo Proxy address. |
|
| Proxy address | Si se especifica, las solicitudes del proxy activo solo se aceptan desde esta lista de direcciones IP separadas por comas, opcionalmente en notación CIDR, o nombres DNS del proxy activo de Zabbix. Este campo solo está disponible si se selecciona un proxy activo en el campo Proxy mode. No se admiten macros. |
|
| Interface | Introduzca los detalles de la interfaz para un proxy pasivo. Este campo solo está disponible si se selecciona un proxy pasivo en el campo Proxy mode. |
|
| Address | Dirección IP/nombre DNS del proxy pasivo. | |
| Port | Número de puerto TCP del proxy pasivo (10051 por defecto). Se admiten macros de usuario. | |
| Description | Introduzca la descripción del proxy. | |
La pestaña Encryption permite exigir conexiones cifradas con el proxy.
| Parameter | Description |
|---|---|
| Connections to proxy | Cómo se conecta el server al proxy pasivo: sin cifrado (predeterminado), usando PSK (clave precompartida) o certificado. |
| Connections from proxy | Seleccione qué tipo de conexiones se permiten desde el proxy activo. Se pueden seleccionar varios tipos de conexión al mismo tiempo (útil para pruebas y para cambiar a otro tipo de conexión). El valor predeterminado es "No encryption". |
| Issuer | Emisor permitido del certificado. Primero se valida el certificado con la CA (autoridad de certificación). Si es válido y está firmado por la CA, el campo Issuer puede usarse para restringir aún más la CA permitida. Este campo es opcional y está pensado para usarse si su instalación de Zabbix utiliza certificados de varias CAs. |
| Subject | Asunto permitido del certificado. Primero se valida el certificado con la CA. Si es válido y está firmado por la CA, el campo Subject puede usarse para permitir solo un valor de la cadena Subject. Si este campo está vacío, se acepta cualquier certificado válido firmado por la CA configurada. |
| PSK identity | Cadena de identidad de la clave precompartida. No coloque información sensible en la identidad PSK, ya que se transmite sin cifrar por la red para informar al receptor qué PSK usar. |
| PSK | Clave precompartida (cadena hexadecimal). Longitud máxima: 512 dígitos hexadecimales (PSK de 256 bytes) si Zabbix usa la biblioteca GnuTLS o OpenSSL, 64 dígitos hexadecimales (PSK de 32 bytes) si Zabbix usa la biblioteca mbed TLS (PolarSSL). Ejemplo: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 |
La pestaña Timeouts permite sobrescribir los timeouts globales para los tipos de item que lo admiten.

| Parameter | Description |
|---|---|
| Timeouts for item types | Seleccione la opción de timeout: Global - se usa el timeout global (mostrado en el campo Timeout atenuado para cada tipo de item); Override - se usa un timeout personalizado (configurado en el campo Timeout para cada tipo de item). Rango permitido: 1 - 600 s (predeterminado: heredado de los timeouts globales). Se admiten sufijos de tiempo, por ejemplo 30s, 1m, y macros de usuario. Al hacer clic en el enlace Global timeouts puede configurar los timeouts globales. Tenga en cuenta que el enlace Global timeouts solo es visible para usuarios de tipo Super admin con permisos para la sección de frontend Administration → General. Tipos de item admitidos: - Zabbix agent (comprobaciones pasivas y activas) - Simple check (excepto items icmpping*, vmware.*)- SNMP agent (solo para items SNMP walk[OID] y get[OID])- External check - Database monitor - HTTP agent - SSH agent - TELNET agent - Script - Browser Tenga en cuenta que los timeouts establecidos en Override prevalecerán sobre los globales, pero serán sobrescritos por los timeouts individuales de cada item si estos se configuran en la configuración del item. |
Si la versión principal del proxy no coincide con la versión principal del server,
se mostrará el icono
junto a Timeouts for item types, con el mensaje al pasar el cursor
"Timeouts disabled because the proxy and server versions do not match".
En tales casos, el proxy usará el parámetro Timeout del archivo de configuración del proxy.
El formulario de edición de un proxy existente tiene los siguientes botones adicionales:
- Refresh configuration - actualizar la configuración del proxy
- Clone - crear un nuevo proxy basado en las propiedades del proxy existente
- Delete - eliminar el proxy
Configuración de host
Puede especificar que un host individual debe ser monitorizado por un proxy o un grupo de proxy en el formulario de configuración de host, usando el campo Monitored by.

La actualización masiva de host es otra forma de especificar que los hosts deben ser monitorizados por un proxy o un grupo de proxy.