Resposta direta
A medição precisa sair do log e chegar à saída. Quando o registro não classifica erro, a integração é avaliada por sinais que mostram se o dado chegou completo e no tempo esperado: contagem por lote, diferença entre enviados e recebidos, atraso entre origem e destino, rejeições na ponta e conciliação de totais. O log indica onde procurar; a comparação com uma referência de negócio indica se há problema. Sem essa referência, executar sem exceção não prova sucesso. O critério de desvio e o responsável pela conferência devem estar definidos antes da primeira falha.
- Objetivo
- Explicar medição
- Formato indicado
- Projeto de implementação
- Atualizado em
O que esta página acrescenta: Constrói a medição a partir do log de execução, com contagem, atraso e conciliação, sem depender de classificação de erro.
O que o log consegue provar
Um log de execução registra horário, identificador de lote e, às vezes, quantidade processada. Isso localiza a execução e permite rastrear um período. Não informa, por si, se o registro chegou ao destino ou se chegou com os campos corretos.
A separação entre evidência e conclusão é o ponto de partida. O log comprova que o processo foi acionado. A conclusão sobre a integração vem da comparação com o que deveria existir no destino.
A conta entre origem e destino
A medição usa três conferências: quantidade de registros, valor de controle, como soma ou código, e tempo entre a criação na origem e a disponibilidade no destino. Cada lote precisa de um identificador comum aos dois lados.
Rejeições na ponta também entram na conta. Um registro recusado pode não aparecer como erro no log, mas altera o total. A diferença entre enviados, aceitos e disponíveis é o que permite localizar onde o fluxo perdeu conteúdo.
O que essa medição não resolve
Contagem igual não prova conteúdo correto. Dois lados podem ter o mesmo número de registros com campos trocados, valores truncados ou vínculos perdidos. A conferência de totais precisa ser acompanhada de amostra por campo crítico.
Quando o log não traz identificador de lote nem quantidade, a medição fica limitada ao que a origem e o destino expõem. Nesse caso, a prioridade é incluir o dado mínimo na próxima mudança, não construir um indicador sobre base incompleta. A abordagem também não define sozinha quem corrige a diferença; essa responsabilidade precisa estar atribuída.
Recurso prático
Da execução registrada à conferência da saída
- Definir a unidade de sucesso da integração, como pedido, cadastro ou lançamento, e o total que deveria atravessar cada janela.
- Extrair do log o que ele já registra: início, fim, identificador de lote e quantidade processada.
- Comparar origem e destino por contagem e valor de controle, registrando a diferença de cada lote.
- Classificar a diferença como atraso, rejeição, perda de registro ou divergência de valor, e atribuir a conferência a uma pessoa.
O erro mais comum é aceitar 'executou sem exceção' como prova de entrega. O log mostra que o processo rodou, não que o dado chegou íntegro.
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 · contagem por lote · atraso entre origem e destino · fila de rejeição · conciliação de totais. 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
- Cadastros duplicados: como descobrir e consol… — cadastros duplicados
- Exportações manuais: quando ainda fazem sentido — exportações manuais
Páginas relacionadas
O mesmo problema em outro objetivo
- Log de integração sem nível de erro: isolar a falha pelo fluxo — Diagnosticar
- Log de integração sem nível de erro: o que registrar — Organizar um processo
- Log de integração sem nível de erro: o que cada saída prova — Comparar alternativas
- Log de integração sem nível de erro: o que registrar — Orientar implementação
- Log de integração sem nível de erro: o que exigir no contrato — Orientar avaliação e contratação
Outras leituras em Integrações, sistemas e qualidade de dados
- Falha na sincronização: como medir o monitoramento — Como medir o monitoramento de falha na sincronização: cobertura, defasagem do aviso e falso positivo, e o que registrar antes de confiar nos números.
- Integração sem documentação: por onde reconstruir o contrato — Integração que funciona sem documentação: reconstruir o contrato pelos dados, definir responsável e controlar cada mudança.
- 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.
- Integração que roda sem monitoramento: o que medir — Define quais sinais registrar em uma integração sem acompanhamento: contagem na origem e no destino, atraso, erro e responsável.
- Sincronização sem janela definida: até quando o dado serve — Identifica a janela real de cada fluxo, mede o atraso e separa falha de sincronização de expectativa não acordada.