# 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.