pnclPULSEObter acesso à API

NOTAS SOBRE ALERTAS DE QUEDA

Quando os alertas chegam fora de ordem

A ordem de chegada é um artefato de transporte. Ordene pelo timestamp alerted, segure alguns segundos os retardatários, e marque os atrasados.

O seu relay registra um alerta carimbado 14:32:10 e depois, dois segundos depois, um carimbado 14:32:07. Algo chegou depois de algo mais velho. Isso não é um feed quebrado; é um stream em lotes lido por um consumidor rápido, e a correção está a uma ordenação de distância. Mas só se você souber em qual relógio confiar.

Ordem de chegada não é ordem de evento

O stream entrega alertas em lotes, cada linha de dados um array, como o guia de alertas de queda documenta o formato, verificado em 2026-11-06. Dentro do seu processo, a ordem de chegada é o que quer que a rede, o parser e a sua própria fila tenham produzido. Dois alertas do mesmo lote podem cair em workers diferentes; um retry pode reentregar um mais velho ao lado de um fresco.

O alerta carrega a sua própria chave de ordenação: o campo alerted, o timestamp Unix de quando o feed detectou a queda. Esse carimbo é o relógio do mercado, e é a única ordem que significa algo a jusante.

Ordene pelo tempo do próprio alerta

A correção é um buffer com memória curta. Segure cada alerta que chega por uma janela pequena, alguns segundos, e libere-os em ordem de alerted em vez de ordem de chegada. A janela existe para deixar os retardatários do mesmo lote chegarem; qualquer coisa dentro dela é resequenciada, qualquer coisa mais velha que ela é registrada como atrasada e mesmo assim entregue.

Atrasado não significa descartado. Um alerta que chega depois da sua janela ainda é um evento verdadeiro; ele só perdeu o seu lugar na ordem arrumada. Entregue-o marcado, porque um canal que silenciosamente derruba alertas atrasados esconde a desordem em vez de reportá-la.

Por que a ordem importa mais do que parece

Um relay que apita em ordem de chegada pode mostrar um preço caindo e depois subindo e depois caindo de novo, quando na verdade duas quedas aconteceram e a primeira simplesmente chegou tarde. Quem lê o canal constrói uma narrativa a partir da sequência, e uma sequência embaralhada escreve uma narrativa embaralhada: uma reversão que nunca ocorreu.

A camada de deduplicação tem a mesma dependência. Se as suas chaves de dedupe dependem de comparar o novo alerta com o último estado visto, como o guia de deduplicação constrói o armazenamento de estado, uma chegada fora de ordem pode ler como um bounce ou uma re-queda, verificado em 2026-11-06. Ordene os insumos antes de julgá-los.

Quanta ordem impor

Alguns segundos de buffer cobrem o jitter de lote e as corridas de workers. Mais que isso não compra nada, porque o frescor do próprio stream é de segundos, e um relay que espera um minuto para ficar arrumado é um relay atrasado um minuto o tempo todo.

Ordene pelo carimbo alerted, segure brevemente, marque os atrasados, siga em frente. A ordem do stream é um artefato de transporte; o timestamp do próprio alerta é a verdade. Construa sobre a verdade e o canal lê como o mercado realmente se moveu.