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.

Quando a investigação começa em uma notificação de erro recebida por outro sistema, consulte Do webhook de erro à exportação da execução.

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.