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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tunnelhub.io/produto/monitoring.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.