Monitoramento

Monitoramento é uma das partes mais importantes do TunnelHub. A plataforma foi desenhada para dar visibilidade sobre execuções, falhas e comportamento técnico sem exigir que cada integração implemente sua própria camada operacional do zero.

Onde acessar

As execuções de automações ficam em Automations > Monitoring.

Nesta área você encontra filtros por período, automação, pacote, status e outros critérios operacionais.

No fluxo atual, também é comum trabalhar com:

• janela de tempo explícita;

• filtro por pacote e ambiente;

• opção para esconder execuções bem-sucedidas sem itens processados.

O que existe em uma execução

Cada execução possui informações como:

• identificador da execução;

• automação e ambiente relacionados;

• horário de início e fim;

• status consolidado;

• quantidade processada e quantidade de erros.

Dependendo do caso, a execução também pode exibir versão do SDK, estratégia de logging, runtime e identificadores técnicos adicionais.

Logs de processamento

Os logs de processamento mostram o resultado por item processado. Eles são baseados nos metadados definidos pelo SDK e normalmente incluem:

• ação executada;

• status;

• mensagem;

• colunas de negócio definidas por defineMetadata().

Esses logs são a melhor fonte para entender o que aconteceu com cada registro.

Traces

Os traces mostram informações mais técnicas da execução, incluindo logs emitidos pelo próprio flow e eventos auxiliares da plataforma.

Eles são úteis para:

• investigar falhas de integração;

• medir passos internos do processamento;

• validar comportamento de chamadas externas.

Como investigar um problema

Um fluxo prático costuma ser:

1. localizar a execução pelo período e status;

2. abrir o detalhe para entender o contexto geral;

3. usar logs de processamento para registros de negócio;

4. usar traces para erros técnicos ou intermitentes;

5. reprocessar a execução quando o cenário permitir.

Análise assistida

Em alguns cenários, a plataforma também oferece análise assistida por IA para resumir falhas e ajudar no troubleshooting.

Esse recurso não substitui logs e traces. Ele acelera a leitura inicial do incidente.

Dicas para bons logs

• defina metadados que ajudem o time de negócio a localizar registros;

• evite mensagens genéricas demais;

• use parâmetros, Tabelas De/Para e Sequências para enriquecer o contexto sem valores fixos no código;

• complemente com traces técnicos apenas quando isso gerar valor investigativo.