Monitorizar integrações: alerte para o silêncio, não apenas para os erros

Uma exceção é registada, um alerta dispara, alguém corrige. Esse ciclo funciona - para falhas suficientemente ruidosas para se anunciarem a si próprias. As falhas que custam dinheiro a sério aos nossos clientes são as silenciosas: o fornecedor rodou silenciosamente uma chave SFTP, a exportação noturna produziu um ficheiro válido com zero linhas, o consumidor da fila está «em execução» mas não processa nada.

Nada gerou erro. Tudo parou.

Métricas de fluxo, não apenas verificações de saúde

Uma verificação de saúde (health check) responde a «o processo está vivo?». A pergunta que importa é «o trabalho aconteceu?». Por isso, o sinal primário em cada integração que operamos é uma métrica de fluxo - registos por intervalo, comparados com o que esse intervalo normalmente transporta:

• Encomendas sincronizadas por hora, com valores de referência para dias úteis/fim de semana - um domingo calmo é normal; uma terça-feira calma às 10:00 é um incidente.
• A chegada de ficheiros tratada como prazo, não como evento: «o ficheiro de preços do parceiro X é esperado até às 06:30» - o alerta dispara quando não chega.
• Atraso de ponta a ponta, medido desde o timestamp de origem até ao commit no destino, e não a partir da entrada na fila.

O problema das zero linhas

Menção especial para a falha silenciosa mais comum que vemos: uma tarefa agendada que é bem-sucedida com um resultado vazio. A montante, alguém alterou um filtro, uma credencial perdeu o acesso de leitura a uma tabela, um erro na janela de datas excluiu tudo - e a tarefa termina com código 0, tudo verde.

Todas as extrações que entregamos têm um limiar de plausibilidade: a menor dimensão de resultado que alguma vez foi legítima para essa tarefa e esse contexto de calendário. Abaixo do limiar, a execução é retida e pergunta-se a um humano: «isto produziu 0 linhas; as últimas 90 terças-feiras tiveram uma média de 4.200 - avançar?». Esta única salvaguarda já apanhou mais incidentes reais do que todos os nossos alertas de exceção juntos.

O silêncio é um sinal. Instrumente-o deliberadamente, porque ele nunca se vai anunciar sozinho.