La frescura de los datos es hace cuánto se recolectaron de verdad los datos que estás leyendo. Para cualquier cosa que cambie, importa más que la disponibilidad — y es la medida que casi ninguna página de estado publica.
El uptime es la pregunta equivocada
Un recolector puede devolver HTTP 200 durante días sin recolectar nada. Todas las comprobaciones de salud pasan, el panel está en verde, y los números son de la semana pasada.
| Medida | Responde | Detecta un recolector parado |
|---|---|---|
| Uptime | ¿Responde el servicio? | No |
| Frescura | ¿Cuándo llegaron datos por última vez? | Sí |
Por eso nuestra página de estado publica las horas transcurridas desde la última recolección correcta de cada fuente y nunca se guarda en caché, en lugar de mostrar un porcentaje de uptime. Una insignia de uptime en un producto de datos no significa casi nada — es un fallo silencioso a nivel de sistema.
En caché no es rancio
Dos cosas distintas reciben la misma palabra:
- En caché — la respuesta se recolectó hace poco y se está reutilizando. Conoces su edad, y la edad es pequeña.
- Rancio — la respuesta es más antigua de lo que debería, normalmente porque falló una recolección nueva.
Una buena API te dice cuál de las dos recibiste. La nuestra devuelve una marca cached en cada respuesta, para que quien llama pueda distinguir un acierto de caché de 50 milisegundos de una lectura en vivo sin adivinarlo por la latencia.
Servir datos rancios a propósito
Cuando una fuente bloquea una lectura nueva hay dos opciones honestas: devolver un error, o devolver el último valor bueno y decir qué antigüedad tiene. Servir calladamente datos viejos como si fueran actuales es la tercera opción, la deshonesta, y es habitual.
Nosotros tomamos la segunda vía solo cuando quien llama lo pide, con una cabecera explícita que dice cuánta antigüedad va a aceptar — porque si un número de seguidores de hace cuatro horas sirve o no depende enteramente de lo que quien llama vaya a hacer con él, y eso lo sabe esa persona y no nosotros.
La frescura es lo que hace comparable una serie
Para una serie temporal la exigencia es más estricta que "reciente". Cada punto tiene que recolectarse con la misma cadencia, o los huecos se vuelven indistinguibles de un cambio real. Un archivo horario al que le falta una hora no es un archivo horario, y por eso registramos las ventanas que no devolvieron nada aparte de las ventanas que dieron error — visible fuente por fuente en fuentes.