Solução de problemas de erros 4xx e 5xx usando a cadeia de caracteres de referência
Um guia para entender e usar cadeias de caracteres de referência para diagnosticar e resolver problemas com o Azure Front Door.
Pré-requisitos
- Você deve ter um perfil do Azure Front Door. Para criar um perfil, consulte Criando um perfil do Azure Front Door.
O que é uma cadeia de caracteres de referência?
Uma sequência de caracteres de referência, também conhecida como RefString, é uma sequência de caracteres curta anexada pelo Azure Front Door aos cabeçalhos de resposta HTTP de cada solicitação. Ela fornece detalhes sobre como a solicitação foi processada, incluindo o ponto de presença (POP) e o status de back-end.
As sequências de caracteres de referência podem ajudar você a solucionar problemas com o Azure Front Door, como falhas de cache, falhas de back-end e problemas de latência. Você pode identificar a causa raiz e tomar as medidas adequadas para corrigi-la analisando a sequência de referência das solicitações.
Observação
Se você encontrar uma página de erro dos serviços da Microsoft, ela já incluirá uma Cadeia de caracteres de Referência para a solicitação que gerou a página de erro. Nesses casos, você pode pular diretamente para a etapa de diagnóstico.
Como reunir uma cadeia de caracteres de referência
Para coletar uma Cadeia de caracteres de Referência, você precisa capturar os cabeçalhos de resposta HTTP das solicitações e procurar o cabeçalho chamado X-Azure-Ref. Esse cabeçalho contém a String de Referência, codificada em Base64. Você pode usar métodos diferentes para capturar os cabeçalhos de resposta HTTP, dependendo de sua preferência e situação. Aqui está um exemplo de como obter uma sequência de referência do navegador Microsoft Edge:
Abra as ferramentas de desenvolvedor do navegador pressionando
F12ouCtrl+Shift+I.Vá para a guia Rede.
Atualize a página ou execute a ação que dispara a solicitação.
Localize a solicitação específica na lista e localize o cabeçalho X-Azure-Ref na seção cabeçalhos de resposta.
Copie o valor do cabeçalho X-Azure-Ref para usar com a ferramenta de solução de problemas de sequência de caracteres de referência no portal do Azure.
Para obter mais informações, consulte Inspecionar a atividade de rede – documentação do Desenvolvedor do Microsoft Edge.
Exemplo de como obter uma String de Referência do Navegador Microsoft Edge:
Como usar uma cadeia de caracteres de referência com algumas de nossas ferramentas de solução de problemas
O Azure Front Door usa uma sequência de caracteres de referência para gerenciar erros 4xx e 5xx. A seguir estão as etapas para usar a ferramenta de diagnóstico com uma cadeia de caracteres de referência para rastrear e diagnosticar problemas de conectividade:
Navegue até o perfil do Azure Front Door.
Selecione o menu Diagnosticar e resolver problemas.
Role para baixo e selecione Conectividade na seção Problemas comuns.
Na caixa Que problema você está tendo? selecione Selecionar um subtipo de problema e escolha erros 4xx e 5xx no menu suspenso e selecione o Próximo.
Insira sua Cadeia de caracteres de Referência na caixa dentro da seção Erros 4xx e 5xx. Você insere a Cadeia de caracteres de referência fornecida a você em sua solicitação no campo Referência de rastreamento – RefString.
Por fim, selecione Executar Diagnóstico para identificar a causa do problema, que explica a falha se for um problema conhecido.
Um exemplo de um resultado que exibe um problema:
Observação
Os recursos de diagnóstico podem exigir até 15 minutos para entregar resultados. Pedimos sua paciência para que você permita que o processo seja concluído antes de tomar medidas adicionais.
Opção alternativa
Se você optar por não usar a ferramenta de diagnóstico, poderá incluir uma Cadeia de caracteres de referência ao enviar um tíquete de suporte. Além disso, você pode habilitar o recurso Logs de Acesso para receber atualizações nos dados da RefString diretamente no portal do Azure.
Para obter mais informações sobre referências de rastreamento e parâmetros de log de acesso, consulte Métricas e logs do Monitor no Azure Front Door, que realça campos específicos em logs de acesso que ajudam a identificar vários tipos de erros.
Próximas etapas
- Para saber mais sobre como navegar em problemas comuns, consulte Problemas de solução de problemas do Front Door.
- Para obter respostas para perguntas comuns, consulte perguntas frequentes sobre o Azure Front Door.