NOTAS DE CAPACIDADE
Quanto um dia de polling realmente move em dados
Requisições são só metade do volume. Um board completo pode reler 1.522 eventos por chamada enquanto um delta de cursor lê só sete.
O planejamento de capacidade conta requisições, e esse é o número certo para a manchete. Mas há um segundo volume que merece uma linha no caderno: quantos dados essas requisições realmente movem. A resposta varia em duas ordens de grandeza dependendo de um hábito, e decide se um dia de polling é um arredondamento ou uma linha de banda.
Os dois números de um poll
Toda requisição de board tem um custo de requisição, uma chamada contra a sua permissão de taxa, e um custo de payload, os bytes da resposta. O custo de requisição é fixado pelo seu cronograma. O custo de payload é definido por quanto do board você pede de novo.
O guia de polling REST traz o contraste documentado, verificado em 2026-10-27: um board completo de pré-jogo de futebol pode retornar 1.522 eventos, enquanto a leitura delta depois de um minuto quieto retornou 7 eventos alterados. Mesmo endpoint, mesmo cronograma, e a diferença de payload é a diferença entre reler uma biblioteca e ler um bilhete.
Como é um dia de cada um
Faça a aritmética num board de pré-jogo estável, uma chamada a cada 30 segundos sem parar: 2.880 leituras por dia. Feitas como snapshots completos, isso dá na ordem de 4,4 milhões de payloads de evento por dia, os mesmos mil e poucos eventos relidos quase três mil vezes. Feitas como deltas de cursor na proporção documentada de minuto quieto, são dezenas de milhares de payloads, concentrados perto do fechamento, quando os preços de fato se movem.
Nenhum dos números vai incomodar uma conexão moderna. Mas o maior incomoda tudo o que vem depois: o parser reprocessa eventos que não mudaram, o armazenamento deduplica linhas que nunca foram novas, e os gráficos de monitoramento gastam sua faixa em ruído. O volume de payload é a sombra do volume de requisições, e cai sobre cada estágio depois do fetch.
O cursor é o orçamento de payload
O cursor since costuma ser apresentado como recurso de frescor ou gentileza com a API. Também é o seu controle de volume de dados. Um poller que persiste o cursor e retoma dele pede só o que mudou, e um dia de mudanças é pequeno mesmo num board movimentado, porque a maioria dos eventos fica parada a maior parte do tempo.
A regra prática: snapshots completos são para a primeira inicialização e para reconstrução depois de perda de estado, como o guia de polling os enquadra, e leituras delta são para tudo no meio. Se os seus logs mostram respostas de board completo em regime permanente, o seu volume de dados é cerca de duzentas vezes o necessário, e a correção não custa nada além do cursor que você já recebe de volta.
Quando o payload ainda importa
O polling delta encolhe o dia estável, não o excepcional. Os minutos antes dos inícios de uma grande rodada mudam a maior parte do board, então os deltas crescem até o tamanho do board completo exatamente quando você mais se importa. Dimensione banda e tempo de parse para a hora cheia, não para a média, e deixe as horas quietas serem a economia.
Conte requisições para o plano, conte payloads para o pipeline. O cursor mantém os dois pequenos, e o dia fica barato nas duas moedas.