Resposta direta
Toda integração precisa de um sinal que exista independente do sistema que falhou. Na prática, cada troca de dados deve deixar registro com horário, quantidade esperada e resultado, e alguém precisa ser avisado quando a contagem não fecha ou quando o registro deixou de aparecer. O aviso existe para indicar ausência de evento, não apenas erro. Erro o sistema costuma mostrar; ausência de dado ele trata como normal. Separar quem observa de quem corrige evita que o alerta se perca na rotina de quem já tem outra função.
- Objetivo
- Orientar implementação
- Formato indicado
- Projeto de implementação
- Atualizado em
O que esta página acrescenta: Trata o aviso por ausência de evento e a separação entre quem observa e quem corrige, pontos que as demais páginas do tema não cobrem.
O que o aviso precisa conter
Um aviso útil carrega quatro informações: qual fluxo falhou, quando era esperado, o que foi recebido e quem é o dono daquele fluxo. Sem essas quatro, o alerta chega e não gera ação, porque ninguém sabe se é atraso, duplicidade ou parada total.
Além do erro declarado, o registro precisa cobrir ausência. Uma integração que simplesmente não envia nada não retorna erro; ela fica em silêncio. O sinal que detecta esse caso é a comparação entre o que era esperado no período e o que de fato chegou.
Quem recebe o aviso e quem corrige
Observar e corrigir são funções diferentes. Quem monitora pode ser uma pessoa de operação com rotina definida de conferência; quem corrige costuma estar no time que mantém o sistema de origem ou o próprio fluxo de dados. Quando as duas funções ficam na mesma pessoa, o alerta compete com o trabalho do dia e tende a ser adiado.
Cada fluxo precisa de um nome de responsável, uma ordem de acionamento quando o primeiro não responde e um critério claro de escalonamento. Esse critério é o que separa um aviso de um ruído: só escala o que passa do limite acordado para aquele fluxo.
O que o aviso não cobre
Alerta de integração não detecta dado errado que chegou completo e no formato certo. Cadastro trocado, data plausível e incorreta ou valor dentro da faixa esperada passam por qualquer verificação de volume e horário.
Também não resolve mudança de regra de negócio que altera o que deveria chegar, nem substitui conferência periódica com amostra. Se o aviso dispara demais, as pessoas deixam de olhar, e o mecanismo perde valor justamente quando passa a funcionar.
Recurso prático
Pontos de observação e o que cada um precisa avisar
| Ponto de observação | O que precisa ser avisado |
|---|---|
| Última execução bem-sucedida | Aviso quando o intervalo desde a última execução passa do previsto para aquele fluxo |
| Quantidade de registros por lote | Aviso quando o número sai da faixa habitual ou fica zerado sem motivo declarado |
| Evento esperado que não chegou | Aviso quando um tipo de registro previsto no período não aparece no destino |
O ponto mais ignorado é o aviso por ausência: sem ele, o alerta só dispara depois que a operação já sentiu o problema, e o erro declarado acaba sendo o único caso monitorado.
Conceitos usados nesta página
- Registro de execução — Registro de execução é a evidência de que uma rotina, automação ou tarefa rodou — com identificador, data, insumo, resultado e responsável.
Sobre o que está escrito aqui
Conceitos relacionados: aviso por ausência de evento · conferência de lote · responsável de fluxo · log de execução · limite de tolerância. Exemplos são ilustrativos. Não há cliente, resultado, preço, prazo ou certificação nesta página. Quando o formato indicado é Projeto de implementação, ele descreve uma possibilidade de trabalho — a conversa inicial avalia contexto e aderência.
Para continuar
- Integrações, sistemas e qualidade de dados — Página central do tema
- Números que não batem: por que a divergência… — planilhas divergentes
- Falhas silenciosas em integrações: como perce… — falhas silenciosas
Páginas relacionadas
O mesmo problema em outro objetivo
- Integração parou sem avisar: como achar quando e onde — Diagnosticar
- Falha de integração sem aviso: o que comparar nas respostas — Comparar alternativas
- Falha de integração sem aviso: o que acordar antes de assinar — Orientar avaliação e contratação
Outras leituras em Integrações, sistemas e qualidade de dados
- Log de integração sem nível de erro: o que medir na saída — A página define sinais substitutos ao nível de erro, como contagem, atraso e conciliação, para avaliar a integração pelo que o log registra.
- Migração: comparar corte único, etapas e paralelo — Compara corte único, migração por etapas e operação em paralelo por interrupção, conferência, responsabilidade e dado que não pode ser recriado.
- Integração sem documentação: por onde reconstruir o contrato — Integração que funciona sem documentação: reconstruir o contrato pelos dados, definir responsável e controlar cada mudança.
- Falha na sincronização: como medir o monitoramento — Como medir o monitoramento de falha na sincronização: cobertura, defasagem do aviso e falso positivo, e o que registrar antes de confiar nos números.
- Integração sem monitoramento: o que verificar primeiro — Como levantar o estado real de uma integração sem monitoramento: onde olhar, o que registrar e quais sinais indicam risco de falha.