Udostępnij za pośrednictwem

Rozwiązywanie problemów z błędami 4xx i 5xx przy użyciu ciągu odwołania

  • Artykuł

Przewodnik ułatwiający zrozumienie i używanie ciągów referencyjnych do diagnozowania i rozwiązywania problemów z usługą Azure Front Door.

Wymagania wstępne

  • Musisz mieć profil usługi Azure Front Door. Aby utworzyć profil, zobacz Tworzenie profilu usługi Azure Front Door.

Co to jest ciąg odwołania?

Ciąg odwołania, znany również jako RefString, to krótki ciąg dołączany przez usługę Azure Front Door do nagłówków odpowiedzi HTTP każdego żądania. Zawiera szczegółowe informacje na temat sposobu przetwarzania żądania, w tym punktu obecności (POP) i stanu zaplecza.

Ciągi referencyjne mogą pomóc w rozwiązywaniu problemów z usługą Azure Front Door, takich jak błędy pamięci podręcznej, błędy zaplecza i problemy z opóźnieniami. Główną przyczynę można zidentyfikować i podjąć odpowiednie działania, aby rozwiązać ten problem, analizując ciąg odwołania żądań.

Uwaga

Jeśli wystąpi strona błędu z usługi firmy Microsoft, będzie ona już zawierać ciąg odwołania dla żądania, które wygenerowało stronę błędu. W takich przypadkach możesz przejść bezpośrednio do kroku diagnostycznego.

Jak zebrać ciąg odwołania

Aby zebrać ciąg odwołania, należy przechwycić nagłówki odpowiedzi HTTP żądań i wyszukać nagłówek o nazwie X-Azure-Ref. Ten nagłówek zawiera ciąg odwołania zakodowany w formacie Base64. W zależności od preferencji i sytuacji można użyć różnych metod przechwytywania nagłówków odpowiedzi HTTP. Oto przykład uzyskiwania ciągu odwołania z przeglądarki Microsoft Edge:

  1. Otwórz narzędzia deweloperskie przeglądarki, naciskając F12 lub Ctrl+Shift+I.

  2. Przejdź do karty Sieć .

  3. Odśwież stronę lub wykonaj akcję, która wyzwoli żądanie.

  4. Znajdź określone żądanie na liście i znajdź nagłówek X-Azure-Ref w sekcji nagłówków odpowiedzi.

  5. Skopiuj wartość nagłówka X-Azure-Ref do użycia z narzędziem do rozwiązywania problemów z ciągami referencyjnymi w witrynie Azure Portal.

Aby uzyskać więcej informacji, zobacz Inspekcja działań sieciowych — dokumentacja dla deweloperów przeglądarki Microsoft Edge.

Przykład uzyskiwania ciągu odwołania z przeglądarki Microsoft Edge:

Zrzut ekranu przedstawiający przykład funkcji RefString w przeglądarce Microsoft Edge.

Jak używać ciągu odwołania z niektórymi z naszych narzędzi do rozwiązywania problemów

Usługa Azure Front Door używa ciągu odwołania do zarządzania błędami 4xx i 5xx. Poniżej przedstawiono procedurę używania narzędzia diagnostycznego z ciągiem referencyjnym do śledzenia i diagnozowania problemów z łącznością:

  1. Przejdź do profilu usługi Azure Front Door.

  2. Wybierz menu Diagnozowanie i rozwiązywanie problemów.

    Zrzut ekranu przedstawiający pierwszy krok diagnozowania problemów przy użyciu ciągu odwołania.

  3. Przewiń w dół i wybierz pozycję Łączność w sekcji Typowe problemy .

    Zrzut ekranu przedstawiający drugi krok diagnozowania problemów przy użyciu ciągu odwołania.

  4. W polu Jaki problem występuje? wybierz pozycję Wybierz podtyp problemu, a następnie wybierz błędy 4xx i 5xx z menu rozwijanego, a następnie wybierz przycisk Dalej.

    Zrzut ekranu przedstawiający trzeci krok diagnozowania problemów przy użyciu ciągu odwołania.

  5. Wprowadź ciąg odwołania w polu w sekcji błędy 4xx i 5xx. Należy wprowadzić ciąg odwołania podany w żądaniu w polu Odwołanie do śledzenia — RefString .

    Zrzut ekranu przedstawiający czwarty krok diagnozowania problemów przy użyciu ciągu odwołania.

  6. Na koniec wybierz pozycję Uruchom diagnostykę , aby zidentyfikować przyczynę problemu, co wyjaśnia błąd, jeśli jest to znany problem.

    Przykładowy wynik przedstawiający problem:

    Zrzut ekranu przedstawiający przykład diagnostyki w pracy przy użyciu ciągu odwołania.

    Uwaga

    Możliwości diagnostyczne mogą wymagać do 15 minut w celu dostarczenia wyników. Prosimy o cierpliwość, aby umożliwić zakończenie procesu przed podjęciem dalszych działań.

Alternatywna opcja

Jeśli zdecydujesz się nie używać narzędzia diagnostycznego, możesz dołączyć ciąg odwołania podczas przesyłania biletu pomocy technicznej. Ponadto możesz włączyć funkcję Dzienniki dostępu, aby otrzymywać aktualizacje dotyczące danych RefString bezpośrednio w witrynie Azure Portal.

Aby uzyskać więcej informacji na temat śledzenia odwołań i parametrów dziennika dostępu, zobacz Monitorowanie metryk i dzienników w usłudze Azure Front Door, które wyróżnia określone pola w dziennikach dostępu, które ułatwiają identyfikowanie różnych typów błędów.

Następne kroki