← volver

Uptime Kuma: monitoriza tus servicios y recibe avisos antes de que caigan

Por · · [Admin-Sistemas] · lectura estimada: ~4 min
$ índice

Tu web puede llevar horas caída y que te enteres por un usuario cabreado. Uptime Kuma es un monitor de disponibilidad open source que instalas en tu propio servidor: comprueba tus servicios cada minuto y te avisa por Telegram o correo en cuanto algo falla.

Qué vigila Uptime Kuma

Kuma no mide métricas internas como CPU o RAM: vigila desde fuera si un servicio responde. Sus tipos de monitor más útiles son HTTP(s), palabra clave en la respuesta, ping, puerto TCP, DNS y contenedor Docker. El monitor HTTP además avisa antes de que caduque el certificado TLS.

Si ya monitorizas métricas con Prometheus y Grafana, Uptime Kuma es el complemento perfecto: uno te dice cómo está el servidor por dentro y el otro te avisa cuando deja de responder por fuera.

Dónde instalarlo: mejor fuera de lo vigilado

La regla de oro es no monitorizar un servicio desde el mismo servidor que lo sirve: si esa máquina cae, el monitor cae con ella y nadie te avisa. Instálalo en un segundo VPS o en una Raspberry Pi; necesita muy poca memoria y guarda todo en una base SQLite dentro de /app/data.

Instalación con Docker Compose

Con Docker y el plugin Compose ya instalados, usa el fichero oficial del proyecto. Ojo con la etiqueta: latest está obsoleta y apunta siempre a la versión 1; para la rama 2.x usa la etiqueta 2.

mkdir -p /opt/uptime-kuma && cd /opt/uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d
docker compose logs -f --tail=50

El compose.yaml oficial ya publica el puerto ligado a localhost (127.0.0.1:3001:3001). No lo cambies a 3001:3001: Docker publica los puertos antes de que se evalúen las reglas de UFW, y expondrías el panel a todo internet. Abre http://localhost:3001 con un túnel SSH y crea la cuenta de administrador en el primer arranque:

ssh -L 3001:127.0.0.1:3001 usuario@tu-servidor

Comprueba que responde antes de seguir:

curl -I http://127.0.0.1:3001

Tus primeros monitores

En el panel, «Add New Monitor», empieza por lo crítico:

  • HTTP(s) para tu web y tu API, con la opción de palabra clave para detectar que la página responde pero con un error (por ejemplo, que contenga «Bienvenido» o el título de tu sitio).
  • Ping para el VPS y el router, cada 60 segundos.
  • Puerto TCP para servicios sin web: el 22 de SSH, el 25 de correo o el puerto de tu base de datos.
  • DNS contra tu dominio, para detectar que tu DNS deja de resolver antes de que lo note nadie.

Con uno o dos reintentos antes de declarar la caída evitas avisos por un simple paquete perdido, sin retrasar el aviso real más de un par de minutos.

Panel de Uptime Kuma con el estado de varios monitores

Avisos por Telegram (o correo)

Un monitor sin avisos es un adorno. En «Settings → Notifications → Telegram» necesitas el token del bot y el ID del chat: crea el bot con @BotFather, escríbele un mensaje y consulta tu ID con:

curl "https://api.telegram.org/bot<TOKEN>/getUpdates"

Pega ambos datos en Kuma, pulsa «Test» y recibirás un mensaje de prueba. Desde ahí, cada caída y cada recuperación llegan a tu móvil. Si prefieres correo, SMTP está en la misma lista, junto a webhooks y decenas de integraciones más.

Una página de estado pública

En «Status Pages» puedes publicar una página con el estado de tus servicios y el historial de disponibilidad de los últimos días: la misma idea que las páginas de estado de los grandes servicios, pero con tus datos y en tu dominio. Muestra solo los servicios que quieras; los monitores internos no tienen por qué ser públicos.

Detrás de nginx con HTTPS

Para usar Kuma desde fuera sin exponer el puerto 3001, pon nginx delante con un subdominio y certificado válido. El panel usa WebSockets, así que el proxy debe reenviar las cabeceras de actualización:

location / {
    proxy_pass http://127.0.0.1:3001;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
}

Si aún no tienes el certificado, sigue la guía de Certbot y Let’s Encrypt en nginx. Protege el panel con una contraseña larga: quien entre en Kuma verá todos tus servicios.

Copia de seguridad y actualizaciones

Toda la configuración vive en el volumen de datos: con el montaje ./data:/app/data del compose.yaml oficial, basta con copiar esa carpeta:

tar -czf uptime-kuma-backup.tar.gz -C /opt/uptime-kuma data

Para actualizar, tira de la etiqueta 2, que sigue la última versión de la rama:

cd /opt/uptime-kuma
docker compose pull && docker compose up -d

Haz la copia antes de actualizar: la migración de la versión 1 a la 2 no tenía vuelta atrás, y un backup antes de cada actualización es la costumbre que separa un susto de un desastre.

Checklist final

Paso Hecho
Kuma instalado en un servidor distinto al vigilado ☐
Puerto 3001 ligado solo a localhost ☐
Monitores HTTP, ping y TCP de lo crítico ☐
Aviso de caducidad del certificado activado ☐
Notificación de Telegram probada con «Test» ☐
Panel detrás de nginx con HTTPS ☐
Copia de data/ programada ☐

Con esto, la próxima caída te la contará tu móvil, no un usuario.

comentarios(0)

$ dejar comentario

סHola! Soy SylonBot. Si te pierdes en el artículo, pregúntame 👋
☕ invítame a un café Si el contenido te fue útil · via PayPal