Partilhar via

Solução de problemas de erros 4xx e 5xx usando a cadeia de caracteres de referência

  • Artigo

Um guia para entender e usar as 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 Cadeia de Caracteres de Referência, também conhecida como RefString, é uma cadeia de caracteres curta acrescentada pela Porta da Frente do Azure 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.

As Cadeias de Caracteres de Referência podem ajudá-lo a solucionar e resolver 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 ações apropriadas para corrigi-la analisando a Cadeia de Caracteres de Referência das solicitações.

Nota

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 reunir 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. Este cabeçalho contém a cadeia de caracteres 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 cadeia de caracteres de referência do navegador Microsoft Edge:

  1. Abra as ferramentas de desenvolvedor do navegador pressionando F12 ou Ctrl+Shift+I.

  2. Vá para a guia Rede .

  3. Atualize a página ou execute a ação que dispara a solicitação.

  4. Localize a solicitação específica na lista e localize o cabeçalho X-Azure-Ref na seção cabeçalhos de resposta.

  5. Copie o valor do cabeçalho X-Azure-Ref para usar com a ferramenta de solução de problemas de Cadeia de Caracteres de Referência no portal do Azure.

Para obter mais informações, consulte Inspecionar atividade de rede - documentação do Microsoft Edge Developer.

Exemplo de como obter uma cadeia de caracteres de referência do navegador Microsoft Edge:

Captura de tela do exemplo RefString no 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 String 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:

  1. Navegue até o seu Perfil da Porta da Frente do Azure.

  2. Selecione o menu Diagnosticar e resolver problemas .

    Captura de tela mostrando a primeira etapa no diagnóstico de problemas usando uma Cadeia de Caracteres de Referência.

  3. Role para baixo e selecione Conectividade na seção Problemas comuns.

    Captura de tela mostrando a segunda etapa no diagnóstico de problemas usando uma Cadeia de Caracteres de Referência.

  4. 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.

    Captura de tela mostrando a terceira etapa no diagnóstico de problemas usando uma Cadeia de Caracteres de Referência.

  5. Insira sua String de referência na caixa dentro da seção de erros 4xx e 5xx. Você insere a String de Referência fornecida a você em sua solicitação no campo Referência de Acompanhamento – RefString .

    Captura de tela mostrando a quarta etapa no diagnóstico de problemas usando uma Cadeia de Caracteres de Referência.

  6. 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:

    Captura de tela mostrando um exemplo do diagnóstico no trabalho usando uma cadeia de caracteres de referência.

    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 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 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.