pnclPULSEObter acesso à API

NOTAS SOBRE ALERTAS DE QUEDA

Mantenha seu leitor SSE rodando durante o fim de semana

O stream cuida das reconexões; o processo leitor precisa de cuidado próprio. Reinício, vigilante de silêncio, estado em disco e um alarme.

O stream SSE reconecta limpo quando a conexão cai, mas isso só cobre o fio. O processo que o segura pode morrer por razões próprias: um deploy, uma morte por falta de memória, uma reinicialização do host às 4 da manhã de sábado. Um leitor que sobrevive ao fim de semana precisa de quatro coisas: uma política de reinício, um vigilante de silêncio, estado em disco, e um alarme que funcione quando o próprio leitor está morto.

Planeje o reinício, não o uptime

Assuma que o processo vai sair e torne a saída barata. Um supervisor que reinicia o leitor com um atraso crescente, segundos primeiro, depois minutos, transforma uma queda num piscar. Na inicialização, retome do que você persistiu: o guia de configuração SSE nota que o estado das regras pertence ao servidor e que persistir o horário do último alerta processado permite ao reinício retomar limpo em vez de re-alertar movimentos já tratados, verificado em 2026-10-03.

O que um reinício não recupera é a lacuna em si: a documentação não promete ponto de retomada, então alertas que caíram enquanto você estava fora se perdem. A resposta do guia de configuração é preencher uma lacuna real a partir do endpoint REST de quedas, que guarda quedas recentes por algumas horas.

Observe o silêncio, não só as quedas

Um leitor pode estar rodando e não recebendo nada. Períodos quietos são normais, pré-jogo especialmente, então ausência de alertas não é prova de morte. O endpoint de saúde resolve: ele informa há quanto tempo o feed ao vivo escreveu pela última vez, e a regra do guia de configuração é fechar e reconectar quando essa idade continua crescendo enquanto sua conexão não diz nada.

Ligue essa checagem a um vigilante que registra sua decisão. A linha de log dizendo que o stream está em silêncio e a fonte está em silêncio é o que separa um mercado quieto de uma conexão travada num relance.

Mantenha a memória em disco

Tudo que o leitor lembra em RAM morre com o processo. As chaves de deduplicação, as janelas de cooldown e o timestamp do último alerta pertencem a um pequeno arquivo ou banco em disco, escritos conforme mudam. O guia de deduplicação cobre o armazenamento que sobrevive a reinícios; a versão de fim de semana desse conselho é que o armazenamento deve sobreviver também a uma reinicialização do host.

Alarme para o leitor que não consegue falar

Um leitor morto não consegue te mandar um alerta sobre si mesmo. A checagem tem que vir de fora: uma linha de heartbeat escrita a cada minuto, e um pequeno observador separado que te chama quando o heartbeat para durante horas com partidas. Esse observador é algumas linhas de agendador e uma requisição, e é a diferença entre notar um leitor morto na sexta à noite e na segunda de manhã.

Reinicie barato, observe o silêncio, mantenha a memória em disco, e deixe algo fora do processo fazer a preocupação. O stream fará a metade dele.