NOTAS DE CAPACIDAD
Cuotas viejas: pregunta al feed antes que a tus registros
Un incidente de frescura empieza con una pregunta: de quién es el reloj que se paró. Los endpoints de salud del feed lo responden en una solicitud cada uno.
Tu panel muestra cuotas viejas y el instinto es abrir tus propios registros. Aguanta ese instinto cinco minutos. La primera pregunta en cualquier incidente de frescura es de quién es el reloj que se paró, tuyo o del feed, y el feed lo responde directamente. Depurar tu propio pipeline antes de preguntar es cómo un tropiezo del proveedor se convierte en una tarde desperdiciada.
Pregunta al feed antes que a tus registros
Dos endpoints de estado existen exactamente para ese momento, como documenta la guía de health check, verificado el 2026-10-30. Un /ping público devuelve un simple ok para sondas que no pueden autenticarse. Un /health autenticado devuelve el estado operativo de ambos feeds: status, live_write_age_ms, la fuente que está llevando los datos en vivo ahora mismo, y un campo version que es el mismo cursor que tus endpoints de tablero devuelven como last.
Una solicitud cada uno, y la llamada a /health cuenta contra tu plan como cualquier otra, así que una vez por minuto por entorno es la cadencia correcta.
Lee la respuesta entera, no la primera línea
Los campos de nivel superior describen el feed en vivo. El servicio de prepartido es un objeto anidado con su propio status, edad de escritura y version, y el status superior no cambia por un problema de prepartido. Un monitor que solo lee el campo superior está ciego a la mitad del feed.
Dos trampas importan en un incidente. Un status de prepartido unreachable significa que el propio health check no pudo alcanzar ese servicio: trátalo como desconocido, no como caído. Y las edades de escritura normalmente quedan bien por debajo de un segundo, así que una lectura en las decenas de miles de milisegundos ya es una historia, diga lo que diga el campo status.
La comparación de cursores zanja la culpa
El campo más fuerte de la respuesta es version, porque es comparable. Tu poller guarda el cursor de su última lectura. Si el version del feed coincide con tu cursor guardado, el feed no te ha adelantado: el estancamiento es tuyo. Si el version del feed va por delante y sigue escribiendo, el feed está vivo y tu pipeline es el que no está leyendo.
Esa única comparación reemplaza toda la fase especulativa del incidente. Sin adivinar despliegues, sin releer tu parser. O el feed paró, o tu lado paró, y el cursor dice cuál.
Cuando el feed de verdad está degradado
Una lectura degradada es razón para aguantar, no para martillear. Sigue sirviendo tu último snapshot bueno con su edad visible, amplía tu intervalo de sondeo para no sumar carga mientras el feed se recupera, y deja que el presupuesto de frescura dispare tus propias alertas en lugar del bucle de errores.
La guía de monitorización de pipeline cubre las métricas del lado del consumidor que vigilan el resto del incidente: edad del snapshot en tu lado, progreso del cursor, tasas de error. Los endpoints de salud responden a la pregunta previa que esas métricas no pueden: si el problema está corriente arriba de todo lo que tú controlas.
Cinco minutos, dos endpoints, una comparación de cursores. Depura en ese orden y la mayoría de los incidentes de frescura terminan antes de abrir tus propios registros.