Resposta curta: as visualizações em tempo real atualizam em menos de 5 segundos. Os relatórios pré-agregados (painel principal, distribuição geográfica, tabelas das páginas mais vistas) atualizam em ciclo de 1-2 minutos.
Detalhamento completo de tempos
| Superfície | Atraso típico | Por quê |
|---|---|---|
| Aba Live | < 5 segundos | Consulta o endpoint de visitantes ativos a cada ~5 segundos |
| Globo 3D | < 5 segundos | Streamed via Supabase Realtime sobre WebSocket |
| Contador de visitantes (cabeçalho) | < 10 segundos | Cloudflare KV com TTL curto |
| Gráficos do painel principal | 1-2 minutos | Pré-agregados para velocidade de consulta |
| Top páginas / fontes / países | 1-2 minutos | Pré-agregados |
| Totais diários (analytics_daily) | até 5 minutos | Agregados em job de janela curta |
| Gráficos de retenção / coorte | 5-15 minutos | Mais caros; calculados em ciclo mais lento |
| Exportação CSV / JSON | até 15 minutos | Puxa do rollup mais recente |
O que «tempo real» significa na prática
Quando o tracker dispara track no navegador de um visitante, a requisição chega aos Cloudflare Workers em 50-100 ms (POP de borda mais próximo), é validada e encaminhada para o banco de dados primário na UE, e aparece nas suas superfícies em tempo real em poucos segundos.
É por isso que a aba Live e o globo 3D parecem instantâneos. O globo assina diretamente o stream do banco via Supabase Realtime, enquanto a aba Live atualiza sua lista de visitantes ativos a cada poucos segundos.
Por que os gráficos principais têm atraso de 1-2 minutos
Gráficos como «Pageviews nas últimas 24h» não rodam um scan completo da tabela toda vez que você carrega o painel. Em vez disso, um pequeno job em segundo plano agrega os eventos em buckets de tempo pré-calculados a cada 1-2 minutos. Isso torna o painel rápido mesmo para sites com milhões de eventos mensais — ao custo de um pequeno atraso.
Se você quiser verificar que um evento totalmente novo chegou, observe a aba Live, não os gráficos principais.
Quando você deve esperar mais de 2 minutos
Algumas razões legítimas para atrasos maiores:
- Combinações pesadas de filtros — aplicar 5+ filtros pode cair para uma consulta direta, mais lenta que pré-agregada.
- Intervalos de data personalizados que incluem «agora» — alguns seletores de data re-agregam em tempo real.
- Relatórios de retenção e coorte — são calculados em cadência de 5-15 minutos por design.
- Visitantes recentemente identificados — a ligação entre uma sessão anônima e um usuário logado é processada de forma assíncrona e pode levar até um minuto.
Solução de problemas
Se o seu evento ainda não apareceu após 5 minutos na aba Live, o problema provavelmente está na instalação (script não carregando, bloqueador de anúncios, código de rastreamento errado) — consulte Primeiro evento não aparece e Verificar sua instalação.