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.