NOTAS DE CAPACIDADE
Quando um ciclo de poll ultrapassa o intervalo
Um ciclo lento que se enfileira atrás de si mesmo paga por dados velhos para sempre. Pule o tique atrasado, registre o pulo, e deixe o cursor cobrir a lacuna.
Um intervalo de 30 segundos pressupõe um ciclo que leva segundos. Aí chega um sábado grande, os boards ficam mais pesados, o parser desacelera, e um ciclo começa a levar 40 segundos. O seu loop agora está dez segundos atrasado a cada ciclo, para sempre, a menos que você tenha decidido com antecedência o que ciclos sobrepostos devem fazer. Essa decisão é o post inteiro, e é mais barata do que parece.
Meça o ciclo antes que importe
Registre a duração de cada ciclo de poll: quando começou, quando terminou, quantos boards cobriu. O número que importa é o tempo de ciclo p95 contra o seu intervalo, e o guia de monitoramento de pipeline é onde essas métricas de loop pertencem, verificado em 2026-11-06. Um ciclo com média de 5 segundos contra um intervalo de 30 é invisível até o dia em que deixa de ser.
Os ciclos crescem por razões próprias: rodadas maiores significam deltas maiores, e uma rede lenta ou um parser frio adiciona segundos sem pedir. O intervalo fica plano enquanto o trabalho infla, então o dia em que os dois se cruzam sempre chega sem avisar.
Pule, não enfileire
Quando um ciclo atrasa, o próximo já está atrasado, e o instinto errado é deixar que se empilhem. Uma fila de ciclos atrasados é uma fila de trabalho velho: cada um paga por dados mais velhos que os do ciclo seguinte, e o backlog escoa na velocidade do problema que o causou.
A regra limpa é pular e registrar. Se um ciclo ainda está rodando quando o próximo tique chega, marque o tique como pulado, deixe o ciclo corrente terminar, e retome no tique seguinte. O cursor torna isso seguro: a próxima leitura bem-sucedida cobre tudo o que a pulada cobriria, porque o cursor since só avança quando uma leitura se completa.
Quando ciclos lentos viram o normal
Um estouro ocasional na maior rodada da semana é uma nota de rodapé de agendamento. Um ciclo que ultrapassa o intervalo todo dia é o desenho dizendo que o intervalo não cabe mais no trabalho: alargue o intervalo, divida os boards entre mais workers, ou tire a parte pesada do ciclo, como o guia de planejamento de capacidade enquadra a troca intervalo-custo, verificado em 2026-11-06.
A distinção importa porque as correções não se misturam. Um pico raro precisa da regra de pulo. Um estouro crônico precisa de um intervalo maior ou um escopo menor, e nenhuma lógica de pulo faz um trabalho de 40 segundos caber num orçamento de 30.
A guarda de cinco linhas
A implementação é pequena: uma flag de reentrância no ciclo, um contador de tiques pulados, e uma linha de log quando o contador se move. O contador ao longo de uma semana é a métrica de saúde; uma tendência diferente de zero é o aviso mais cedo que o seu intervalo vai te dar.
Ciclos que terminam cedo são de graça. Ciclos que terminam tarde são uma fila que você escolheu não construir. Escreva a regra de pulo uma vez e o intervalo volta a ser uma promessa.