Freigeben über

Verwenden des Live-Ablaufverfolgungstools für Azure SignalR Service

  • Artikel

Das Live-Ablaufverfolgungstool ist eine einzelne Webanwendung zum Erfassen und Anzeigen von Liveablaufverfolgungen im Azure SignalR-Dienst. Die Liveablaufverfolgungen können in Echtzeit ohne jede Abhängigkeit von anderen Diensten erfasst werden.

Sie können das Live-Ablaufverfolgungsfeature mit einer einzigen Auswahl aktivieren und deaktivieren. Sie können auch eine beliebige Protokollkategorie auswählen, an der Sie interessiert sind.

Hinweis

Liveablaufverfolgungen werden als ausgehende Nachrichten gezählt.

Die Verwendung der Microsoft Entra-ID für den Zugriff auf das Live-Ablaufverfolgungstool wird nicht unterstützt.

Öffnen des Live-Ablaufverfolgungstools

Wenn Sie einen Zugriffsschlüssel aktivieren, verwenden Sie ein Zugriffstoken, um das Live-Ablaufverfolgungstool zu authentifizieren. Andernfalls verwenden Sie die Microsoft Entra-ID, um das Tool zu authentifizieren.

Sie können überprüfen, ob Sie eine Zugriffstaste aktiviert haben, indem Sie in der Azure-Portal zur Seite "Schlüssel" für den Azure SignalR-Dienst wechseln.

Schritte, wenn Sie eine Zugriffstaste aktiviert haben

  1. Wechseln Sie zur Azure-Portal und Ihrer Azure SignalR-Dienstseite.
  2. Wählen Sie im linken Menü unter Überwachung die Option Einstellungen für die Live-Ablaufverfolgung aus.
  3. Wählen Sie Liveablaufverfolgung aktivieren aus.
  4. Wählen Sie die Schaltfläche "Speichern " aus, und warten Sie dann, bis die Änderungen wirksam werden.
  5. Wählen Sie Live-Ablaufverfolgungstool öffnen aus.

Screenshot of selections for opening the live trace tool.

Schritte, wenn Sie keine Zugriffstaste aktiviert haben

Zuweisen der API-Berechtigung zum Live-Ablaufverfolgungstool für sich selbst

  1. Wechseln Sie zur Azure-Portal und Ihrer Azure SignalR-Dienstseite.
  2. Wählen Sie die Option Zugriffssteuerung (IAM) aus.
  3. Wählen Sie auf der neuen Seite +Hinzufügen und dann "Rollenzuweisung" aus.
  4. Wählen Sie auf der neuen Seite die Registerkarte "Auftragsfunktionsrollen " aus, wählen Sie die Rolle "SignalR-Dienstbesitzer " und dann " Weiter" aus.
  5. Klicken Sie auf der Seite "Mitglieder " auf "+Mitglieder auswählen".
  6. Suchen Sie im neuen Bereich nach Mitgliedern, und wählen Sie sie aus, und klicken Sie dann auf "Auswählen".
  7. Wählen Sie "Überprüfen" und "Zuweisen" aus, und warten Sie auf die Benachrichtigung über den Abschluss.

Öffnen des Tools

  1. Wechseln Sie zur Azure-Portal und Ihrer Azure SignalR-Dienstseite.
  2. Wählen Sie im linken Menü unter Überwachung die Option Einstellungen für die Live-Ablaufverfolgung aus.
  3. Wählen Sie Liveablaufverfolgung aktivieren aus.
  4. Wählen Sie die Schaltfläche "Speichern " aus, und warten Sie dann, bis die Änderungen wirksam werden.
  5. Wählen Sie Live-Ablaufverfolgungstool öffnen aus.

Screenshot of opening the tool for live tracing.

Anmelden mit Ihrem Microsoft-Konto

  1. Wenn das Microsoft-Anmeldefenster im Live-Ablaufverfolgungstool geöffnet wird, geben Sie Ihre Anmeldeinformationen ein. Wenn kein Anmeldefenster angezeigt wird, achten Sie darauf, Popupfenster in Ihrem Browser zuzulassen.
  2. Warten Sie, bis "Bereit" auf der Statusleiste angezeigt wird.

Erfassen von Liveablaufverfolgungen

Im Live-Ablaufverfolgungstool haben Sie folgende Möglichkeiten:

  • Beginnen Sie mit der Erfassung von Echtzeit-Liveablaufverfolgungen aus der Azure SignalR-Dienstinstanz.
  • Löschen Sie die erfassten Echtzeit-Liveablaufverfolgungen.
  • Exportieren sie Liveablaufverfolgungen in eine Datei. Das derzeit unterstützte Dateiformat ist CSV.
  • Filtern Sie die erfassten Echtzeit-Liveablaufverfolgungen mit einem bestimmten Schlüsselwort (keyword). Trennzeichen (z. B. Leerzeichen, Komma oder Semikolon) werden, falls vorhanden, als Teil der Schlüsselwort (keyword) behandelt.

Screenshot of capturing live traces with the live trace tool.

Die Echtzeit-Liveablaufverfolgungen, die das Tool erfasst, enthalten detaillierte Informationen zur Problembehandlung.

Name BESCHREIBUNG
Zeit Protokollereigniszeit.
Protokollebene Protokollereignisebene: Trace, , Debug, Informational, , Warningoder Error.
Ereignisname Vorgangsname des Protokollereignisses.
Nachricht Detaillierte Meldung des Protokollereignisses.
Ausnahme Laufzeit-Ausnahme des Azure Web PubSub-Diensts.
Hub Benutzerdefinierter Hubname.
Verbinden ion-ID Identität der Verbindung.
Verbindungstyp Typ der Verbindung. Zulässige Werte sind Server (Verbindungen zwischen Server und Dienst) und Client (Verbindungen zwischen Client und Dienst).
Benutzer-ID Identität des Benutzers.
IP IP-Adresse des Clients.
Server Sticky Routingmodus des Clients. Zulässige Werte sind Disabled, Preferred und Required. Weitere Informationen finden Sie unter ServerStickyMode.
Transport Transport, den der Client zum Senden von HTTP-Anforderungen verwenden kann. Zulässige Werte sind WebSockets, ServerSentEvents und LongPolling. Weitere Informationen finden Sie unter HttpTransportType.
Nachrichtenablaufverfolgungs-ID Eindeutiger Bezeichner für eine Nachricht.
Routenvorlage Routenvorlage der API.
Http-Methode HTTP-Methode: POST, , GET, PUToder DELETE.
URL Uniform Resource Locator.
Ablaufverfolgungs-ID Eindeutiger Bezeichner, der eine Anforderung darstellt.
Statuscode HTTP-Antwortcode.
Dauer Dauer zwischen Empfang und Verarbeitung der Anforderung.
Headers Zusätzliche Informationen, die der Client und der Server mit einer HTTP-Anforderung oder -Antwort übergeben.
Aufruf-ID Eindeutiger Bezeichner, der einen Aufruf darstellt (nur für ASP.NET SignalR verfügbar).
Nachrichtentyp Typ der Nachricht. Beispiele hierfür sind BroadcastDataMessage, JoinGroupMessage und LeaveGroupMessage.

Nächste Schritte

Erfahren Sie, wie Sie häufige Probleme mit dem Live-Ablaufverfolgungstool behandeln:

  • Informationen zum Beheben typischer Probleme basierend auf Liveablaufverfolgungen finden Sie im Handbuch zur Problembehandlung.
  • Informationen zur Selbstdiagnose, um die Ursache direkt zu finden oder das Problem einzugrenzen, finden Sie in der Einführung in die Problembehandlungsmethoden.