Solução de problemas de erros 4xx e 5xx usando RefString
Um guia para entender e usar RefStrings 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 RefString?
Uma RefString, também conhecida como cadeia de caracteres de Referência, é uma cadeia de caracteres curta acrescentada pelo Azure Front Door aos cabeçalhos de resposta HTTP de cada solicitação. Ele fornece detalhes sobre como a solicitação foi processada, incluindo o ponto de presença (POP) e o status do back-end.
RefStrings pode ajudá-lo a solucionar e resolver problemas com o Azure Front Door, como falhas de cache, erros de roteamento, falhas de back-end e problemas de latência. Você pode identificar a causa raiz e tomar as ações apropriadas para corrigi-la analisando os RefStrings das solicitações.
Nota
Se você encontrar uma página de erro dos serviços da Microsoft, ela já incluirá um RefString 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 um RefString
Para reunir um RefString, você precisa capturar os cabeçalhos de resposta HTTP das solicitações e procurar o cabeçalho chamado X-Azure-Ref. Este cabeçalho contém o RefString, codificado 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 um RefString 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 RefString no portal do Azure.
Para obter mais informações, consulte Inspecionar atividade de rede - documentação do Microsoft Edge Developer.
Exemplo de como obter um RefString do Microsoft Edge Browser:
Como usar um RefString com algumas de nossas ferramentas de solução de problemas
O Azure Front Door usa um RefString para gerenciar erros 4xx e 5xx. A seguir estão as etapas para usar a ferramenta de diagnóstico com um RefString para rastrear e diagnosticar problemas de conectividade:
Navegue até o seu Perfil da Porta da Frente do Azure.
Selecione o menu Diagnosticar e resolver problemas .
Role para baixo e selecione Conectividade na seção Problemas comuns.
Na caixa Que problema está a ter?, selecione Selecionar um subtipo de problema e escolha erros 4xx e 5xx no menu pendente e, em seguida, selecione Seguinte.
Digite seu RefString na caixa dentro da seção de erros 4xx e 5xx. Você insere a Restring fornecida a você da sua solicitação no campo Referência de acompanhamento – RefString .
Por fim, selecione Executar diagnóstico para identificar a causa do problema, o que explica a falha se for um problema conhecido.
Um exemplo de um resultado exibindo um problema:
Nota
Os recursos de diagnóstico podem exigir até 15 minutos para fornecer resultados. Pedimos a sua paciência para permitir que o processo termine antes de tomar outras medidas.
Opção alternativa
Se você optar por não usar a ferramenta de diagnóstico, poderá incluir um RefString ao enviar um tíquete de suporte. Além disso, você pode habilitar o recurso Logs de Acesso para receber atualizações nos dados RefString diretamente no portal do Azure.
Para obter mais informações sobre como controlar referências e parâmetros de log de acesso, consulte Monitorar métricas e logs no Azure Front Door, que destaca campos específicos em logs de acesso que ajudam a identificar vários tipos de erros.
Próximos passos
- Para saber mais sobre como navegar em problemas comuns, consulte Problemas de solução de problemas da porta frontal.
- Para obter respostas a perguntas comuns, consulte Perguntas frequentes sobre o Azure Front Door.