pnclENGINEObter acesso à API

NOTAS DE CAPACIDADE

Seu pipeline roda no seu relógio: mantenha-o honesto

Idade de snapshot, captura de fechamento e backoff confiam no relógio do seu servidor. Como medir a deriva contra o feed e mantê-la abaixo de um segundo.

Seu pipeline de odds é uma máquina dirigida por relógio. A métrica de idade do snapshot que te diz que um board está velho, o trabalho de captura de fechamento que marca o último preço pré-jogo, até o backoff que espera um 429: todos confiam no relógio do seu servidor. Se esse relógio deriva, todo julgamento baseado em tempo deriva junto, em silêncio. Manter o relógio honesto é uma configuração de cinco minutos com uma checagem mensurável.

Onde o relógio morde

O guia de monitoramento computa a idade do snapshot como segundos desde o último poll válido, e o guia de armazenamento guarda o observed_at de cada mudança de preço. Um relógio dois minutos atrasado reporta um board fresco como velho; um relógio dois minutos adiantado marca o fechamento cedo. Nenhum dos dois lança erro. Ambos corrompem os registros em que o seu eu futuro vai confiar.

A pior parte é o silêncio: relógios desviados não falham nada, então só te falham em retrospectiva.

Meça a deriva contra o feed

Toda resposta HTTP carrega o cabeçalho Date do servidor, então todo poll é uma checagem de relógio gratuita. Faça parse do cabeçalho, compare com a sua hora local, e registre a diferença:

from email.utils import parsedate_to_datetime
from datetime import datetime, timezone

server = parsedate_to_datetime(r.headers["Date"])
skew = (datetime.now(timezone.utc) - server).total_seconds()

Abaixo de um segundo de deriva, esqueça. Acima de alguns segundos, conserte o relógio antes de confiar nos timestamps do pipeline, porque a matemática de frescor a jusante assume que as duas pontas concordam sobre o que é agora.

Conserte uma vez, depois observe

NTP é a correção: um relógio de sistema sincronizado deriva por milissegundos, não minutos. Adicione a leitura de deriva às suas checagens de saúde, ao lado das métricas de pipeline que você já acompanha, e alerte quando passar de um ou dois segundos. A própria postura do guia de monitoramento se aplica: meça o número, alerte no limiar, nunca avalie de olho.

Em contêineres e VPS pequenos, a disciplina de relógio é a primeira coisa a quebrar depois de uma suspensão ou uma pausa longa, e é por isso que a checagem de deriva pertence ao pipeline, não a uma página de wiki.

Por que importa para o fechamento

O preço de fechamento é a última linha pré-jogo antes do início, e um relógio adiantado ou atrasado move o fechamento. Um pipeline que se avalia contra fechamentos, como os fluxos de CLV nos outros sites desta rede fazem, herda o erro diretamente. Um segundo de precisão de relógio é barato; um fechamento mal rotulado é para sempre.

Sincronize o relógio, meça a deriva em cada poll, alerte além de um segundo. Assim todo timestamp no seu armazenamento significa o que diz.