clio

Clio es una herramienta de analítica diseñada para flotas de repositorios GitHub que opera en la capa edge de Cloudflare mediante Workers y D1. Su valor principal radica en capturar datos históricos de tráfico (vistas, clonados) antes de que GitHub los elimine tras 14 días, permitiendo series temporales a largo plazo sin costes de infraestructura. La arquitectura se basa en un cron que ejecuta fragmentos del trabajo para respetar los límites de subpeticiones del plan gratuito, almacenando datos en una base de datos D1 y sirviendo un dashboard con gráficos SVG generados en el lado del servidor.

Sus casos de uso principales incluyen la monitorización de flotas de repositorios públicos y privados, la detección de repositorios inactivos mediante métricas de antigüedad, el análisis de tendencias de clonación versus visualización para entender la adopción real frente al ruido de automatizaciones, y la integración con PyPI para correlacionar descargas de paquetes con actividad en código fuente. Los puntos fuertes verificables son su funcionamiento sin costes operativos utilizando exclusivamente el plan gratuito de Cloudflare, la persistencia de datos históricos más allá del límite de 14 días de GitHub Insights, la generación de gráficos SVG inline que no dependen de librerías externas ni CDNs, y la capacidad de segmentar la recolección de datos para evitar exceder los límites de subpeticiones por invocación.

Las limitaciones técnicas incluyen la ausencia de alertas automáticas nativas que requieran configuración externa como webhooks, la retención limitada de 24 horas para los registros de acceso a través de Zero Trust, y la dependencia del límite estricto de 50 subpeticiones externas por invocación en el plan gratuito que obliga a procesar flotas grandes en múltiples ejecuciones cron. Además, la generación de gráficos está limitada por un presupuesto de CPU de 10 ms por invocación, lo que impide renderizar paneles complejos o ventanas temporales excesivamente amplias sin errores de tiempo de ejecución.