Monitorizacion con Zabbix: Docker + Agentes Ubuntu Server y Windows 11

1. Introduccion

Esta guia monta un entorno de monitorizacion con Zabbix en el que el servidor (server + frontend + base de datos) corre en Docker, mientras que los tres equipos a monitorizar — el propio host Docker, un Ubuntu Server y un Windows 11 — llevan el agente Zabbix instalado de forma nativa, tal y como se haria en un entorno real. No todo va dentro de contenedores: el objetivo es replicar el patron mas habitual en produccion, donde el servidor de monitorizacion es una pieza centralizada y los agentes viven en cada endpoint, incluido el propio servidor que aloja Zabbix.

2. Variables de esta guia

Todos los bloques de configuracion usan los siguientes marcadores en MAYUSCULAS. Sustituyelos por los valores reales del entorno donde se aplique esta guia.

3. Arquitectura y flujo

Zabbix soporta dos formas de recoger datos, y no son intercambiables sin mas: cambia quien inicia la conexion. Esta guia usa checks activos como modelo principal (es el que se sigue en el resto de los pasos), porque es el habitual en este canal: el firewall solo se abre en el servidor, nunca en el endpoint.

[HOST DOCKER]      [UBUNTU SERVER]      [WINDOWS 11]
  zabbix-agent2      zabbix-agent2        Zabbix Agent 2
  sin puertos        sin puertos          sin puertos
  en escucha         en escucha           en escucha
        |                  |                    |
        |     los AGENTES se conectan al server  |
        |     (saliente, sin abrir nada aqui)    |
        +------------------+--------------------+
                           |
                           v
              [ZABBIX SERVER - Docker]   IP_HOST_DOCKER
                puerto 10051 (unico puerto que hay que abrir)
                           |
                           v
              [ZABBIX DB - MySQL, Docker]
                           |
                           v
              [ZABBIX WEB - Nginx, Docker]
                puerto 8080 -> frontend

4. Requisitos

• Un host Linux con Docker Engine y el plugin Docker Compose (docker compose, sin guion) ya instalados. Este mismo host tambien va a llevar un agente Zabbix nativo, como un endpoint mas.
• El Ubuntu Server a monitorizar, con acceso sudo.
• El equipo Windows 11 a monitorizar, con acceso administrador (PowerShell como administrador).
• Conectividad de red: con el modelo de checks activos que sigue esta guia, basta con que Ubuntu Server y Windows 11 puedan alcanzar el puerto 10051 del host Docker (conexion saliente desde cada agente); el propio host Docker habla consigo mismo por 127.0.0.1, sin salir a la red.

5. Levantar el stack de Zabbix con Docker

Seguimos la misma organizacion de siempre: cada stack vive en su propia carpeta dentro de /docker, y las contraseñas van en un .env aparte, nunca escritas dentro del docker-compose.yml.

sudo mkdir -p /docker/zabbix && cd /docker/zabbix
sudo nano .env

Contenido del .env. Al ser una maquina virtual de pruebas para la clase, dejamos estas contraseñas tal cual (en un entorno real, cambialas):

MYSQL_DATABASE=zabbix
MYSQL_USER=zabbix
MYSQL_PASSWORD=zabbix_pwd
MYSQL_ROOT_PASSWORD=zabbix_root_pwd

Ahora el archivo del stack, en la misma carpeta:

sudo nano docker-compose.yml

services:
  zabbix-db:
    image: mysql:8.0
    container_name: zabbix-mysql
    command:
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_bin
      - --log-bin-trust-function-creators=1
    environment:
      MYSQL_DATABASE: ${MYSQL_DATABASE}
      MYSQL_USER: ${MYSQL_USER}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
    volumes:
      - zabbix-db-data:/var/lib/mysql
    healthcheck:
      test: ["CMD-SHELL", "mysqladmin ping -h 127.0.0.1 -u root -p\"$$MYSQL_ROOT_PASSWORD\" --silent"]
      interval: 5s
      timeout: 5s
      retries: 20
      start_period: 40s
    restart: unless-stopped

  zabbix-server:
    image: zabbix/zabbix-server-mysql:alpine-7.0-latest
    container_name: zabbix-server
    environment:
      DB_SERVER_HOST: zabbix-db
      MYSQL_DATABASE: ${MYSQL_DATABASE}
      MYSQL_USER: ${MYSQL_USER}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
    ports:
      - "10051:10051"
    depends_on:
      zabbix-db:
        condition: service_healthy
    restart: unless-stopped

  zabbix-web:
    image: zabbix/zabbix-web-nginx-mysql:alpine-7.0-latest
    container_name: zabbix-web
    environment:
      DB_SERVER_HOST: zabbix-db
      MYSQL_DATABASE: ${MYSQL_DATABASE}
      MYSQL_USER: ${MYSQL_USER}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
      ZBX_SERVER_HOST: zabbix-server
      PHP_TZ: Europe/Madrid
    ports:
      - "8080:8080"
    depends_on:
      zabbix-db:
        condition: service_healthy
      zabbix-server:
        condition: service_started
    restart: unless-stopped

