Monitoramento
6 min
Objetivo/Resumo
A área de monitoramento da plataforma permite acompanhar em tempo real a execução dos fluxos de integração e identificar falhas ou comportamentos inesperados. Essa funcionalidade é essencial para times técnicos que precisam garantir o correto funcionamento das automações configuradas.
Latência na visualização de logs
Após a ingestão, os logs podem levar até 60 segundos para ficarem disponíveis para consulta. Essa latência é intencional para otimizar a performance do sistema de monitoramento. Os dados são registrados imediatamente.
Acesso ao monitoramento
- O monitoramento pode ser acessado pelo menu lateral da plataforma, na opção Monitoramento.
- É necessário ter permissão de leitura ou edição dos fluxos para visualizar os dados.
- A interface é atualizada automaticamente conforme novas execuções ocorrem.
Principais informações exibidas
- Nome do fluxo: identifica qual fluxo foi executado.
- Status da execução:
- Sucesso
- Erro
- Em andamento
- Horário da execução: indica quando a execução começou.
- Duração: mostra o tempo total da execução.
- Origem do disparo: informa se o fluxo foi disparado manualmente, por agendamento, via API ou por conector.
- Identificador único: cada execução tem um ID exclusivo que pode ser usado para rastreamento detalhado.
Ações disponíveis
- Visualizar detalhes: ao clicar sobre uma execução, é possível visualizar o payload completo, headers HTTP, logs e respostas dos conectores envolvidos.
- Filtrar execuções:
- Por período (última hora, dia, semana etc.)
- Por status (sucesso, erro)
- Por nome do fluxo ou workspace
Casos de uso comuns
- Identificação rápida de falhas em fluxos automatizados.
- Análise de tempo de resposta entre sistemas integrados.
- Validação do comportamento de fluxos após alterações.
- Rastreamento de execuções específicas a partir do ID.
Boas práticas
- Acompanhar fluxos com erro com frequência para evitar gargalos em processos críticos.
- Utilizar os filtros para focar em execuções problemáticas ou fora do padrão.
- Manter logs claros e objetivos nos conectores para facilitar o diagnóstico.
O dashboard nos mostra uma visão geral, que pode se aprofundar navegando no menu lateral.
Monitoramento de fila
- O sistema exibe separadamente o número de mensagens aguardando na fila e o número de mensagens em processamento.
- Essa distinção evita confusões comuns, como o caso em que há 5 itens sendo processados e o cliente tenta limpar a fila — sem sucesso aparente — porque todos os itens já estavam em execução.
- A separação clara desses estados melhora a transparência da interface e reduz a sensação de falha no botão de limpeza.
Permissões para limpar a fila
- Apenas usuários com perfil tnt_admin estão autorizados a executar a ação de limpeza da fila.
- Essa restrição evita incidentes causados por múltiplos desenvolvedores atuando simultaneamente em um mesmo workspace.
- Trata-se de uma ação sensível, com impacto direto nas execuções em andamento, e por isso deve ser limitada a usuários com perfil administrativo.