Uptime Kuma

Aunque existe una abundancia de soluciones de monitoreo de disponibilidad de servicios, puede resultar difícil encontrar una que cubra sus necesidades básicas y que funcione simplemente sin personalizaciones complejas. Utilizando diferentes enfoques para la disponibilidad continua, recomendamos una solución sencilla que es adecuada para todos los propietarios de instancias On-premise, ya sea desplegadas localmente dentro de las organizaciones o en servicios en la nube.

La solución ordenada que recomendamos cumple las siguientes necesidades:

• Desplegada localmente en el servidor (por lo tanto adecuada para infraestructuras clasificadas)

• Fácil de instalar

• Tiene una interfaz amigable para el usuario y no está sobrecargada de opciones

• Capaz de monitorear una variedad de métricas (no solo hacer ping a una dirección)

• Admite una variedad de opciones de notificación (correo electrónico, sms, mensajería y más)

La solución se llama Uptime Kuma y está disponible en el GitHub del autor:

https://github.com/louislam/uptime-kuma

Esta solución está diseñada para el monitoreo externo de la disponibilidad del servicio, lo cual suele ser suficiente. No es adecuada para monitorear métricas internas, como el estado de los servicios del sistema, la carga de la CPU, el consumo de memoria, etc.

Instalación

La instalación se describe en detalle en la página del producto en GitHub, por lo que no nos centraremos en sus detalles. Cabe señalar que lo más sencillo es desplegar el contenedor docker, lo cual se hace literalmente en un comando.

¿Cómo instalar Docker?

Hay muchas instrucciones sobre cómo instalar Docker en diferentes plataformas. La forma más simple es usar una versión de Linux actualizada y realizar la instalación usando estos comandos:

curl -fsSL https://get.docker.com -o install-docker.sh
sh ./install-docker.sh

Si está utilizando una plataforma diferente (Mac, Windows) o desea instalar Docker Desktop, consulte la sección correspondiente en la documentación de Docker:

https://docs.docker.com/manuals/

También existe un método alternativo de instalación sin usar Docker, que también es relativamente sencillo y está disponible para Linux y Windows. La elección del método de instalación depende de usted.

Es importante asegurarse de que dispone de un puerto dedicado en su servidor para Uptime Kuma: el valor predeterminado es 3001.

Después de realizar la instalación, la interfaz web de Uptime Kuma será accesible mediante la dirección del servidor (dominio o dirección IP) y el puerto y estará inmediatamente lista para usarse. Deberá configurar las credenciales de administrador y proceder a la configuración de las métricas.

Métricas

Las métricas más importantes desde una perspectiva empresarial son la disponibilidad del sitio web, el acceso del cliente a los datos y el registro de nuevos datos desde los dispositivos de seguimiento. Esto es lo que vamos a monitorizar.

Para cada métrica, puede especificar un intervalo de latido (heartbeat) para ajustar con qué frecuencia se ejecutarán las comprobaciones (el valor predeterminado es 60 segundos), ajustar el número de reintentos (antes de considerar el servidor caído) y establecer otros parámetros.

Disponibilidad del sitio web

Para comenzar, cree el primer monitor que supervisará la disponibilidad del dominio en función de solicitudes HTTPS. Seleccione el tipo de monitor HTTP(s), asígnele un nombre y especifique la URL de su sitio web. Esto comprobará la disponibilidad del sitio web en función de los códigos de estado HTTP. Los códigos son 200-299, por lo que si se recibe cualquier otro código (p. ej. 404 Not found o 504 Gateway timeout) se considerará una falla y el monitor reportará que el servicio está caído.

La sección “Avanzado” ofrece opciones de configuración de monitoreo extendidas y, en particular, la notificación de caducidad del certificado. Marque esta opción para ser notificado cuando expire el certificado de su sitio web y así poder renovarlo puntualmente.

Guarde la configuración del monitor y comenzará automáticamente a rastrear la disponibilidad del sitio web.

Disponibilidad de la API

La API es un servicio central necesario para que el sitio web interactúe con el backend de la plataforma; además, muchos clientes la utilizan para recuperar datos directamente desde la plataforma. Por lo tanto, el funcionamiento estable de la API también es de importancia primaria. Y el monitoreo del funcionamiento de este servicio se puede realizar con una simple solicitud API.

La solicitud se ve así:

https://my.domain.com/api/base/ping/

Y la respuesta de un servicio que funciona normalmente sería el siguiente JSON:

{"success": true}

Puede configurar el monitor para que funcione con esta respuesta. Para ello, cree otro monitor de tipo HTTP(s), especifique la solicitud API en URL y luego personalice las opciones HTTP:

• Método: GET

• Codificación del cuerpo: JSON

• Cuerpo: {"success": true}

Guarde la configuración del monitor y comenzará automáticamente a comprobar la disponibilidad de la API enviando la solicitud especificada y analizando las respuestas.

Disponibilidad TCP

Recibir datos de los dispositivos es crítico para la plataforma de seguimiento. Por lo tanto, es importante mantener el acceso a los dispositivos y monitorear la actividad del servidor TCP. Dado que el servicio de monitoreo es externo a la plataforma, puede simplemente supervisar la disponibilidad externa de cualquiera de los puertos en los que se conectan los dispositivos de seguimiento. Por ejemplo, puede ser el puerto 47770 para la app móvil X-GPS tracker, 47776 para Teltonika o cualquier otro puerto para los dispositivos que tenga en uso.

Configure el monitor: seleccione el tipo de monitor “TCP Port”, especifique su dominio básico y el puerto que prefiera.

Guarde la configuración del monitor y comenzará a comprobar la disponibilidad del puerto.

Notificaciones

Para cada métrica, tiene la opción de configurar notificaciones para que Uptime Kuma le advierta cuando ocurran eventos de indisponibilidad. De este modo, no solo dispondrá de gráficos de disponibilidad del servicio, sino que también recibirá notificaciones urgentes si uno de los servicios deja de funcionar.

Puede configurar varios tipos de notificaciones, pero es importante tener en cuenta que Uptime Kuma no es en sí mismo una pasarela de notificaciones. Para configurar cualquier tipo de notificación, necesita las credenciales de la pasarela externa correspondiente (por ejemplo, SMTP, Twilio, Discord, etc.).

Después de especificar la configuración de la pasarela de notificaciones, se le informará de los problemas del servicio a través del canal que elija.