Inspecionar solicitações de coleta de dados

A inspeção de solicitações mostra o que sua implementação enviou, se um servidor respondeu e, para o Web SDK, como o Edge Network processou o evento. Este artigo aborda os estágios de solicitação de saída, recebimento de servidor e processamento Edge do fluxo de trabalho de diagnóstico.

Para escolher uma ferramenta de inspeção, consulte Ferramentas de depuração. Para ver o que sua implementação fez antes de enviar uma solicitação, consulte Habilitar log de depuração. Para pontos de extremidade, formatos de solicitação e etapas de validação que pertencem a um aplicativo específico do Adobe, consulte Depuração específica do produto.

Inspecionar solicitações da Web web

Use as ferramentas de desenvolvedor do navegador ou o depurador de tags para capturar solicitações de uma página da Web:

As ferramentas do navegador mostram o tráfego originário do navegador. Eles não expõem chamadas de saída do servidor de aplicativos ou das regras de encaminhamento de eventos.

Ler solicitações do Edge Network edge-network-requests

Para implementações que usam o Adobe Experience Platform Web SDK, filtre as solicitações de rede para:

/ee/

Selecione a solicitação e inspecione a carga para visualizar os dados enviados para a Edge Network. Este filtro corresponde ao caminho base padrão do Web SDK; se sua implementação for alterada edgeBasePath, filtre o caminho configurado ou o host da coleção.

As URLs de solicitação do Web SDK usam o formato https://{edgeDomain}/ee/[{locationHint}/]v1/{action}?configId={datastreamId}&requestId={requestId}. O padrão edgeDomain é edge.adobedc.net; implementações primárias usam seu próprio CNAME. As seguintes partes do URL são evidências úteis:

O Edge Network pode encaminhar dados para os serviços configurados em seu fluxo de dados. A inspeção da solicitação do cliente mostra o que o cliente tentou enviar; ela não confirma, por si só, o recebimento do servidor ou o processamento downstream.

Inspecionar solicitações de dispositivos móveis e servidores mobile-server

Para implementações do Mobile SDK, adicione a extensão Assurance ao seu aplicativo e conecte-a a uma sessão do Assurance para inspecionar os eventos do SDK e os modos de exibição de validação com suporte. Use um proxy de depuração HTTP quando precisar de evidência de nível HTTP, sujeita ao certificado do seu aplicativo e à configuração da rede. Para inspecionar mensagens em ferramentas de desenvolvimento nativas, consulte Registro do Mobile SDK.

Para o Server SDK, a API do Edge Network direta ou outras implementações do lado do servidor, inspecione a solicitação de saída do servidor, o status HTTP, o corpo da resposta e os erros. Use a instrumentação HTTP do tempo de execução ou um proxy configurado para esse servidor. Uma solicitação do navegador para o aplicativo não mostra a solicitação separada do servidor para o Adobe. Consulte o log de SDK do servidor para obter a saída de diagnóstico do SDK.

Um log do SDK ou uma resposta HTTP bem-sucedida é uma evidência sobre um estágio específico da coleção, não uma prova de que todos os destinos configurados processaram o evento.

Rastrear processamento de Edge Network edge-processing

Para implementações do Web SDK, use o Edge Trace no Adobe Experience Platform Debugger para ver a solicitação recebida pelo Edge Network, a configuração de sequência de dados aplicada e as solicitações enviadas aos serviços em sua sequência de dados. O Edge Trace também abre os mesmos dados em uma sessão do Assurance. Para implementações do Mobile SDK, conecte o aplicativo diretamente ao Assurance; consulte Inspecionar solicitações de dispositivos móveis e servidores.

Não trate um evento de entrada ou um identificador de resposta como uma confirmação de que cada serviço downstream o processou. Continue com a orientação de depuração do aplicativo relevante.

Para o encaminhamento de eventos, Monitorar atividades fornece relatórios de uso, de erros de saída e de tempo de computação. Seus relatórios agregados podem ajudar a identificar destinos com falha, mas não são um rastreamento de delivery por evento.

Solicitações canceladas aborted-requests

Quando uma página sai, o navegador pode cancelar solicitações que ainda estão em andamento. O Firefox rotula essas solicitações NS_BINDING_ABORTED; o Chrome e o Edge as rotulam (canceled). Para manter as solicitações visíveis após a navegação, habilite Preservar log (Chrome e Edge) ou Persistir Logs (Firefox).

Uma solicitação cancelada não significa necessariamente que os dados foram perdidos. O navegador pode ter enviado a solicitação completa e parado de aguardar apenas a resposta. As solicitações que usam navigator.sendBeacon() ou fetch com keepalive podem continuar enviando após a navegação mesmo quando as ferramentas do desenvolvedor exibem um status de cancelado. Preservar o log mantém a entrada visível; isso não confirma o delivery.

Para investigar, abra o Debugger ou um proxy antes de reproduzir a navegação e inspecione a solicitação capturada e qualquer resposta do servidor. Uma resposta do servidor capturada fornece evidências de que o endpoint lidou com a solicitação; uma solicitação de saída sozinha não. Para o Web SDK, uma solicitação recebida em Edge Trace fornece evidência do lado do servidor. Nenhuma dessas observações por si só estabelece a disponibilidade nos relatórios posteriores.

Os navegadores não expõem a resposta HTTP de sendBeacon para a chamada do JavaScript. Uma mensagem de depuração relatando que a SDK usou sendBeacon, portanto, não pode confirmar o recebimento.

O documentUnloading do Web SDK seleciona um transporte com capacidade de descarregamento sujeito a restrições de identidade e carga. Esta opção não pode enviar eventos que ainda estão na fila quando a página é descarregada; consulte Quando eventos podem ser perdidos. As bibliotecas que enviam dados diretamente para um aplicativo do Adobe podem fornecer opções semelhantes; consulte a orientação de depuração desse aplicativo.