Compartilhar via

Solucionar problemas de erros 4xx e 5xx usando a cadeia de caracteres de referência

Resumo

Este artigo fornece diretrizes sobre como entender e usar cadeias de caracteres de referência para diagnosticar e resolver problemas com Azure Front Door.

Pré-requisitos

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 por 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 de back-end.

As cadeias de caracteres de referência podem ajudá-lo a solucionar problemas com Azure Front Door, como erros 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.

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

  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 cadeia de caracteres de referência no portal Azure.

Para obter mais informações, consulte Inspect network activity – Microsoft Edge Developer documentation.

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

Screenshot do exemplo RefString em Microsoft Edge Browser.

Como usar uma cadeia de caracteres de referência com algumas de nossas ferramentas de solução de problemas

Azure Front Door usa uma cadeia de caracteres de referência para gerenciar erros 4xx e 5xxx. Estas são as etapas para usar a ferramenta de diagnóstico com uma cadeia de caracteres de referência para acompanhar e diagnosticar problemas de conectividade:

  1. Navegue até seu perfil de Azure Front Door.

  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 você está tendo?, selecione um subtipo de problema e escolha erros 4xx e 5xx no menu suspenso, então selecione Avançar.

    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 no campo na seção de erros 4xx e 5xx. Insira a sequência de referência, fornecida a partir de 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 que exibe um problema:

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

    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 Access Logs para receber atualizações nos dados refString diretamente no portal Azure.

Para obter mais informações sobre referências de rastreamento e parâmetros de log de acesso, consulte Monitor métricas e logs em 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 entender problemas comuns, consulte Resolução de Problemas do Front Door.
  • Para obter respostas a perguntas comuns, consulte Azure Front Door perguntas frequentes.
  • Last updated on