Saltar a contenido

Uptime Kuma

Uptime Kuma es nuestro monitor de disponibilidad (uptime) self-hosted. Su trabajo es simple y distinto al de SigNoz: chequear de forma periódica que los sitios y servicios de los clientes estén levantados y respondiendo por HTTP, y avisar cuando alguno se cae.

Acceso rápido

UI: https://kuma.histrix.com.ar — protegida por Cloudflare Access (hay que autenticarse en Cloudflare antes de llegar a la pantalla de login de Kuma).

SigNoz vs Uptime Kuma

Son dos herramientas complementarias, no compiten:

SigNoz Uptime Kuma
Pregunta que responde "¿Cómo está por dentro este servidor?" "¿El sitio del cliente responde?"
Qué mide Métricas del host, logs y trazas (CPU, RAM, disco, errores) Disponibilidad / uptime por HTTP
Desde dónde mira Desde adentro (agente en cada servidor) Desde afuera (request HTTP al sitio)
Por dónde viaja Red privada ZeroTier Infra-mesh HTTP/HTTPS público hacia los sitios cliente
Tipo de dato Observabilidad profunda Estado arriba/abajo + latencia de respuesta

En resumen: SigNoz te dice por qué algo anda mal; Uptime Kuma te avisa que algo se cayó, desde el punto de vista del usuario final.

Dónde corre

Corre en un LXC dentro del mismo Proxmox que SigNoz, montado con el Proxmox VE Helper-Script de la comunidad — no con scripts propios.

graph LR
    subgraph PVE ["Proxmox (mismo host que SigNoz)"]
        K[Uptime Kuma<br/>LXC :3001]
    end

    subgraph CF ["Cloudflare"]
        CA[Cloudflare Access<br/>kuma.histrix.com.ar]
    end

    Persona[👤 Equipo] -->|HTTPS + auth| CA --> K
    K -->|HTTP/HTTPS chequeos| S1[Sitio cliente 1]
    K -->|HTTP/HTTPS chequeos| S2[Sitio cliente 2]
    K -->|HTTP/HTTPS chequeos| S3[Sitio cliente N]

Acceso

  • UI: https://kuma.histrix.com.ar
  • El acceso está protegido por Cloudflare Access — primero pasás por la pantalla de Cloudflare (autenticación) y recién después llegás al login de Uptime Kuma. No queda expuesto abierto a internet.

Puerto interno

Por defecto Uptime Kuma escucha en el :3001 dentro del LXC. El acceso público se termina en Cloudflare; el :3001 no necesita estar abierto a internet directamente.

Instalación

Se monta con el helper-script de community-scripts, ejecutado desde la Proxmox VE Shell (en el host Proxmox, no dentro del LXC):

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/uptimekuma.sh)"

Referencia: community-scripts.org/scripts/uptimekuma.

Primer usuario = admin

Igual que en SigNoz, el primer usuario que registres en la UI de Kuma queda como administrador. Registralo apenas termina la instalación.

Agregar un monitor (cliente nuevo)

  1. Entrar a https://kuma.histrix.com.ar (pasar Cloudflare Access + login).
  2. Add New Monitor.
  3. Tipo de monitor: HTTP(s) para chequear que un sitio responda.
  4. Completar:
    • Friendly Name: nombre del cliente / servicio.
    • URL: la URL pública del sitio del cliente.
    • Heartbeat Interval: cada cuánto chequea (ej. 60 s).
    • Retries: reintentos antes de marcarlo caído.
  5. (Opcional) Asignar una notificación para que avise cuando se caiga.

Notificaciones

Las alertas de caída se configuran en Settings → Notifications y después se asocian a cada monitor. Hoy usamos dos canales:

Canal Tipo en Kuma Para qué
Email SMTP Aviso por correo cuando un sitio se cae / se recupera
Google Chat Google Chat (webhook) Aviso al chat del equipo en tiempo real

Asociar el canal a cada monitor

Crear el canal en Settings → Notifications no alcanza: hay que tildarlo dentro de cada monitor (al crearlo o editarlo) para que ese monitor dispare la notificación. Si agregás un cliente nuevo, acordate de habilitarle ambos canales.

Google Chat por webhook

El canal de Google Chat funciona con un webhook de un espacio (space) de Google Chat. Si hay que recrearlo: en el espacio de Google Chat → Administrar webhooks → copiar la URL del webhook y pegarla en el canal de tipo Google Chat en Kuma.

Mantenimiento

Al ser un LXC montado con community-scripts en el mismo Proxmox que SigNoz, aplica el mismo esquema de actualización (ver SigNoz → Mantenimiento):

# Manual: actualizar la app dentro del LXC (con opción de backup vzdump)
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/tools/pve/update-apps.sh)"

Backup

Uptime Kuma guarda su configuración (monitores, notificaciones, historial) en una base SQLite dentro del LXC. Un vzdump del LXC desde Proxmox es la forma más simple de respaldarlo.