---
title: "Monitoriza tu web con Uptime Kuma: del despliegue al primer aviso de caída"
description: "Despliega Uptime Kuma en Zenavo desde la plantilla, añade comprobaciones para tu web y tu API, configura avisos por Telegram o correo, verifica los avisos de caída y recuperación y haz copia de seguridad del volumen."
date: 2026-11-10
language: es-ES
url: https://zenavo.app/es-ES/blog/uptime-kuma-monitoring
---

# Monitoriza tu web con Uptime Kuma: del despliegue al primer aviso de caída

Cuando una web o una API ya está en producción, es mejor que te avise un monitor en cuanto falle algo o esté a punto de caducar un certificado, en vez de enterarte por un usuario.

[Uptime Kuma](https://github.com/louislam/uptime-kuma) es una herramienta ligera y de código abierto para monitorizar tus propios servicios: comprueba HTTP(s), palabras clave, puertos TCP, DNS y caducidad de certificados, incluye páginas de estado públicas y soporta decenas de canales de aviso (Telegram, Slack, Discord, correo, webhooks y más). En esta guía usamos la plantilla de Uptime Kuma de Zenavo para ir desde el despliegue hasta recibir el primer aviso real.

## Dónde conviene desplegarlo

Antes de empezar, piensa en qué servidor vas a poner Uptime Kuma:

- **En el mismo servidor que tus aplicaciones**: sirve para empezar. Si se cae un contenedor o va a caducar un certificado, te avisará; pero si se cae el servidor entero o pierde la red, el monitor caerá con él.
- **En otro servidor pequeño independiente**: lo recomendable en producción. Uptime Kuma consume muy poca memoria, y tenerlo separado garantiza que te llegue el aviso aunque el servidor principal se quede completamente sin conexión.

## Despliega desde la plantilla

Primero [conecta un servidor Linux](https://docs.zenavo.app/es-ES/servers/add-a-server) a Zenavo, abre la [plantilla de Uptime Kuma](https://zenavo.app/deploy?template=uptime-kuma), elige el servidor y despliega.

Actualmente la plantilla configura:

| Ajuste | Valor o finalidad |
|---|---|
| Imagen | `louislam/uptime-kuma:1` |
| Puerto HTTP | `3001` |
| Volumen | `/app/data`: aquí se guardan la base de datos SQLite, los monitores, el historial y las credenciales de aviso |

En la pestaña **Red** del servicio uptime-kuma, asocia un dominio como `status.example.com` al puerto `3001`, añade en el DNS un registro A que apunte al servidor y espera a que esté listo el HTTPS. Los pasos están en [Dominios y HTTPS](https://docs.zenavo.app/es-ES/networking/domains).

**En cuanto esté activo el dominio, abre la web y crea la cuenta de administrador.** La primera persona que abre la página puede elegir el usuario y la contraseña de administrador, así que hazlo enseguida.

## Añade tu primer monitor

Al entrar, haz clic arriba a la izquierda en **Añadir nuevo monitor (Add New Monitor)**. Una buena configuración inicial:

| Campo | Recomendación |
|---|---|
| Tipo de monitor | **HTTP(s)** para una web o API normal; **HTTP(s) - Palabra clave** si quieres comprobar que la respuesta contiene un texto concreto |
| Nombre | Pon el entorno y qué comprueba, por ejemplo `Producción - Portada` o `API - /healthz` |
| URL | La dirección `https://` completa a la que entran los usuarios |
| Intervalo de latido | `60` segundos |
| Reintentos | `2` o `3`, para que un microcorte de red puntual no te despierte de madrugada |
| Aviso de caducidad de certificado | Actívalo para que te avise entre 7 y 14 días antes de que caduque el certificado TLS |

Si tu aplicación usa base de datos, además de la portada conviene añadir un monitor a un endpoint de salud como `/healthz` que compruebe también la conexión a la base de datos.

## Configura las notificaciones y haz un simulacro real

Abre **Ajustes → Notificaciones (Notifications)** en el menú de perfil de arriba a la derecha, o haz clic en **Configurar notificación** al editar un monitor:

1. Elige tu canal habitual (Telegram, Slack, Discord, correo SMTP, webhook, etc.) y rellena el token o los datos de acceso.
2. Haz clic en **Probar (Test)** y confirma que recibes el mensaje de prueba en el móvil o en el correo.
3. Activa **Habilitado por defecto (Default enabled)**, o marca ese canal dentro del propio monitor, y **guarda el monitor** (es muy habitual pulsar Probar, ver que llega el mensaje y olvidarse de activarlo en el monitor y guardar).

Para comprobar que el aviso llega cuando hay una caída de verdad, haz una prueba con un servicio de ensayo:

1. Añade un monitor para un servicio de prueba que no tenga tráfico real y espera a que salga en verde (**Up**).
2. Detén ese servicio de prueba en Zenavo, espera entre 1 y 3 minutos (según el intervalo y los reintentos) y comprueba que el monitor pasa a rojo (**Down**) y te llega el aviso de caída.
3. Vuelve a iniciar el servicio de prueba y confirma que también recibes el aviso de recuperación (**Up**).

## Página de estado pública (opcional)

Si quieres publicar una página de estado para tus usuarios del estilo `status.example.com/status/main`, entra en **Páginas de estado (Status Pages)** en la barra superior, crea una y añade solo los servicios que quieras mostrar al público. No incluyas paneles internos, bases de datos ni nombres de servicios privados.

## Copias de seguridad y actualizaciones

Los monitores, las claves de notificación y el historial de disponibilidad están en el volumen `/app/data`. Puedes hacer copia de seguridad desde la pestaña **Copias de seguridad y restauración** del servicio uptime-kuma:

1. Detén el proyecto (la copia de un volumen requiere que el proyecto esté detenido).
2. Crea la copia de seguridad y vuelve a iniciar el proyecto cuando termine.
3. Descarga una copia para conservarla (incluye los tokens y webhooks de tus notificaciones, así que guárdala en un lugar seguro). Más detalles en [Copias de seguridad y restauración](https://docs.zenavo.app/es-ES/operations/backups).

La plantilla usa `louislam/uptime-kuma:1` (fijada en la rama principal v1). Si más adelante actualizas a una versión mayor nueva, lee antes las [notas de la versión](https://github.com/louislam/uptime-kuma/releases) y haz copia de `/app/data`; tras migrar la base de datos a una versión mayor, volver a poner la imagen antigua no suele bastar y necesitarás restaurar la copia anterior.

## Preguntas frecuentes

**¿El botón de prueba envía el mensaje, pero cuando se cae un servicio no me llega nada?**
Abre la edición de ese monitor y mira la lista de **Notificaciones** de la derecha: asegúrate de que el canal está marcado para ese monitor y pulsa **Guardar** abajo.

**¿Hace falta montar el socket de Docker del servidor?**
No. Con comprobaciones HTTP(s) y TCP puedes vigilar casi cualquier servicio sin darle al contenedor acceso a `docker.sock`. Si quieres vigilar otro servicio del mismo proyecto de Zenavo por la red interna, puedes usar su dirección privada (como `http://api.zenavo.internal:3000/healthz`).

**¿Recibo demasiadas falsas alarmas por cortes de un segundo?**
Sube los **Reintentos (Retries)** del monitor de `0` a `2` o `3` y amplía un poco el tiempo de espera para que solo avise cuando falle varias veces seguidas.

Empieza con la [plantilla de Uptime Kuma](https://zenavo.app/deploy?template=uptime-kuma): asocia tu dominio, crea el administrador, vincula tu canal de aviso y haz una prueba de caída y recuperación para quedarte tranquilo.