Resposta direta
Comece pelo que a integração deixa registrado. Integração sem monitoramento raramente falha em silêncio total: ela para de gerar registro, atrasa o envio ou repete carga. O diagnóstico parte de três verificações. Existe log de execução com data, volume e status. Existe responsável nomeado pelo fluxo. Existe conferência entre o que saiu de um sistema e o que chegou no outro. Sem esses três pontos, a única evidência de falha é a reclamação da área usuária, sempre depois do efeito. O trabalho é repor a evidência antes de discutir correção.
- Objetivo
- Diagnosticar
- Formato indicado
- Projeto de implementação
- Atualizado em
O que esta página acrescenta: Descreve o que observar quando não existe painel nem alerta, e o que esse levantamento deixa fora do alcance.
O que uma integração deixa como rastro
Toda execução produz algum rastro: horário de início, quantidade de registros, status final, mensagem de erro. Quando esse rastro não existe ou não é consultável, a integração passa a depender da memória de quem a configurou.
O levantamento começa por listar quais desses elementos são gravados hoje. Data e volume já permitem reconstruir o que aconteceu em cada rodada; sem eles, só resta refazer a carga para comparar, o que costuma ser mais caro que registrar desde o início.
Comparar origem e destino
A conferência básica é contar o que saiu e o que chegou, por período e por lote. Divergência de contagem indica perda ou duplicidade antes que a área usuária sinta o efeito no processo.
Quando a contagem fecha e o conteúdo não, o problema está na transformação: campo convertido, valor truncado, regra aplicada de forma diferente nos dois lados. Esse é o tipo de falha que nenhum aviso de execução captura, porque a rotina terminou com sucesso.
O que esse levantamento não resolve
Repor registro e conferência reduz o tempo entre a falha e a percepção dela. Não impede a falha, não corrige a causa e não dispensa alguém de decidir o que fazer com a divergência encontrada.
Em fluxos que mudam a cada semana, conferência fixa envelhece rápido e passa a validar uma regra que já não vale. Nesses casos o limite é claro: sem dono definido para revisar as regras de conferência, o acompanhamento volta a depender de reclamação da área usuária.
Recurso prático
Sinais de uma integração sem acompanhamento
| Sinal observado | O que verificar |
|---|---|
| O envio não registra data, volume e status | Confirmar se cada execução deixa registro consultável e quem tem acesso a ele |
| A área usuária é a primeira a notar o erro | Comparar total enviado na origem com total recebido no destino, por período e por lote |
| Não há nome ligado ao fluxo | Definir responsável pela execução, pela conferência e pelo reprocessamento |
O erro mais comum é tratar alerta como monitoramento. Aviso de falha cobre o erro previsto na configuração; divergência de conteúdo entre origem e destino costuma passar sem aviso, e por isso a contagem é o teste que se ignora.
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: log de execução · conferência de totais entre origem e destino · responsável pela integração · janela de execução · fila de reprocessamento. 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
- Falhas silenciosas em integrações: como perce… — falhas silenciosas
- Exportações manuais: quando ainda fazem sentido — exportações manuais
Páginas relacionadas
O mesmo problema em outro objetivo
- Integração que roda sozinha: quem responde quando falha — Organizar um processo
- Integração sem monitoramento: como comparar as alternativas — Comparar alternativas
- Integração que roda sem monitoramento: o que medir — Explicar medição
- Integração que roda sozinha: o que precisa estar pronto — Orientar implementação
- Integração que roda sozinha: o que exigir no contrato — Orientar avaliação e contratação
Outras leituras em Integrações, sistemas e qualidade de dados
- Integração sem documentação: como medir o que ficou — Descreve como medir uma integração sem documentação a partir de rastros observáveis: contagens, horários, registros de erro e responsáveis.
- Integração por API: o que definir antes de ir para produção — O que precisa estar definido antes de uma API entrar em produção: contrato de dados, comportamento em falha, reprocessamento e responsável pela integração.
- Falha na sincronização: como comparar o monitoramento — Compara as formas de acompanhar falha na sincronização, o que cada uma percebe, em quanto tempo e a que custo de operação.
- Fila de processamento sem prazo: limite, ordem e exceção — Define prazo, prioridade, envelhecimento e exceção para filas de processamento, com pontos de controle, responsáveis e critérios de descarte.
- Log de integração sem nível de erro: o que registrar — A página trata da classificação de eventos no log de integração: o que distinguir, onde gravar a decisão e como revisar sem depender de memória.