Resposta direta
A resposta está no registro de execução, não no alerta que não chegou. Quando nenhum aviso é disparado, o processo provavelmente terminou sem erro aparente ou não foi iniciado. A comparação entre a última entrega bem-sucedida e a primeira ausência delimita o intervalo a reconstruir. Contar registros que deveriam ter passado e os que de fato chegaram, por período, dimensiona a lacuna. Em seguida, cabe identificar quem depende daquele dado e o que foi decidido enquanto ele faltava. O alerta vem depois, construído sobre o que a investigação mostrou.
- Objetivo
- Diagnosticar
- Formato indicado
- Projeto de implementação
- Atualizado em
O que esta página acrescenta: Reconstrói a falha pelo intervalo entre a última entrega e a primeira ausência, sem depender de monitoramento prévio.
Por que o alerta não vem
Uma integração costuma avisar quando encontra erro. Ela não avisa quando termina sem encontrar nada. Se o arquivo de origem veio vazio, se o filtro não retornou linhas, se o processo rodou mas gravou zero registros, a execução encerra como concluída. Nada é disparado porque, do ponto de vista do sistema, não houve falha.
Há também o caso em que o processo nem chega a rodar: a credencial expira, a janela de execução é pulada, o agendamento fica desativado. Sem monitoramento do próprio agendamento, a ausência de execução se confunde com execução sem novidade.
O que a investigação consegue mostrar
A evidência está nos registros de execução e nas marcas de tempo dos dados. A última entrega bem-sucedida e a primeira ausência delimitam o intervalo. Dentro dele, a contagem de registros por período separa o que passou do que não passou.
A investigação também mostra a consequência: quais relatórios, cobranças ou decisões foram feitos com o dado incompleto. Esse levantamento costuma pesar mais que o defeito técnico, porque define o que precisa ser refeito.
O que esse método não resolve
Reconstruir a lacuna não recupera o dado que nunca foi gerado na origem. Se o registro não existiu no sistema de partida, nenhuma comparação vai encontrá-lo no destino.
A investigação também não substitui o monitoramento contínuo. Ela explica o que já aconteceu e não avisa sobre a próxima falha. E depende de existir algum vestígio em algum lugar: onde não há log nem marca de tempo, a reconstrução para no ponto em que os rastros acabam.
Recurso prático
Reconstruir a lacuna de uma integração sem alerta
- Localizar a última execução registrada como bem-sucedida e a primeira execução esperada sem qualquer registro.
- Contar, por período, os registros que deveriam ter sido transferidos e os que chegaram ao destino.
- Comparar os dois números para dimensionar a lacuna e listar quais registros ficaram de fora.
- Identificar os processos e as decisões que usaram o dado incompleto durante o intervalo.
- Definir qual verificação passa a rodar a cada execução e quem recebe o aviso quando ela falha.
O erro comum é tratar a ausência de erro como sucesso: processo que termina sem exceção e não transfere nada passa como execução normal.
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: registro de execução · intervalo de falha · contagem de registros por período · reconciliação retroativa. 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
- Bases copiadas sem versão: como medir a dispe… — cópia de base sem controle de versão
- Cópia de base sem versão: o que exigir na con… — cópia de base sem controle de versão
Páginas relacionadas
O mesmo problema em outro objetivo
- Falha de integração sem aviso: o que comparar nas respostas — Comparar alternativas
- Falha de integração sem aviso: como montar o alerta — Orientar implementação
- 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
- Integração que roda sozinha: quem responde quando falha — Define dono, registro e cadência de conferência para integrações que rodam sem supervisão, incluindo o que só o monitoramento não resolve.
- Integração sem documentação: como avaliar antes de contratar — O que verificar em uma integração sem documentação antes de contratar: evidências que substituem o histórico, escopo do contrato e limites da avaliação.
- Integração sem identificador de execução: o que comparar — Comparação de três formas de rastrear uma execução de integração quando não existe identificador próprio, com o custo de manutenção e os limites de cada uma.
- Integração sem documentação: como reconstruir o que ela faz — Descreve como levantar o que uma integração faz a partir de evidências de operação, e o que permanece desconhecido quando não há registro escrito.
- Observabilidade: o que definir antes de monitorar integrações — Trata das decisões anteriores ao monitoramento: o que registrar, qual limite dispara alerta, quem responde e o que o acompanhamento não cobre.
