Pular para o conteúdo

Soluções · Integrações, sistemas e qualidade de dados

Integração parou sem avisar: como achar quando e onde

Como saber quando uma integração parou de funcionar se nenhum alerta foi disparado?

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

  1. Localizar a última execução registrada como bem-sucedida e a primeira execução esperada sem qualquer registro.
  2. Contar, por período, os registros que deveriam ter sido transferidos e os que chegaram ao destino.
  3. Comparar os dois números para dimensionar a lacuna e listar quais registros ficaram de fora.
  4. Identificar os processos e as decisões que usaram o dado incompleto durante o intervalo.
  5. 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

Páginas relacionadas

O mesmo problema em outro objetivo

Outras leituras em Integrações, sistemas e qualidade de dados

Quer avaliar isso no seu contexto?

Esta página trata de falha de integração sem aviso a ninguém. Diagnóstico de integração é a frente que investiga o mecanismo por trás desse tipo de problema. O formato mais associado é Projeto de implementação.