Monitorización sencilla para casa con Uptime Kuma y Docker

En muchos entornos domésticos y pequeños homelabs, ya sabes, nuestros cacharreos, tendemos a asumir que, mientras los equipos estén encendidos, todo funciona como debería. El servidor arranca, los contenedores Docker están en estado running y nuestros NAS, esto es, almacenamiento en red, responde a un ping, así que damos por hecho que no hay problemas. Sin embargo, con el paso del tiempo y a medida que vamos añadiendo servicios, esta suposición ya no es tan fiable como parece..

Un servicio puede estar levantado y, aun así, no responder correctamente. La interfaz web puede tardar minutos en cargar, una base de datos puede haberse quedado bloqueada, o un contenedor puede estar vivo pero sin cumplir su función y con errores. Este tipo de fallos no siempre son evidentes y, si no accedemos al servicio de forma habitual, pueden pasar desapercibidos durante horas o incluso días. Y esto os lo digo por experiencia.

El problema real aparece cuando dependemos de esos servicios para algo concreto: acceder a nuestros archivos, conectarnos por VPN, por ejemplo WireGuard u OpenVPN, consultar una aplicación interna o simplemente comprobar que una copia de seguridad se ha ejecutado correctamente. En ese momento descubrimos que algo lleva tiempo sin funcionar y que nadie nos ha avisado. No porque no existiera el fallo, sino porque nunca estuvimos comprobando de forma activa su estado.

Por eso, incluso en casa, tiene sentido introducir un mínimo de monitorización. No se trata de montar una infraestructura compleja, enorme, ni de recopilar métricas innecesarias, sino de tener visibilidad sobre lo esencial: saber si nuestros dispositivos están accesibles, si los servicios responden y, sobre todo, recibir un aviso cuando dejan de hacerlo. A veces, ese pequeño control marca la diferencia entre detectar un problema a tiempo o enterarnos cuando ya es demasiado tarde.

Logo del proyecto Uptime Kuma

Uptime Kuma + Docker, una gran alternativa

Uptime Kuma es una herramienta de monitorización que sigue la filosofía de desarrollo, open source, pensada para cubrir una necesidad muy concreta: saber si nuestros servicios están disponibles y responden correctamente, sin necesidad de montar una infraestructura compleja. No pretende competir con soluciones de monitorización empresarial, como Nagios, Zabbix, Icinga, CheckMK o Munin, de las que ya hemos hablado, ni abarcar todos los casos posibles, sino ofrecer una forma clara y directa de controlar el estado de aquello que realmente nos importa en el día a día.

Una de las cosas que más llama la atención al empezar a utilizar Uptime Kuma es lo accesible que resulta desde el primer momento. La interfaz web es clara, intuitiva y fácil de entender, incluso para quien no tiene experiencia previa con herramientas de monitorización. Crear un nuevo monitor es cuestión de unos pocos clics y en seguida podemos comprobar si un servicio web responde, si un dispositivo está accesible por red o si un puerto concreto está escuchando. Todo sin menús enrevesados ni configuraciones difíciles de seguir.

Monitores funcionando en Uptime Kuma

En imagen anterior podemos ver unos cuantos monitores que tengo añadidos en casa y también para controlar las páginas webs que me interesan, que gestiono o colaboro.

Otro punto fuerte de Uptime Kuma es la variedad de tipos de comprobación que ofrece. Permite monitorizar servicios HTTP y HTTPS, realizar pings, comprobar puertos TCP, verificar resoluciones DNS o incluso supervisar contenedores Docker directamente. Esto lo convierte en una herramienta muy flexible para entornos domésticos y homelabs, donde conviven dispositivos y servicios muy distintos entre sí. Además, mantiene un historial claro del estado de cada monitor, lo que ayuda a detectar patrones o problemas recurrentes sin necesidad de análisis complejos.

Lista de servicios y protocolos a monitorizar

En la imagen anterior vemos multitud de servicios y protocolos que se pueden monitorizar.

El hecho de que sea una solución autoalojada es también un aspecto clave. Al ejecutarse en nuestra propia infraestructura, no dependemos de servicios externos ni tenemos que exponer información sobre nuestra red a terceros. Todo queda bajo nuestro control, tanto los datos como las configuraciones. A esto se suma un sistema de notificaciones bien integrado, que permite recibir avisos cuando algo deja de funcionar y también cuando se recupera, ayudándonos a reaccionar a tiempo sin necesidad de estar revisando constantemente el panel.

Despliegue con Docker

Aquí os dejo un ejemplo de despliegue, usando Docker compose, aunque lo ideal es siempre consultar la documentación oficial.

version: "3"
 
services:
  uptime-kuma:
    image: louislam/uptime-kuma:latest
    container_name: uptime-kuma
    restart: unless-stopped
    ports:
      - "3001:3001"
    volumes:
      - /mnt/docker/uptime-kuma-data:/app/data
    environment:
      - TZ=Europe/Madrid
 
#volumes:
  #uptime-kuma-data:

Aquí al gusto de cada uno. En mi caso utilizo un punto de montaje NFS, que va contra mi cabina Synology, donde guardo la información de la aplicación.

Notificaciones con Telegram

Uptime Kuma incorpora un sistema de notificaciones muy completo y fácil de configurar, compatible con múltiples plataformas. Entre todas ellas, Telegram destaca especialmente por su simplicidad y eficacia.

Configurar un bot y asociarlo a nuestra aplicación es un proceso rápido, y a partir de ese momento podemos recibir avisos directamente en nuestro móvil o escritorio cada vez que un servicio cae o se recupera. Esto permite reaccionar con rapidez ante un problema real y, al mismo tiempo, evitar la sobrecarga de alertas innecesarias si configuramos los intervalos y los monitores con criterio. En la práctica, recibir un mensaje claro en Telegram cuando algo falla suele ser mucho más efectivo que revisar logs o dashboards de forma manual.

A modo de resumen

En definitiva, tener controlado el estado de nuestros dispositivos y servicios, incluso en nuestro entorno doméstico, no es una cuestión de complejidad sino de sentido común. Herramientas como Uptime Kuma demuestran que es posible monitorizar lo esencial de forma sencilla, autoalojada y sin necesidad de grandes infraestructuras. Con un despliegue rápido mediante Docker y un sistema de notificaciones eficaz, por ejemplo con Telegram, podemos ganar visibilidad, anticiparnos a problemas y evitar sorpresas desagradables. A veces, contar con la información adecuada en el momento justo es todo lo que necesitamos para que nuestro pequeño ecosistema tecnológico funcione de manera fiable y tranquila.

Web oficial del proyecto Uptime Kuma

Nota: La imagen de portada ha sido generada mediante IA