volumes:
  zabbix-db-data:

Levanta el stack desde /docker/zabbix:

cd /docker/zabbix
docker compose up -d
watch docker compose ps

6. Primer acceso al frontend y verificacion del stack

Gracias al healthcheck del paso anterior, zabbix-server no arranca hasta que zabbix-mysql esta realmente listo. Comprueba el orden con:

docker compose ps

zabbix-mysql debe mostrar (healthy) en la columna STATUS antes de que zabbix-server pase a Up. Ahora si, sigue el log del servidor:

docker logs -f zabbix-server

Busca una linea similar a Starting Zabbix Server. Zabbix 7.0.x (revision ...) seguida de server #0 started [main process], sin ningun error de "users" table is empty por el camino. Sal con Ctrl+C y entra en el frontend:

http://IP_HOST_DOCKER:8080

Credenciales por defecto en una instalacion nueva:

Usuario: Admin
Contraseña: zabbix

7. Instalar el agente en Ubuntu Server

En el Ubuntu Server a monitorizar (no en el host Docker), añade el repositorio oficial de Zabbix. Ejemplo para Ubuntu 26.04 (Resolute) con Zabbix 7.0 — comprueba el nombre exacto del .deb en zabbix.com/download si tu version difiere:

wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest_7.0+ubuntu26.04_all.deb
sudo dpkg -i zabbix-release_latest_7.0+ubuntu26.04_all.deb
sudo apt update
sudo apt install zabbix-agent2 -y

Edita la configuracion del agente:

sudo nano /etc/zabbix/zabbix_agent2.conf

