pnclPULSEObter acesso à API

NOTAS SOBRE ALERTAS DE QUEDA

Meça com quanto atraso seus alertas chegam

Todo alerta carrega um timestamp Unix. Compará-lo com a sua hora de recebimento revela a latência verdadeira do seu pipeline, e onde ela vaza.

Todo alerta de queda marca seu nascimento no campo alerted, em segundos Unix, como o guia de alertas de queda lista os campos do evento, verificado em 2026-10-08. Comparar essa marca com o momento em que o seu código vê o alerta te dá a latência ponta a ponta do seu caminho inteiro: a entrega do stream mais o seu processamento. Se você age sobre alertas, esse número vale ser medido, porque uma regra de limiar rápida num pipeline lento é uma regra lenta.

Os dois relógios em cada alerta

O campo alerted te diz quando o feed detectou a queda. Sua hora de recebimento, tomada no momento em que a linha é parseada, te diz quando você ficou sabendo. A diferença é o seu atraso total, e merece uma linha de log ou uma métrica por alerta, do mesmo jeito que você acompanharia qualquer outra figura de performance.

Um terceiro timestamp fica a jusante: quando a sua mensagem realmente posta no destino. A lacuna entre recebimento e postagem é o seu próprio processamento, e é a parte que você controla inteiramente.

Onde o atraso se esconde

Num relay bem construído o atraso deve ser pequeno e plano, mas três lugares adicionam segundos em silêncio. O loop de leitura: um cliente que bufferiza em vez de ler em stream segura alertas numa fila local enquanto a conexão parece aberta. O formatador: qualquer chamada síncrona no caminho da mensagem, uma busca, um template lento, se empilha sobre todo alerta atrás dele. O trabalhador do webhook: uma fila que drena devagar demais vira um backlog durante uma rodada cheia, e é por isso que o guia de relay mantém o POST fora do loop de leitura.

Meça por estágio e o estágio lento se nomeia sozinho.

O que observar ao longo de uma semana

Latência é uma distribuição, não uma média. Acompanhe o atraso típico e o pior minuto de cada dia, porque a cauda é o que te custa: um relay que é rápido às 3 da manhã e três segundos atrás durante uma rodada de sábado é um relay lento quando importa. Dias de partida e rodadas ao vivo são o teste de carga que você ganha de graça.

Se o atraso cresce com o volume de alertas, o gargalo está no seu código. Se é plano independentemente, você está lendo a cadência própria do stream, e esse é o número a conhecer.

Por que importa para as suas regras

Seus limiares e cooldowns assumem que o alerta que você vê é fresco. Um cooldown aplicado sobre um alerta de três minutos atrás é um cooldown gasto em história, e uma regra ajustada sobre alertas atrasados está ajustada sobre os dados errados. A medição fecha o ciclo: você só pode confiar no timing das suas regras se souber quando os alertas realmente chegaram.

O timestamp já está no alerta. Compare-o, registre-o, observe a cauda dele. Um pipeline que conhece o próprio atraso é o que pode se dar ao luxo de uma regra rápida.