Monitorización proactiva en VPS: Beszel y Uptime Kuma v2

Por qué la monitorización proactiva, y por qué las herramientas clásicas no son suficientes

Lo que esta pila aporta concretamente a una agencia

• Vista unificada de todos los servidores de tus clientes en una sola interfaz Beszel, sin multiplicar los accesos SSH.
• Alertas de métricas (CPU, RAM, disco, red) con umbrales configurables por host.
• Verificaciones de disponibilidad HTTP(s), TCP, DNS y certificados SSL vía Uptime Kuma v2 — cada 60 segundos por defecto.
• Notificaciones por Telegram o SMTP operativas en la primera hora, sin suscripción a servicios externos.
• Detección de saturación de disco o fuga de memoria antes de que bloquee un servicio de aplicación.
• Páginas de estado públicas de Uptime Kuma compartibles con los clientes finales.
• Consumo total de la pila inferior a 150 MB de RAM en el VPS de supervisión.
• Despliegue reproducible mediante Docker Compose, versionable y redesplegable en minutos.

Requisitos de recursos

Despliegue completo: hub Beszel, agentes, Uptime Kuma v2 y alertas

1. 01

   Crear la estructura Docker Compose en el VPS de supervisión

   Conéctate al VPS dedicado a la supervisión. Crea un directorio de trabajo y el archivo Compose:

   mkdir -p /opt/monitoring && cd /opt/monitoring

   Crea docker-compose.yml con los dos servicios:

   services:
     beszel:
       image: henrygd/beszel:latest
       restart: unless-stopped
       volumes:
         - ./beszel_data:/beszel_data
       ports:
         - "8090:8090"
       environment:
         - DATA_DIR=/beszel_data
   
     uptime-kuma:
       image: louislam/uptime-kuma:2
       restart: unless-stopped
       volumes:
         - ./uptime-kuma-data:/app/data
       ports:
         - "3001:3001"
       healthcheck:
         test: ["CMD", "node", "extra/healthcheck"]
         interval: 30s
         timeout: 10s
         retries: 3

   Observa el bloque healthcheck en Uptime Kuma: es indispensable para evitar el problema del crash-loop (ver sección Trampas).

2. 02

   Arrancar la pila y crear las cuentas de administrador

   Lanza los dos contenedores:

   docker compose up -d

   Verifica que ambos contenedores estén en estado healthy o running:

   docker compose ps

   Accede a Beszel en http://<ip-vps>:8090 y crea la cuenta de administrador en el primer acceso. Haz lo mismo con Uptime Kuma en http://<ip-vps>:3001. Ambas interfaces deben colocarse después detrás de un proxy inverso con SSL para no exponerlas en HTTP plano.

3. 03

   Desplegar el agente Beszel en cada VPS a supervisar

   En cada VPS cliente a supervisar, copia la clave pública generada en la interfaz de Beszel (Configuración → Clave SSH) y ejecuta:

   curl -sL https://raw.githubusercontent.com/henrygd/beszel/main/supplemental/scripts/install-agent.sh | bash -s -- -p 45876 -k "<tu-clave-publica>"

   Alternativamente, usa Docker en el host supervisado:

   services:
     beszel-agent:
       image: henrygd/beszel-agent:latest
       restart: unless-stopped
       network_mode: host
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock:ro
       environment:
         - KEY=<tu-clave-publica>
         - PORT=45876

   En Beszel, añade cada host desde la interfaz (Sistemas → Añadir sistema) indicando su IP y el puerto del agente. La conexión la establece el hub hacia el agente: el host supervisado no necesita exponer ese puerto públicamente.

4. 04

   Configurar las alertas de métricas en Beszel

   En Beszel, abre el detalle de un sistema y ve a la pestaña Alertas. Configura umbrales en las métricas críticas:

   - Disco: alerta al 80% y crítica al 90% — cubre el caso PostgreSQL del escenario inicial.
   - RAM: alerta si el uso supera el 85% sostenido durante 5 minutos.
   - CPU: alerta si la carga supera el 90% durante más de 3 minutos.

   Beszel soporta Telegram, Discord, Slack, Gotify, Ntfy y webhooks genéricos. Para Telegram necesitas un token de bot (obtenido desde @BotFather) y el ID de tu chat o grupo.

5. 05

   Configurar los monitores Uptime Kuma v2 y las alertas SMTP o Telegram

   En Uptime Kuma, comienza configurando un canal de notificación (Configuración → Notificaciones). Dos opciones habituales:

   Telegram. Introduce el token del bot y el ID del chat. El mismo bot que para Beszel funciona — usa un solo bot para ambas herramientas y distingue con canales diferentes.

   SMTP. Introduce el servidor SMTP, el puerto (587 con STARTTLS), las credenciales y la dirección de destino. Usa una cuenta dedicada al envío de alertas.

   Crea después los monitores para cada servicio crítico: URL HTTP(s) para los sitios web, TCP para bases de datos y puertos de aplicación. Para el caso PostgreSQL, añade un monitor TCP en el puerto 5432 de cada VPS que aloje una instancia — si PostgreSQL se detiene, el puerto deja de responder y la alerta se dispara en segundos.

6. 06

   Poner todo detrás de un proxy inverso con SSL

   Añade un servicio nginx o Caddy al Compose para exponer Beszel y Uptime Kuma por HTTPS:

     caddy:
       image: caddy:alpine
       restart: unless-stopped
       ports:
         - "80:80"
         - "443:443"
       volumes:
         - ./Caddyfile:/etc/caddy/Caddyfile
         - caddy_data:/data

   Con un Caddyfile mínimo:

   monitoring.your-domain.com {
       reverse_proxy beszel:8090
   }
   
   status.your-domain.com {
       reverse_proxy uptime-kuma:3001
   }

   Caddy emite y renueva automáticamente los certificados Let's Encrypt. Elimina las secciones ports de beszel y uptime-kuma en el Compose en cuanto estén proxificados — no deben ser accesibles directamente.

7. 07

   Verificar el funcionamiento y configurar la retención

   Prueba todo deteniendo manualmente un servicio en un VPS de prueba (docker compose stop <servicio>) y verificando que la alerta de Telegram o SMTP llega en menos de dos minutos.

   Para Beszel, configura la retención de datos en Configuración → Retención: el valor por defecto es 7 días para datos de alta resolución y 30 días para agregados por hora. Ajusta según la capacidad de tu disco.

   Para Uptime Kuma, la retención se configura en Configuración → Avanzado → Limpieza automática. Conserva al menos 90 días para tener tendencias mensuales de uptime que presentar a los clientes.

Trampas a conocer antes de pasar a producción

Cobertura de alertas según la configuración de la pila

Desplace la tabla

Solución de problemas habituales

Para ir más lejos