pnclPULSEObter acesso à API

NOTAS SOBRE ALERTAS DE QUEDA

Registre cada decisão de alerta, não só cada alerta

O log de alertas diz o que chegou; o log de decisões diz o que suas regras fizeram sobre isso. O segundo log é o que afina o sistema.

A maioria dos setups de alerta registra o que chegou: o alerta, talvez a mensagem que saiu. Esse log consegue te dizer que o stream estava vivo, mas não consegue responder à pergunta que importa depois de um mês: minhas regras são boas? A resposta mora num segundo log, uma linha por decisão, que registra o que suas regras fizeram com cada alerta e por quê.

O que um registro de decisão guarda

Uma linha compacta por alerta, escrita passe ou não: o id do alerta, a regra que o julgou, o veredito, e a razão numa palavra. As chaves do guia de deduplicação tornam o lado da identidade fácil: a chave do alerta te diz que é o mesmo alerta, e o seu veredito te diz o que o seu pipeline escolheu. Uma linha de decisão fica assim: id, regra, passa ou descarta, razão, e o preço justo se importou.

A palavra da razão é o truque inteiro. Falha-de-limiar, duplicado, cooldown, filtro-de-nível, passou: cinco razões cobrem quase todo pipeline, e transformam um log num relatório.

O que o log de decisões responde

Depois de uma semana, agrupe por razão. Uma enxurrada de falha-de-limiar significa que o limiar do seu stream é generoso e o seu código faz a filtragem, o que é tranquilo, mas vale saber. Uma enxurrada de duplicado significa que o mesmo movimento alerta repetidamente e a sua deduplicação está merecendo o lugar. Uma regra com zero aprovações numa semana é peso morto ou está quebrada, e o log é a única coisa que consegue distinguir as duas.

O guia de deduplicação termina com a mesma postura: meça o efeito. O log de decisões é o instrumento que o mede.

As duas taxas para observar

Duas razões fazem a maior parte da leitura. A taxa de aprovação: decisões que passam, divididas pelos alertas recebidos, por regra. E a taxa de colapso: alertas que entram, divididos pelas mensagens que saem. Um pipeline pré-jogo saudável pode colapsar vinte alertas em três mensagens; um ao vivo saudável, menos. Quando qualquer uma das razões deriva, algo mudou, e o log de decisões te diz qual regra se moveu.

Acompanhe-as por esporte e por fase, porque um único número misturado esconde o único esporte que está te inundando.

Mantenha pequeno

O log de decisões é uma linha por alerta, algumas dezenas de bytes, então fica barato mesmo numa semana cheia. Escreva-o ao lado do relay, gire-o semanalmente, e revise-o antes de cada mudança de limiar. O guia de alertas de queda cobre a escolha dos limiares; o log de decisões é como você os mantém bem escolhidos.

Chegadas te dizem que o stream funcionou. Decisões te dizem que as regras funcionaram. Registre a segunda, e a primeira vira evidência em vez de ruído.