9. Configuración detallada del Zabbix Agent

Comprender cómo se instala, activa y valida el agente como componente de recolección directa.

Introducción técnica

El Zabbix Agent es el sensor interno de un host.

Sin él, Zabbix no puede recolectar métricas de bajo nivel del sistema operativo: CPU, RAM, procesos, servicios, archivos, logs, etc.

Saber instalarlo, configurarlo y validarlo correctamente es crítico para tener monitoreo confiable.

Este bloque aborda toda la cadena de operación del agente, desde el archivo de configuración hasta la interacción con el Server o Proxy.

🧩 ¿Qué versiones existen?

| Tipo de agente     | Descripción principal                                                  | Uso recomendado                                                   |

| ------------------ | ---------------------------------------------------------------------- | ----------------------------------------------------------------- |

| zabbix_agentd | Agente clásico de Zabbix (ligero, probado)                             | Linux, Windows, hosts estándar                                    |

| zabbix_agent2 | Versión moderna, basada en plugins, mejor para logs, SNMP, nativo JSON | Nuevas instalaciones, sistemas con parsing o integración compleja |

Ambos usan el mismo puerto y principios generales, pero no son intercambiables.

Instalación típica (RHEL/CentOS/Fedora/Debian)


## RHEL / Rocky / CentOS

sudo dnf install zabbix-agent

## Debian / Ubuntu

sudo apt install zabbix-agent

Para zabbix-agent2, reemplazar el paquete por zabbix-agent2.

Archivo de configuración

Ruta principal:


/etc/zabbix/zabbix_agentd.conf # linux

C://Archivos de programa/zabbix agent 2 #windows

Los parámetros clave que el operador debe conocer:

| Parámetro                                   | Explicación operativa                                                                |

| ------------------------------------------- | ------------------------------------------------------------------------------------ |

| Server=                                   | IP/FQDN del Server (o Proxy) que hará polling (modo pasivo)                          |

| ServerActive=                             | IP/FQDN del Server (o Proxy) que recibirá datos activos                              |

| Hostname=                                 | Identificador único del host en el GUI de Zabbix. Debe coincidir EXACTAMENTE.        |

| ListenPort=10050                          | Puerto TCP por el que escucha en modo pasivo.                                        |

| Include=                                  | Ruta opcional a archivos de configuración adicionales (recomendado para modularidad) |

| LogFile=/var/log/zabbix/zabbix_agentd.log | Log local del agente, clave para diagnóstico                                         |

Todos los parámetros pueden ser validados con:


grep -v '^#' /etc/zabbix/zabbix_agentd.conf | grep -v '^$'

Reinicio del servicio (RHEL / Debian)


sudo systemctl restart zabbix-agent

sudo systemctl enable zabbix-agent

sudo systemctl status zabbix-agent

Validar que esté activo y habilitado al arranque.

Si no levanta, revisar:

  • Errores de sintaxis en .conf

  • Conflicto de puertos

  • Logs en /var/log/zabbix/zabbix_agentd.log

Validación operativa

1. ¿Está activo?

systemctl status zabbix-agent

Debe estar en estado active (running)

2. ¿Escucha en el puerto correcto?

ss -ltnp | grep 10050

Debe mostrar:


LISTEN  0  128  0.0.0.0:10050

Si no aparece, puede ser:

  • Error en ListenPort=

  • Firewall bloqueando el puerto

  • El agente no está corriendo

3. ¿Responde a consultas desde el Server?

Desde el Zabbix Server o Proxy:


zabbix_get -s <ip_del_host> -k system.uptime

Si responde un número (segundos de uptime), el agente está bien configurado en modo pasivo.

4. ¿Está reportando datos en modo activo?

Ver en GUI → Configuration → Hosts → Latest Data

Filtrar por ítems tipo Zabbix agent (active).

Si aparece “No data”, revisar:

  • ¿Hostname en conf coincide con el de la GUI?

  • ¿ServerActive= es correcto y resolvible?

  • ¿Logs muestran errores?


tail -f /var/log/zabbix/zabbix_agentd.log

Mensajes comunes:


active checks are not getting any data

cannot resolve 'zabbix-server.infra.local'

Errores comunes y su impacto

| Error                    | Causa raíz técnica                                 | Resultado en GUI / operación                   |

| ------------------------ | -------------------------------------------------- | ---------------------------------------------- |

| Hostname= incorrecto   | No coincide con el nombre registrado en Zabbix GUI | Datos activos son ignorados por el Server      |

| Server= mal puesto     | IP errónea, no accesible                           | El server no puede hacer polling (modo pasivo) |

| ServerActive= sin DNS  | No puede resolver el nombre del server/proxy       | Ítems activos no reportan                      |

| Puerto 10050 bloqueado   | Firewall o ACL local                               | zabbix_get falla, datos pasivos en gris      |

| ListenPort= modificado | Configurado en 10500 pero GUI espera 10050         | Server no puede contactar                      |

🧠 Reflexión operativa

*“Un agente configurado sin errores es invisible… pero cuando algo falla, la configuración es el primer lugar que hay que revisar.

Cada línea incorrecta puede causar silencio absoluto del host.”*

✅ Resultado esperado

  • El operador sabe instalar y activar correctamente un agente

  • Puede validar su funcionamiento en modo pasivo y activo

  • Diagnostica fallos rápidamente con zabbix_get, systemctl, ss y logs

  • Comprende que zabbix_agentd.conf es la fuente de verdad técnica de la recolección directa