- Uptime Kuma es una alternativa open source y autoalojada que permite vigilar la disponibilidad de servicios web, puertos TCP y contenedores Docker.
- El sistema ofrece un ecosistema masivo de notificaciones integrado con más de 90 servicios como Telegram, Discord y Slack.
- Permite la creación de páginas de estado públicas para informar a los usuarios sobre la operatividad de la infraestructura sin exponer datos sensibles.
¿Cómo monitorizar un puerto TCP con Uptime Kuma? Imagina que te despiertas a las tres de la mañana porque un servicio crítico de tu empresa ha petado o, peor aún, que te enteras días después porque un cliente enfadado te ha enviado un correo. Para cualquiera que gestione un servidor, ya sea un NAS en el salón de casa o una infraestructura profesional, saber que todo marcha sobre ruedas es fundamental para no perder la salud. Antiguamente, montar algo así era un auténtico dolor de cabeza que requería leer manuales infinitos y hacer pruebas hasta el cansancio.
Afortunadamente, hoy tenemos herramientas como Uptime Kuma, que han venido a simplificar la vida de los sysadmins. Se trata de una solución ligera y extremadamente potente que puedes desplegar en cuestión de minutos, permitiéndote tener un control total sobre tus dispositivos sin depender de suscripciones mensuales caras ni de enviar tus datos a terceras empresas.
¿Qué es exactamente Uptime Kuma y para qué sirve?
Básicamente, es un sistema de monitorización de disponibilidad de código abierto desarrollado en Node.js. Lo que lo hace especial es su interfaz web moderna y muy intuitiva, que hace que no necesites ser un experto en redes para empezar a vigilar tus servicios. Puedes instalarlo de forma nativa, aunque lo más común y recomendable es usar contenedores Docker para evitar líos de dependencias.
Esta herramienta actúa como un vigilante 24/7 que lanza peticiones a tus servicios y, si alguno no responde según lo esperado, te pega un aviso inmediato. Es el punto medio perfecto entre las soluciones excesivamente complejas como Prometheus y los servicios comerciales cerrados como UptimeRobot.
Tipos de monitorización disponibles
Lo más potente de Kuma es la variedad de «checks» que puede realizar. No se queda solo en saber si una web carga, sino que profundiza en diferentes niveles de la red:
- HTTP y HTTPS: Comprueba que una URL devuelva el código de estado correcto (por ejemplo, un 200 OK). Incluso permite buscar una palabra clave específica en el cuerpo de la página para asegurar que el servicio no esté devolviendo una página de error «maquillada».
- Puertos TCP: Es la opción ideal para vigilar bases de datos (como MySQL en el 3306 o PostgreSQL en el 5432) o servicios de mensajería y colas, verificando que el puerto esté abierto y aceptando conexiones.
- Ping (ICMP): El chequeo más básico y ligero. Sirve para saber si el equipo está encendido y conectado a la red, aunque no garantiza que el servicio específico esté funcionando.
- Contenedores Docker: Si conectas el socket de Docker, Kuma puede decirte si un contenedor específico está en estado running.
- Otros servicios: Soporta consultas DNS, servidores de juegos de Steam, MQTT, gRPC y monitorización de la caducidad de certificados SSL para que no se te olvide renovarlos.
Instalación y despliegue paso a paso
La forma más limpia de montar Uptime Kuma es mediante Docker Compose. Primero, es recomendable crear un directorio dedicado en tu servidor y generar un archivo docker-compose.yml. En este archivo debes definir la imagen oficial (louislam/uptime-kuma), mapear el puerto 3001 y, muy importante, configurar un volumen persistente en /app/data para que no pierdas toda tu configuración si el contenedor se reinicia.
Si prefieres la vía manual, puedes clonar el repositorio de GitHub, ejecutar npm run setup y gestionar el proceso con PM2 para asegurar que la aplicación arranque automáticamente con el sistema. Una vez desplegado, accedes a través del navegador, creas tu usuario administrador con una contraseña robusta y ya estás dentro del panel de control.
Configuración de alertas y notificaciones
De nada sirve tener un monitor si no te enteras de que algo ha fallado. Uptime Kuma destaca por su integración con más de 90 servicios de aviso. Los más populares entre los usuarios son:
- Telegram: Creando un bot a través de @BotFather y vinculando el Token y el Chat ID. Es probablemente la vía más rápida y cómoda para recibir alertas en el móvil.
- Discord y Slack: Utilizando webhooks entrantes, lo que permite que los avisos lleguen directamente a un canal específico del equipo.
- Email (SMTP): Configurando los datos de tu servidor de correo. Es vital usar contraseñas de aplicación si utilizas servicios como Gmail.
Gestión avanzada: Páginas de estado y mantenimiento
Para aquellos que ofrecen servicios a terceros, las páginas de estado son una joya. Permiten crear una URL pública donde cualquier usuario puede ver si los servicios están operativos, evitando que el soporte técnico se llene de preguntas del tipo «¿está caída la web?». Puedes organizar los monitores por grupos y personalizar la apariencia con CSS.
Además, para evitar que el sistema te bombardee con alertas falsas durante una actualización programada, existen las ventanas de mantenimiento. Al activarlas, Kuma pausa las notificaciones y marca el servicio como «en mantenimiento» en la página de estado, manteniendo así un historial de disponibilidad limpio y sin caídas ficticias.
Consejos de optimización y buenas prácticas
Para que el sistema funcione como un reloj, no conviene dejar los ajustes por defecto. Un error común es poner intervalos de chequeo demasiado agresivos (como cada 20 segundos), lo que puede generar carga innecesaria en el servidor y ruido en las notificaciones. Para la mayoría de los servicios, un intervalo de 60 segundos es más que suficiente.
Otro punto crítico es la seguridad. Si vas a exponer la interfaz a internet, es imprescindible colocarla detrás de un proxy inverso como Nginx Proxy Manager, Traefik o Caddy para gestionar el HTTPS y los certificados SSL. Asimismo, no olvides realizar copias de seguridad periódicas del directorio de datos, ya que ahí reside toda la inteligencia del sistema.
Si alguna vez experimentas errores de conexión (como el famoso EHOSTUNREACH), comprueba que el contenedor de Docker tenga visibilidad de red hacia el host o el dispositivo destino. A veces, los firewalls de Windows o las configuraciones de red de la VM pueden bloquear el tráfico TCP, haciendo que el monitor marque el servicio como caído aunque esté funcionando.
Tener implementada una solución de monitorización autoalojada permite pasar de una gestión reactiva a una proactiva, detectando incidencias antes que los usuarios finales. Combinando la vigilancia de puertos TCP, el rastreo de certificados SSL y la potencia de las notificaciones instantáneas, se logra una infraestructura robusta y transparente que minimiza los tiempos de inactividad y maximiza la fiabilidad de cualquier ecosistema digital, ya sea doméstico o empresarial.
Apasionado de la tecnología desde pequeñito. Me encanta estar a la última en el sector y sobre todo, comunicarlo. Por eso me dedico a la comunicación en webs de tecnología y videojuegos desde hace ya muchos años. Podrás encontrarme escribiendo sobre Android, Windows, MacOS, iOS, Nintendo o cualquier otro tema relacionado que se te pase por la cabeza.