Pular para o conteúdo

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

Integração que roda sozinha: o que precisa estar pronto

como implementar uma integração que roda sem ninguém acompanhando

Resposta direta

Integração sem monitoramento não é integração sem conferência. É uma integração cujas falhas aparecem em outro lugar antes de virarem prejuízo: um ponto de reconciliação, um sinal que dispara pela ausência do dado esperado e um responsável nomeado para agir. O esforço de implementação está menos em automatizar a passagem e mais em definir o que conta como operação normal, quanto silêncio já é falha e quem responde quando o sinal não chega. Sem essas três definições, a integração apenas parece funcionar.

Objetivo
Orientar implementação
Formato indicado
Projeto de implementação
Atualizado em

O que esta página acrescenta: Trata a integração pelo que ela precisa registrar, provar e assumir sozinha, e não pelas ferramentas de conexão entre sistemas.

O que a execução precisa registrar por conta própria

Uma integração só pode rodar sem acompanhamento se ela mesma produzir o registro do que fez. Isso significa gravar, a cada execução, o horário de início e de fim, a quantidade de itens lidos, a quantidade gravada no destino e o total descartado com o motivo.

Sem esse registro, qualquer verificação posterior vira arqueologia. O critério prático é direto: se a integração falhar em uma madrugada e ninguém estava acordado, deve ser possível reconstruir o que aconteceu apenas pelo que ela deixou escrito.

Quem responde quando o sinal não chega

Automação não elimina responsabilidade, apenas desloca o momento de agir. Cada integração precisa de um responsável nomeado, não de um time genérico que todos supõem estar atento.

O caminho da falha deve estar descrito antes de o problema aparecer: como reprocessar um período, como isolar o lote com divergência e quem decide quando aceitar a diferença. Se a única pessoa que entende a integração é quem a escreveu, ela não opera sem monitoramento de verdade.

O que esse desenho não cobre

Nenhum arranjo de alertas corrige regra de negócio que mudou na origem. Se uma área passa a preencher um campo de outra forma, a integração continua rodando e o dado continua errado. Isso é problema de processo e de combinado entre áreas, não de tecnologia.

Também não resolve cadastro duplicado nem campo incompleto na fonte, e não dispensa alguém revisando os alertas disparados em intervalo definido. Em integrações de uso raro, com poucas execuções no mês, a conferência manual pode sair mais barata do que construir e manter o alerta.

Recurso prático

Sequência para deixar uma integração rodando sem acompanhamento diário

  1. Listar o que cada execução deveria entregar: quantidade de registros, horário esperado e destino final.
  2. Definir o limite de tolerância para atraso e para diferença entre o que entrou e o que saiu.
  3. Escolher o sinal de ausência, aquele que dispara quando a execução não ocorre ou entrega volume abaixo do esperado.
  4. Nomear quem recebe o sinal e o que essa pessoa faz sem depender de quem escreveu a integração.
  5. Registrar em cada execução o que foi lido, o que foi gravado e o que foi descartado, com o motivo do descarte.
  6. Revisar em intervalo definido os alertas disparados e ajustar os que só geram ruído.

O erro mais comum é alertar apenas sobre erro e não sobre ausência. Integração que para de rodar não gera erro: gera silêncio.

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: ponto de reconciliação · alerta por ausência · tolerância de atraso e divergência · registro de execução · dono da integração. 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 integração que roda sem monitoramento. 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.