--- title: Requisições slug: requisicoes description: Learn how to monitor requests in order to ensure the smooth functioning of your integrations. Our document explains how you can easily track the status, duration, payload, and response of each request for comprehensive monitoring. With the ability to filt docTags: createdAt: 2023-05-05T14:49:13.000Z --- # 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. ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/_29VJ4vq70kr6vr0EW5t4_image.png) ## Diferenças entre Passo e Requisição A partir da atualização [v3.19.0](docId\:i2Q958fMK12xhICdDpseE) , [passo](docId\:fj3eoMx0UlDO0WvxJXsLG) e **requisição** são entidades distintas no monitoramento: - **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. :::hint{type="warning"} Muitos passos **não geram requisições** (ex.: [Fluid Transformer](docId\:Fpcg3XMyTw33NbR1Pvq_-) , [Conditional - IF](docId\:N_6BKLyFc-LkSldXsl3D8) , [Wait](docId\:X6308fMi5S2m_389mtqsI) , [Loop - FOR](docId\:gxq2T8bdsm_6MIqki03WE) ) e, portanto, **não aparecem** nesta listagem de Requisições. Essa separação melhora a precisão da análise de performance. ::: :::hint{type="info"} 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: ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/KaAXsk2ta5R2juOe9usYk_requisicoes-expandir.gif) - **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). ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/9aYJ_Hx9OmEgUY2qPqog-_image.png" size="60" width="564" height="679" position="center" darkWidth="564" darkHeight="679" showCaption="false"} - **Payload de entrada (request)**: dados enviados. ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/1gaC9VyigB9gWPDAWR5UG_image.png) - **Resposta da Requisição: **Veja a resposta recebida, ajudando a diagnosticar rapidamente questões de integração. ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/JE44qyaWl8fDDfq__9kWU_image.png) ## Status das requisições - **Sucesso**: processada sem erros. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/W70XQgDjI5k37NW11Ybg4_image.png" size="20" width="98" height="97" position="center" darkWidth="98" darkHeight="97" showCaption="false"} - **Sucesso customizado**: a requisição teve uma condição de sucesso inserida pelo usuário no [Tratamento de Erros](docId\:Iew9ungeTwQfRPtgELulq). ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/jAYyE4-RTDBUB0i3i3Jou_image.png" size="20" width="104" height="62" position="center" darkWidth="104" darkHeight="62" showCaption="false"} - **Falha**: houve problema na execução. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/xa1lQelDseWtf7LA6qC3k_image.png" size="20" width="94" height="98" position="center" darkWidth="94" darkHeight="98" showCaption="false"} ## 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](docId\:WTZWYEZQPk5bX-oJ0t938) . - **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](docId\:TTiU_EMXMPmfJBSviJA1_) atribuidas previamente :::hint{type="info"} 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](https://app.archbee.com/docs/312alvuzCDxIa84M0tNWX/anm2iZUKJrW22S6r7UGig) demonstrando um processo de investigação de [Eventos](docId\:r8iZLK7lZFeJywEmo04Yf) a partir da página de [Requisições](docId\:I7rU3leUfLcZvzlfRXaEN). ## Privacidade Em alguns cenários, determinados campos podem ser **anonimizados** conforme as políticas de [Privacidade](docId\:kcZIRd8EvrZ3UM_4eL9q6) da plataforma. Consulte a página de [Privacidade](docId\:kcZIRd8EvrZ3UM_4eL9q6) para detalhes sobre anonimização de dados sensíveis e como configurar exceções quando aplicável. ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/jQm8WQ4U3NFr3M-swQbJZ_image.png) Isso significa que os dados `availabbleFor` e `name` estão inclusos na página de [Privacidade](docId\:kcZIRd8EvrZ3UM_4eL9q6). ## Veja também - [passo](docId\:fj3eoMx0UlDO0WvxJXsLG) — conceitos, configuração e monitoramento de passos (inclui a distinção entre tempo do passo e tempo da requisição). - [Eventos](docId\:r8iZLK7lZFeJywEmo04Yf) — origem do disparo e correlação com execuções e requisições. - [Fluxos](docId:44tLsB_tOXlLWOeOErklS) — visão geral de execuções, sucesso/falha e diagnóstico.