how-i-build

keepalive

Un Cloudflare Worker que evita que los servicios en plan gratuito se duerman y publica cada ping como una página de estado pública.

2026En líneaPrivadoAutor único
TypeScriptTypeScriptCloudflare WorkersCloudflare WorkersReactReactViteVite

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.

Referencias