Esta noche cae tu balanceador de carga. No hay ningún cliente conectado, así que las métricas de errores siguen planas y no sale ninguna alerta. Ese escenario es el punto de partida de Gatus y explica por qué una Gatus página de estado merece un sitio junto a tus paneles: el proyecto consulta tus servicios por su cuenta, en lugar de esperar a que el tráfico real destape la caída. El repositorio TwiN/gatus lo define como un panel de salud «orientado a desarrolladores».
Por eso parto de tres decisiones de operación y no de un catálogo de funciones: qué consideras un servicio sano, cuántos fallos toleras antes de despertar a alguien y dónde guardas el historial. Todo se configura en un único archivo YAML.
Una aclaración de método: span.observer no ha instalado ni ejecutado Gatus. Los datos salen del README y de la estructura del repositorio, leídos el 10 de noviembre de 2026. Las imágenes son del propio repositorio (licencia Apache 2.0) o un render de su configuración de ejemplo. El número de estrellas no se pudo leer en origen ese día, así que no lo cito.
Gatus página de estado: lo que dice el repositorio
- Licencia: el archivo LICENSE contiene la Apache License 2.0.
- Lenguaje: Go;
go.modexige Go 1.26.3. - Versión: la etiqueta Git más reciente tras clonar es
v5.38.0. El último commit de la rama principal es del 9 de noviembre de 2026. - Sondas: peticiones HTTP, ICMP, TCP y DNS según el README; una sección de las preguntas frecuentes añade SSH, TLS, gRPC y WebSocket.
El argumento central del README es sencillo. Una métrica de tráfico enmudece cuando el tráfico desaparece, mientras que una sonda activa sigue preguntando. Ambos enfoques se complementan: la sonda responde «contesta» y la telemetría responde «cómo se comporta».

Primera decisión: ¿qué es un servicio sano?
Un código 200 prueba muy poco. Gatus lo asume: cada endpoint lleva una lista de condiciones y basta con que una sea falsa para declararlo enfermo. Este es el ejemplo inicial del README:
endpoints:
- name: website
url: "https://twin.sh/health"
interval: 5m
conditions:
- "[STATUS] == 200"
- "[BODY].status == UP"
- "[RESPONSE_TIME] < 300"
Tres condiciones, tres preguntas distintas: ¿responde el servidor?, ¿dice que está bien?, ¿responde con suficiente rapidez? La tabla de condiciones del README incluye más, como [CERTIFICATE_EXPIRATION] > 48h, [CONNECTED] == true, len([BODY].data) < 5 o [BODY].name == pat(john*). Mi consejo: escribe la condición que notaría tu usuario, no la que resulta cómoda de comprobar. Vigilar el certificado con 48 horas de margen te ahorra una caída absurda un domingo.
La tarjeta del endpoint guarda las condiciones evaluadas en cada pasada. Al pasar el cursor sobre una barra del historial, el panel muestra la marca de tiempo, el tiempo de respuesta y cada condición comprobada.

Segunda decisión: ¿cuántos fallos antes de alertar?
Una alerta al primer fallo despierta a todo el equipo por un paquete perdido. Por eso el README fija valores por defecto prudentes en cada alerta:
failure-threshold: 3 fallos consecutivos antes de disparar;success-threshold: 2 éxitos consecutivos antes de cerrar el incidente;send-on-resolved: falso por defecto, de modo que no hay aviso de cierre si no lo pides;minimum-reminder-interval: desactivado por defecto y nunca menor de 5 minutos.
Estos ajustes son una política de ruido. Cuanto más alto el umbral, menos te molestan, pero más tiempo sufre la caída el usuario antes que tú. El README ilustra el equilibrio con dos alertas sobre el mismo endpoint, una al tercer fallo y otra al quinto, para escalar en dos tiempos. El proveedor se declara una vez a nivel global y cada endpoint lo referencia:
alerting:
slack:
webhook-url: "https://hooks.slack.com/services/**********/**********/**********"

El repositorio admite muchos proveedores (Slack, Teams, PagerDuty, Discord, Telegram, ntfy, Opsgenie, correo electrónico y otros, según el directorio alerting/provider). Ojo: en el README algunos llevan la advertencia «aún sin probar», por ejemplo Squadcast. Comprueba el tuyo antes de confiarle tus guardias. Para un método de clasificación de señales, mira https://span.observer/es/alertar-sobre-sintomas-no-causas/; para la misma lógica de umbrales en Dynatrace, https://span.observer/es/reducir-ruido-alertas-davis/.

