Requisições
Monitoramento de Requisições
Esta página detalha como acompanhar em tempo real a saúde e o desempenho de integrações por meio do monitoramento de requisições. Você poderá verificar status, duração, payloads de request/response, identificar o fluxo e a execução que originaram a chamada e aprofundar a análise em um painel de detalhamento por requisição.
Visão geral
Nesta seção, você tem a ferramenta necessária para acompanhar em tempo real a saúde e o desempenho de suas integrações. Obtenha insights rápidos sobre:
- Status das requisições: verifique rapidamente se uma operação foi bem-sucedida, falhou ou está em andamento.
- Duração das operações: analise o tempo de execução para otimizar a eficiência dos processos.
- Request e Response: inspecione o payload enviado e a resposta retornada para troubleshooting.
- Fluxo de origem: identifique de qual fluxo a requisição foi originada para entender o contexto.
- Detalhamento por item: cada entrada pode ser expandida para visualizar detalhes adicionais.
Diferenças entre Passo e Requisição
- Passo: representa a unidade de trabalho executada pela plataforma; seu tempo de passo inclui validações, transformações e processamentos internos.
- Requisição: representa somente a chamada externa realizada por um passo; seu tempo de requisição mede do envio até a resposta da API.
Muitos passos não geram requisições (ex.: Fluid Transformer , Conditional - IF , Wait , Loop - FOR ) e, portanto, não aparecem nesta listagem de Requisições. Essa separação melhora a precisão da análise de performance.
Quando houver chamada externa, o tempo do passo será, em geral, maior ou igual ao tempo da requisição, pois inclui o processamento interno além da chamada externa.
Detalhamento de requisições
Cada entrada na lista de requisições pode ser expandida para visualizar detalhes adicionais. Ao acessar uma requisição específica, os seguintes dados ficam disponíveis:
- Status: indica sucesso, falha ou andamento.
- Código de status (HTTP): p.ex., 200, 404, 500.
- Data e hora: timestamp exato da chamada.
- Entidade (passo no canvas): identifica o passo que originou a chamada; exibido apenas quando o passo efetivamente realiza uma requisição externa.
- Nome do fluxo: fluxo responsável pela requisição.
- ID da execução do fluxo: identificador único da instância de execução.
- ID da requisição: identificador exclusivo para localizar/inspecionar a chamada.
- ID do evento: identifica o evento que disparou o fluxo.
- Duração da requisição (ms): tempo do envio até o recebimento da resposta externa.
- Duração do passo (ms): tempo total do processamento do passo (inclui validações, transformações e lógica interna).
- Payload de entrada (request): dados enviados.
- Resposta da Requisição: Veja a resposta recebida, ajudando a diagnosticar rapidamente questões de integração.
Status das requisições
- Sucesso: processada sem erros.
- Sucesso customizado: a requisição teve uma condição de sucesso inserida pelo usuário no Tratamento de Erros.
- Falha: houve problema na execução.
Filtragem avançada
Use filtros para localizar requisições específicas:
- Por nome do passo: encontre chamadas originadas de uma etapa específica.
- Por nome do fluxo: restrinja às requisições de um Fluxo .
- Por status: isole operações bem-sucedidas ou com falha.
- Por código de erro: pesquise por códigos específicos (ex.: HTTP 400).
- Por Tags: encontre fluxos com Tags atribuidas previamente
As listas de requisições, eventos e execuções de fluxos exibem dados dos últimos 30 dias. Para análises além desse intervalo, utilize filtros mais específicos ou realize exportações periódicas; caso precise, entre em contato com o time para ampliar o tempo de retenção.
Tempo de execução
Acompanhe a eficiência com a duração de cada requisição (em milissegundos) e, quando aplicável, com a duração do passo. Use estas métricas para identificar gargalos na API externa (requisição) ou no processamento interno (passo).
Análise de Problemas
Para orientações adicionais e contexto avançado sobre a tela de requisições, consulte a seção Análise de Problemas. Há também um vídeo tutorial demonstrando um processo de investigação de Eventos a partir da página de Requisições.
Privacidade
Em alguns cenários, determinados campos podem ser anonimizados conforme as políticas de Privacidade da plataforma. Consulte a página de Privacidade para detalhes sobre anonimização de dados sensíveis e como configurar exceções quando aplicável.
Isso significa que os dados availabbleFor e name estão inclusos na página de Privacidade.
Veja também
- passo — conceitos, configuração e monitoramento de passos (inclui a distinção entre tempo do passo e tempo da requisição).
- Eventos — origem do disparo e correlação com execuções e requisições.
- Fluxos — visão geral de execuções, sucesso/falha e diagnóstico.