Saltar a contenido

📈 Monitorización de estado (Uptime Kuma)

Uptime Kuma es el sistema utilizado en CORDIA para monitorizar la disponibilidad de los servicios y contenedores del entorno Docker. Permite detectar caídas, fallos de acceso o errores persistentes de forma visual y configurable.

🎯 ¿Para qué se usa?

  • Monitorizar si los servicios están activos (API, MySQL, Grafana, Docs...)
  • Recibir alertas si alguno de ellos cae
  • Controlar tiempos de respuesta, estado de puertos, certificados SSL, etc.

🔧 Acceso local

No requiere autenticación por defecto, pero puede configurarse con contraseña desde la interfaz.

📦 Persistencia

  • Los datos de configuración y monitoreo se almacenan en:
./docker-data/uptime-kuma/

Este volumen guarda los monitores, configuraciones y estado entre reinicios.

🚀 Cómo levantar el servicio

./run-service.sh dev uptime

🧩 Qué se puede monitorizar

  • URLs: http://panel.cordia.local, http://api.cordia.local, etc.
  • Puertos: 3306 (MySQL), 81 (NPM)
  • Certificados SSL (si se define un host HTTPS)
  • Ping, HTTP(s), TCP, DNS, Docker, etc.

🔔 Alertas

  • Puedes configurar alertas por correo, Telegram, Discord, Webhook y otros canales.
  • También se puede definir un tiempo de espera máximo antes de marcar un servicio como "caído".

🛠 Recomendaciones

  • Añadir todos los dominios de servicios principales para monitorización continua.
  • Revisar de vez en cuando el historial de caídas para detectar patrones.

Para levantar todos los servicios y garantizar su conexión, usa run.sh o run-service.sh. Consulta también servicios-auxiliares.md.