Respuesta corta: las vistas en tiempo real se actualizan en menos de 5 segundos. Los informes pre-agregados (el panel principal, el desglose geográfico, las tablas de páginas más vistas) se refrescan en un ciclo de 1-2 minutos.
Desglose completo de tiempos
| Superficie | Retraso típico | Por qué |
|---|---|---|
| Pestaña Live | < 5 segundos | Sondea el endpoint de visitantes activos aproximadamente cada 5 segundos |
| Globo 3D | < 5 segundos | Streamed vía Supabase Realtime sobre WebSocket |
| Contador de visitantes (cabecera) | < 10 segundos | Cloudflare KV con TTL corto |
| Gráficos del panel principal | 1-2 minutos | Pre-agregados para velocidad de consulta |
| Top páginas / fuentes / países | 1-2 minutos | Pre-agregados |
| Totales diarios (analytics_daily) | hasta 5 minutos | Agregados en una tarea de ventana corta |
| Gráficos de retención / cohorte | 5-15 minutos | Más costosos; computados con un ciclo más lento |
| Exportación CSV / JSON | hasta 15 minutos | Tira del rollup más reciente |
Qué significa «tiempo real» en la práctica
Cuando el tracker dispara track en el navegador de un visitante, la solicitud llega a Cloudflare Workers en 50-100 ms (POP edge más cercano), se valida y se reenvía a la base de datos primaria de la UE, y aparece en tus superficies en directo en pocos segundos.
Por eso la pestaña Live y el globo 3D se sienten instantáneos. El globo se suscribe directamente al stream de la base de datos a través de Supabase Realtime, mientras que la pestaña Live actualiza su lista de visitantes activos cada pocos segundos.
Por qué los gráficos principales tienen un retraso de 1-2 minutos
Gráficos como «Páginas vistas en las últimas 24h» no ejecutan un escaneo completo cada vez que cargas el panel. En su lugar, una pequeña tarea en segundo plano agrega los eventos en buckets de tiempo precomputados cada 1-2 minutos. Esto hace que el panel sea rápido incluso para sitios con millones de eventos mensuales — al precio de un pequeño retraso.
Si quieres verificar que un evento recién creado ha llegado, observa la pestaña Live, no los gráficos principales.
Cuándo deberías esperar más de 2 minutos
Algunas razones legítimas de retrasos más largos:
- Combinaciones pesadas de filtros — aplicar 5+ filtros puede caer a una consulta directa, que es más lenta que pre-agregada.
- Rangos de fecha personalizados que incluyen «ahora» — algunos selectores de fecha re-agregan al vuelo.
- Informes de retención y cohorte — se computan con cadencia de 5-15 minutos por diseño.
- Visitantes recientemente identificados — el enlace entre una sesión anónima y un usuario logueado se procesa de forma asíncrona y puede tardar hasta un minuto.
Solución de problemas
Si tu evento aún no ha aparecido tras 5 minutos en la pestaña Live, lo más probable es que el problema esté en la instalación (script que no carga, bloqueador de anuncios, código de seguimiento incorrecto) — consulta El primer evento no aparece y Verificar la instalación.