La API de Orbit corre en el plan gratuito de Render, y sus bases de datos en el plan gratuito de Supabase. Los dos son gratuitos porque se duermen: Render después de 15 minutos sin tráfico, Supabase después de un periodo de lo que llama baja actividad. Una API dormida significa que la primera persona que abre la app espera un cold start, y una base de datos pausada significa que no responde en absoluto.
keepalive es la pieza pequeña que evita que eso pase. Es un Cloudflare Worker con dos cron triggers: uno hace ping a la API y a los sitios cada 10 minutos, el otro llama a cada base de datos cada hora. Lo que ve se guarda en Workers KV y se sirve como una página de estado en keepalive.byjuliocesa.dev, hecha con React y Vite y servida como archivos estáticos por el mismo Worker. Cuando un servicio pasa de arriba a caído, puede enviar una alerta a un webhook.
El repositorio es privado. La página, su JSON y su badge son públicos.
Un Worker que mantiene despierto a Render
La primera versión hacía una sola cosa: un GET al /system/ping de Orbit cada
10 minutos, que es menos que los 15 que Render espera antes de dormirse, y una
llamada diaria a cada base de datos. Un Worker en el plan gratuito de Cloudflare
corre crons sin costo, así que el precio de mantener despiertos los planes
gratuitos es otro plan gratuito.
Decisión
Un Cloudflare Worker con cron triggers, la API con ping cada 10 minutos y las
bases de datos una vez al día, cada base exponiendo una función
public.keepalive() a través de su endpoint REST.
Compromisos
- Todo depende de que Cloudflare siga ofreciendo crons en su plan gratuito.
- Mantiene los servicios despiertos; no los hace rápidos. Un cold start que ocurre de todos modos sigue siendo un cold start.
Un registro por cron, por la cuota de escritura
El plan gratuito de KV permite 1000 escrituras al día. Un cron cada 10 minutos son 144 ejecuciones al día, y escribir una clave por servicio multiplicaba eso por cada servicio de la lista. La cuota se agotaba sola.
Decisión
Todo lo que un cron averigua va a un solo registro: el último estado de cada servicio, un resumen diario de 90 días, los últimos 288 pings y los incidentes abiertos. Una ejecución, una escritura.
Compromisos
- La forma de los datos la decide la cuota, no lo que sería más fácil de leer.
- Cada ejecución reescribe el registro completo, así que tiene que seguir siendo pequeño.
Ese mismo día entraron otras dos reglas. Una falla solo cuenta después de un
segundo intento, para que una sola respuesta lenta no abra un incidente. Y una
respuesta tiene que contener un fragmento de texto esperado: una página de error
servida con HTTP 200 sigue siendo una falla. La lista de objetivos también salió
del código y pasó a KV, así que un servicio se agrega o se quita con
npm run config, sin deploy.
Una ruta de salud que falla cuando el trabajo se detiene
Un monitor externo vigilaba la página de estado, y la página siempre respondía 200. Si el cron se detenía, la página seguía mostrando los últimos datos que tenía, con cara de que todo estaba bien, y el monitor no veía nada raro.
Decisión
/api/health devuelve 500 cuando un cron se atrasa: más de 30 minutos desde la
última ejecución del cron de 10 minutos, más de 3 horas para el cron de las
bases de datos. El monitor externo apunta ahí en lugar de a la página.
La pregunta del monitor cambió de "¿responde el servidor?" a "¿está ocurriendo el trabajo?". Solo la segunda valía la pena.
Llamadas cada hora, porque una al día no era actividad
La base de datos de desarrollo se pausó el 27 de septiembre aunque recibía la llamada diaria, y la llamada sí le llegaba: la latencia era la misma que la de producción. Supabase pausa los proyectos que considera de baja actividad, y pide algunas solicitudes al día. Una al día no bastaba.
Decisión
El cron de las bases de datos corre cada hora (0 * * * *). La verificación
RDAP del dominio sigue siendo una vez al día, a las 03:00 UTC.
Compromisos
- Veinticuatro llamadas al día por base de datos en lugar de una, por una regla que Supabase no expresa en números.
- El límite de salud del cron de las bases de datos era de 26 horas mientras la llamada era diaria; ahora es de 3 horas.
Una página de estado que se lee de un vistazo
La página se rediseñó desde cero con dos skills de diseño: una definió la dirección, la otra la construyó y la mandó a revisión. La dirección hizo de cada servicio una línea ancha, con su franja de historial ocupando la mayor parte del ancho, para que el estado completo se lea de un vistazo en el celular. La alternativa más fuerte era un tablero de salidas en monoespaciada; elegí las líneas.
Decisión
Una línea ancha por servicio, con la franja de historial como elemento principal. Geist y Geist Mono, un fondo grafito con acento cobalto, e íconos Phosphor. Salieron el naranja, Archivo como tipografía de la interfaz y las esquinas rectas; el logo se quedó.
La revisión pidió seis cambios en su primera ronda y aprobó la segunda. La franja tiene tres ventanas: 24 horas en 72 tramos de 20 minutos, 7 días en 84 tramos y 90 días en un tramo por día. Una respuesta de 2 segundos o más se marca como lenta.
Monitorear lo que no se duerme
LyricsLens y BetoBita corren en Vercel, que no duerme los sitios, así que nunca necesitaron mantenerse despiertos. Entraron a la lista de todos modos, como monitoreo en la página pública. Antes de agregar BetoBita, una verificación tardó 7.98 segundos; el primer ping de keepalive midió 587 ms.
La lista tiene siete objetivos hoy: la API y la app web de Orbit, este sitio, LyricsLens, BetoBita, y las bases de datos de desarrollo y de producción.