Freigeben über

Problembehandlung von Azure Front Door mit RefString

  • Artikel

Eine Anleitung zum Verstehen und Verwenden von RefStrings zum Diagnostizieren und Beheben von Problemen mit Azure Front Door.

Voraussetzungen

Was ist ein RefString?

Eine RefString ist eine kurze Zeichenfolge, die von Azure Front Door an die HTTP-Antwortheader jeder Anforderung angefügt wird. Sie enthält Details dazu, wie die Anforderung verarbeitet wurde, einschließlich des Anwesenheitspunkts (Point of Presence, POP) und des Back-End-Status.

RefStrings können Ihnen helfen, Probleme mit Azure Front Door zu beheben, z. B. Cachefehler, Routingfehler, Back-End-Fehler und Latenzprobleme. Sie können die Grundursache identifizieren und geeignete Maßnahmen ergreifen, um sie zu beheben, indem Sie die RefStrings der Anforderungen analysieren.

Hinweis

Wenn Sie auf eine Fehlerseite von Microsoft-Diensten treffen, enthält sie bereits eine RefString für die Anforderung, welche die Fehlerseite generiert hat. In solchen Fällen können Sie direkt zum Diagnoseschritt springen.

So sammeln Sie eine RefString

Um eine RefString zu sammeln, müssen Sie die HTTP-Antwortheader der Anforderungen erfassen und nach dem Header mit Namen X-Azure-Ref suchen. Dieser Header enthält die in Base64 codierte RefString. Sie können unterschiedliche Methoden verwenden, um die HTTP-Antwortheader zu erfassen, abhängig von Ihrer Vorliebe und Situation. Hier sind einige Beispiele für das Abrufen einer RefString aus verschiedenen Browsern und Anwendungen:

  1. Öffnen Sie die Entwicklertools des Browsers, indem Sie F12 oder Ctrl+Shift+I drücken.

  2. Wechseln Sie zur Registerkarte Netzwerk.

  3. Aktualisieren Sie die Seite, oder führen Sie die Aktion aus, welche die Anforderung auslöst.

  4. Suchen Sie die spezifische Anforderung in der Liste, und suchen Sie den Header X-Azure-Ref im Antwortheaderabschnitt.

  5. Kopieren Sie den Wert des Headers X-Azure-Ref, um ihn mit dem Tool zur Problembehandlung von RefString im Azure-Portal zu verwenden.

Weitere Informationen finden Sie unter Überprüfen der Netzwerkaktivität – Microsoft Edge-Entwicklerdokumentation.

Beispiel für das Abrufen einer RefString aus dem Microsoft Edge-Browser:

Screenshot des RefString-Beispiels im Microsoft Edge-Browser.

Verwenden einer RefString mit einigen unserer Problembehandlungstools

Azure Front Door verwendet eine RefString zum Verwalten von 4xx- und 5xx-Fehlern. Im Folgenden sind die Schritte zum Verwenden des Diagnosetools mit einer RefString zum Nachverfolgen und Diagnostizieren von Verbindungsproblemen aufgeführt:

  1. Navigieren Sie zu Ihrem Azure Front Door-Profil.

  2. Wählen Sie das Menü Probleme diagnostizieren und beheben aus.

    Screenshot zeigt den ersten Schritt bei der Diagnose von Problemen mithilfe einer RefString.

  3. Scrollen Sie nach unten, und wählen Sie im Abschnitt Allgemeine Probleme die Option Konnektivität aus.

    Screenshot zeigt den zweiten Schritt bei der Diagnose von Problemen mithilfe einer RefString.

  4. Wählen Sie im Feld Welches Problem haben Sie? die Option Wählen Sie einen Problemuntertyp aus und wählen Sie im Dropdownmenü 4xx- und 5xx-Fehler, und wählen Sie dann Weiter aus.

    Screenshot zeigt den dritten Schritt bei der Diagnose von Problemen mit einem RefString.

  5. Geben Sie Ihre RefString in das Feld im Abschnitt 4xx- und 5xx-Fehler ein. Sie geben die von Ihrer Anforderung erhaltene RefString unter dem Feld Nachverfolgungsverweis – RefString ein.

    Screenshot zeigt den vierten Schritt bei der Diagnose von Problemen mit einem RefString.

  6. Wählen Sie abschließend Diagnose ausführen aus, um die Ursache des Problems zu identifizieren, wodurch der Fehler erläutert wird, wenn es sich um ein bekanntes Problem handelt.

    Ein Beispiel für ein Ergebnis, das ein Problem anzeigt:

    Screenshot zeigt ein Beispiel für die Diagnose bei der Arbeit mit einem RefString.

    Hinweis

    Die Diagnosemöglichkeiten können bis zu 15 Minuten beanspruchen, um Ergebnisse zu liefern. Wir bitten Sie um Geduld, damit der Vorgang abgeschlossen werden kann, bevor Sie weitere Maßnahmen ergreifen.

Alternativoption

Wenn Sie sich entscheiden, das Diagnosetool nicht zu verwenden, können Sie beim Übermitteln eines Supporttickets eine RefString einschließen. Darüber hinaus können Sie das Feature Zugriffsprotokolle aktivieren, um Updates für RefString-Daten direkt im Azure-Portal zu erhalten. Weitere Informationen zum Nachverfolgen von Verweisen und Zugriffsprotokollparametern finden Sie unter Überwachen von Metriken und Protokollen in Azure Front Door.

In diesem Artikel werden bestimmte Felder in Zugriffsprotokollen erläutert, die dabei helfen, verschiedene Arten von Fehlern zu identifizieren:

  • Cachefehler: RefString gibt an, ob eine Anforderung aus dem Cache bereitgestellt wurde, und gibt Gründe an, wenn dies nicht der Fall war.

    Beispiel: NOCACHE bedeutet, dass die Anforderung nicht für die Zwischenspeicherung berechtigt war, MISS bedeutet, dass kein gültiger Cacheeintrag vorhanden war, und STALE bedeutet, dass der Cacheeintrag abgelaufen war.

  • Routingfehler: RefString kann darüber Aufschluss geben, ob eine Anforderung ordnungsgemäß an das Back-End weitergeleitet wurde und aus welchem Grund.

    Beispiel: FALLBACK bedeutet, dass die Daten aufgrund von Problemen mit dem primären Back-End umgeleitet werden, und OVERRIDE bedeutet, dass sie entgegen den Routingregeln an ein alternatives Back-End weitergeleitet werden.

  • Back-End-Fehler: RefString gibt an, ob die Übermittlung an das Back-End erfolgreich war, und erläutert alle Probleme.

    Beispiel: TIMEOUT bedeutet, dass die Antwort zu lang dauerte, CONNFAIL bedeutet, dass die Verbindung fehlgeschlagen war, und ERROR gibt eine Fehlerantwort aus dem Back-End an.

  • Latenzprobleme: RefString detailliert die Verarbeitungszeit und die Dauer der einzelnen Phasen von Azure Front Door.

    Beispiel: DURATION zeigt die Gesamtbehandlungszeit an, RTT zeigt die RTT an, und TTFB zeigt die Zeit an, die zum Empfangen des ersten Byte aus dem Back-End benötigt wurde.

Nächste Schritte