Tercera decisión: ¿dónde guardar el historial?
Por defecto el almacenamiento está en memoria: un reinicio borra el historial y el uptime mostrado. El README ofrece sqlite (con la ruta de un archivo) o postgres (con una URL de conexión).
storage:
type: sqlite
path: data.db
Otras dos palancas afectan a la operación. Las ventanas de mantenimiento (maintenance.start, duration, timezone, every) evitan alertas durante un despliegue planificado. Los «external endpoints» invierten el sentido: un agente dentro de una red privada empuja su estado a Gatus con un token, y un heartbeat.interval genera un fallo si el mensaje no llega a tiempo. Es la respuesta del proyecto al caso en que Gatus no puede alcanzar el servicio.
Puesta en marcha y verificación
El README da un comando de Docker; la variante con archivo monta tu configuración en /config/config.yaml:
docker run -p 8080:8080 --name gatus ghcr.io/twin/gatus:stable
docker run -p 8080:8080 --mount type=bind,source="$(pwd)"/config.yaml,target=/config/config.yaml --name gatus ghcr.io/twin/gatus:stable
- Escribe un
config.yamlcon un solo endpoint y sus condiciones. - Lanza el segundo comando y abre
http://localhost:8080: la tarjeta debe aparecer. - Rompe una condición a propósito (por ejemplo
[STATUS] == 201): la tarjeta debe pasar a «Unhealthy». - Espera tres fallos: la alerta debe salir. Restablece la condición: debe resolverse tras dos éxitos si
send-on-resolvedestá activo.
Gatus recarga el archivo en caliente. Si la nueva versión no es válida, se cierra, salvo que skip-invalid-config-update valga true. El README desaconseja ese ajuste y avisa de que la detección puede fallar si montas el archivo en lugar del directorio. Revisa el log después de cada cambio.
Límites que conviene conocer
- Las «suites» llevan la etiqueta ALPHA y las instancias remotas («remote») se describen como experimentales, con riesgo de cambios incompatibles.
- La ejecución está limitada por
concurrency(3 por defecto): muchos endpoints lentos, con un tiempo máximo por defecto de 10 s, pueden retrasar al resto. El intervalo no incluye la duración de la propia petición. - Gatus dice si un servicio responde. No explica por qué: no sustituye a las trazas ni a los logs.
- No he medido rendimiento: aquí no se da ninguna cifra de carga.
Conectar Gatus con tu observabilidad
Con metrics: true, Gatus expone métricas en formato Prometheus en /metrics, en el puerto de la aplicación. El README menciona, por ejemplo, gatus_results_total, gatus_results_duration_seconds, gatus_results_certificate_expiration_seconds y gatus_results_endpoint_success (0 si falla, 1 si acierta). Así puedes alertar sobre la vigencia de un certificado con tu motor habitual; mira https://span.observer/es/reglas-de-alerta-de-prometheus-promtool-ci/. No he verificado su recolección con otra herramienta (OpenTelemetry Collector, Dynatrace). Para otro proyecto del mismo registro, consulta https://span.observer/es/argo-cd-gitops-kubernetes-despliegue-continuo/.
Buenas prácticas
- Sondea el recorrido del usuario (inicio de sesión, API clave), no solo la página de inicio.
- Deja
failure-thresholden 3 al principio y ajústalo con el historial de falsas alarmas. - Pasa a
sqliteopostgresen cuanto el historial importe. - Nunca pongas el token de un webhook en un repositorio público: el README prevé usar variables de entorno dentro del archivo.
- Coloca Gatus fuera de la infraestructura que vigila, o caerá con ella.
Preguntas frecuentes
¿Gatus sustituye a Prometheus o a Dynatrace?
No. Gatus contesta a «¿responde el servicio como prometió?». Las métricas, trazas y logs explican las causas. Los dos enfoques se complementan.
¿Qué licencia tiene Gatus?
El repositorio incluye el texto de la Apache License 2.0. Relee el archivo LICENSE antes de redistribuir nada.
¿Cómo evito una alerta durante un mantenimiento?
Define maintenance de forma global, o maintenance-windows en un endpoint, con hora de inicio, duración y zona horaria.
Conclusión
Gatus cabe en un archivo YAML y en una pregunta útil: ¿me enteraría de que algo se rompe antes que mis clientes? Las tres decisiones (condiciones, umbrales, almacenamiento) hacen casi todo el trabajo. Mantén la sonda activa como complemento de tu telemetría y pruébala rompiéndola a propósito.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Gatus es un proyecto de terceros, no publicado por Dynatrace. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión.