Resposta direta
Medir uma integração sem monitoramento começa por registrar, a cada execução, quanto saiu da origem, quanto chegou ao destino e o intervalo entre os dois. Esses três números, guardados com data e hora, permitem separar duas falhas que costumam ser tratadas juntas: atraso e perda de registro. O limite aceitável para cada um deve vir da área que usa o dado, não da equipe técnica. Sem responsável definido para ler o registro e agir, a medição não muda nada na operação.
- Objetivo
- Explicar medição
- Formato indicado
- Projeto de implementação
- Atualizado em
O que esta página acrescenta: Trata a medição quando não existe painel: quais sinais registrar por execução e por que atraso e divergência são leituras distintas.
O primeiro sinal é a contagem, não o alerta
Toda integração deixa rastro em três pontos: o que saiu da origem, o que chegou ao destino e o que ficou retido entre os dois. Medir começa por registrar esses três números por execução, com data e hora. Sem essa base, qualquer conversa sobre falha depende de memória e impressão.
O registro não exige ferramenta nova. Uma tabela de controle por lote, alimentada pelo próprio processo, já separa operação normal de desvio. O critério é ter o mesmo dado dos dois lados, na mesma unidade de contagem.
Atraso e divergência são medidas diferentes
Atraso mede tempo: quando o lote saiu e quando chegou. Divergência mede quantidade: quanto saiu e quanto chegou. Uma integração pode estar pontual e perder registros, ou chegar completa e tarde. As duas leituras precisam de limites definidos com quem usa o dado.
Definir o limite aceitável é decisão de negócio, não de tecnologia. A área que consulta o dado diariamente sabe a partir de quanto um atraso atrapalha a operação. Esse valor vira o critério de acionamento, em vez de um número escolhido por conveniência técnica.
O que a medição não resolve
Medir não corrige a integração. Ela mostra onde o dado se perde para que alguém decida o que fazer. Se não houver responsável nomeado para ler o registro e agir, a medição vira arquivo morto.
A medição também não cobre erro que nasce antes do envio, como cadastro incorreto na origem. E não substitui conferência de negócio: um lote pode chegar completo e no prazo, e ainda assim estar errado no conteúdo.
Recurso prático
Pontos de medição e o que registrar em cada um
| Onde medir | O que registrar |
|---|---|
| Saída da origem | Quantidade de registros enviados por lote, com data, hora e identificação do lote |
| Ponto de recebimento | Quantidade recebida comparada à enviada e o intervalo entre envio e chegada |
| Fila ou tabela de erro | Registros que não passaram, motivo da rejeição e data da última tentativa |
O erro mais comum é contar apenas o que chegou. Sem a contagem na origem, uma integração que perde registros no meio parece funcionar, porque o destino processa tudo o que recebe e nada acusa falta.
Sobre o que está escrito aqui
Conceitos relacionados: contagem por lote · atraso entre envio e recebimento · divergência de registros · registro de erro · tabela de controle. 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
- Planilha paralela: critérios para manter, mig… — planilha que virou sistema paralelo
- Planilha paralela: como transferir a rotina p… — planilha que virou sistema paralelo
Páginas relacionadas
O mesmo problema em outro objetivo
- Integração sem monitoramento: o que verificar primeiro — Diagnosticar
- 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 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
- 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.
- 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.
- 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.
- Importação que sobrescreve dado correto: comparar as saídas — Compara as saídas possíveis para importação que sobrescreve dado correto: sobrescrever, mesclar por campo, rejeitar conflito e revisar antes de gravar.
- Campo numérico aceitando texto: o que fazer com o registro — Regra de tratamento para registros com texto em campo numérico: o que corrigir na hora, o que separar para conferência e quem responde pela decisão.