Busca y ajusta estas tres lineas (quita el # si estan comentadas):

Server=IP_HOST_DOCKER
ServerActive=IP_HOST_DOCKER
Hostname=HOSTNAME_UBUNTU

Reinicia el servicio para aplicar el cambio:

sudo systemctl restart zabbix-agent2
sudo systemctl enable zabbix-agent2
sudo systemctl status zabbix-agent2

Confirma que el proceso esta activo y que consigue conectar de salida al server:

systemctl is-active zabbix-agent2
nc -zv IP_HOST_DOCKER 10051
sudo tail -f /var/log/zabbix/zabbix_agent2.log

8. Añadir el host de Ubuntu Server en el frontend

En el frontend: Data collection → Hosts → Create host.

• Host name: HOSTNAME_UBUNTU (identico al Hostname del paso 7)
• Host groups: crea o selecciona un grupo, por ejemplo Linux servers
• Interfaces: con checks activos no es obligatorio añadir una interfaz Agent; puedes dejarlo sin interfaces
• Templates: Linux by Zabbix agent active

9. Instalar el agente en el propio host Docker

Antes de pasar a los otros dos equipos, aprovechamos para monitorizar tambien la maquina que aloja el stack de Zabbix. Desde el punto de vista del agente es un Ubuntu como cualquier otro; la unica diferencia es que el server esta en la misma maquina, no al otro lado de la red.

wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest_7.0+ubuntu26.04_all.deb
sudo dpkg -i zabbix-release_latest_7.0+ubuntu26.04_all.deb
sudo apt update
sudo apt install zabbix-agent2 -y

Edita la configuracion del agente:

sudo nano /etc/zabbix/zabbix_agent2.conf

Busca y ajusta estas tres lineas. Ojo: aqui Server y ServerActive apuntan a 127.0.0.1, no a la IP de red — agente y server viven en la misma maquina, no hace falta salir por la tarjeta de red para hablar con uno mismo:

Server=127.0.0.1
ServerActive=127.0.0.1
Hostname=HOSTNAME_DOCKER

Reinicia el servicio y comprueba que arranco:

sudo systemctl restart zabbix-agent2
sudo systemctl enable zabbix-agent2
systemctl is-active zabbix-agent2

Y que consigue conectar de salida al server (que en este caso tambien es 127.0.0.1, en el puerto donde docker-compose.yml publica zabbix-server):

nc -zv 127.0.0.1 10051
sudo tail -f /var/log/zabbix/zabbix_agent2.log

10. Añadir el host del servidor Docker en el frontend

Zabbix trae de fabrica un host de demostracion llamado exactamente Zabbix server, pensado justo para este caso: monitorizar la propia instalacion con un agente local. En vez de crear un host nuevo, lo aprovechamos — pero trae dos cosas mal configuradas de fabrica para un montaje con Docker, y hay que corregirlas.

• Ve a Data collection → Hosts → Zabbix server
• Pestaña Host: en Interfaces hay una interfaz Agent apuntando a 127.0.0.1:10050. Quitala (Remove). Con checks activos no hace falta, y ademas es incorrecta: ese 127.0.0.1 es el del contenedor zabbix-server, no el de la maquina fisica — son namespaces de red distintos, nunca van a poder hablarse por ahi.
• Pestaña Templates: quita (Unlink) la plantilla Linux by Zabbix agent (pasiva) y añade Linux by Zabbix agent active en su lugar. Deja Zabbix server health tal cual, esa usa checks internos y no depende de ningun agente.
• Host name: debe quedar identico al Hostname que pusiste en el agente (paso 9). Si prefieres otro nombre, cambia uno de los dos lados para que coincidan.

Host name: HOSTNAME_DOCKER
Templates: Zabbix server health + Linux by Zabbix agent active
Interfaces: ninguna (no hace falta con checks activos)

11. Instalar el agente en Windows 11

Descarga el instalador MSI de Zabbix Agent 2, version 7.0.x (misma rama LTS que el server), desde zabbix.com/download_agents. Puedes descargarlo directamente por PowerShell (revisa en la pagina de descargas cual es el numero de patch actual antes de lanzarlo):

$msiUrl = "https://cdn.zabbix.com/zabbix/binaries/stable/7.0/7.0.19/zabbix_agent2-7.0.19-windows-amd64-openssl.msi"
Invoke-WebRequest -Uri $msiUrl -OutFile "C:\Users\$env:USERNAME\Downloads\zabbix_agent2.msi"

Instala en modo silencioso desde PowerShell como administrador, pasando ya la configuracion:

msiexec /i "C:\Users\$env:USERNAME\Downloads\zabbix_agent2.msi" `
  SERVER=IP_HOST_DOCKER `
  SERVERACTIVE=IP_HOST_DOCKER `
  HOSTNAME=HOSTNAME_WINDOWS `
  ENABLEPATH=1 `
  SKIP=fw `
  /qn /norestart /l*v C:\Users\$env:USERNAME\Downloads\zabbix_install.log

Comprueba que el servicio se registro y esta en marcha:

Get-Service -Name "Zabbix Agent 2"

Comprueba que llega al puerto del server (checks activos):

Test-NetConnection -ComputerName IP_HOST_DOCKER -Port 10051

Y sigue el log del agente:

Get-Content "C:\Program Files\Zabbix Agent 2\zabbix_agent2.log" -Tail 50 -Wait

12. Añadir el host de Windows 11 en el frontend

Igual que con Ubuntu Server: Data collection → Hosts → Create host.

• Host name: HOSTNAME_WINDOWS (identico al HOSTNAME del paso 11)
• Host groups: crea o selecciona un grupo, por ejemplo Windows servers
• Interfaces: igual que en Linux, no hace falta interfaz Agent para checks activos
• Templates: Windows by Zabbix agent active

13. Verificar que llegan datos

Ve a Monitoring → Latest data, filtra por cada uno de los tres hosts (host Docker, Ubuntu Server y Windows 11) y comprueba que aparecen metricas con valores y marca de tiempo reciente: uso de CPU, memoria disponible, espacio en disco, etc. Esto lo trae ya la plantilla que asignaste en cada alta, sin necesidad de crear items manualmente.

Buen cierre para el video: abre una grafica (icono de grafica junto a cualquier item, por ejemplo CPU utilization) para mostrar visualmente que los datos ya fluyen en el tiempo.

14. Tabla de puertos y componentes

15. Errores comunes y como resolverlos

16. Notas de ampliacion

El montaje de esta guia cubre lo minimo necesario para tener tres endpoints reales monitorizados desde un server en Docker. Para un entorno mas completo se puede ampliar con:

• Cifrado con PSK (TLS) entre agente y server, en lugar de dejar la comunicacion en texto plano — especialmente recomendable si los agentes viven fuera de una red de confianza.
• Zabbix Proxy si en el futuro se añaden agentes en otra ubicacion o red separada, para no exponer el server directamente.
• Alertas por Telegram o email (Administration → Media types y Alerta → Actions), para que un umbral de CPU o disco lleno notifique de forma inmediata.
• Auto-discovery de red para que Zabbix detecte solo nuevos hosts en un rango de IPs, en vez de darlos de alta uno a uno.
• Triggers y templates propios cuando las plantillas nativas de Linux/Windows no cubran una metrica especifica del entorno.