Passen Sie die Aggregation von Netzwerkanfragedaten an

Firebase Performance Monitoring aggregiert automatisch Daten für ähnliche Netzwerkanfragen, um Ihnen zu helfen, Trends in der Leistung Ihrer Netzwerkanfragen zu verstehen.

Manchmal müssen Sie jedoch anpassen, wie Firebase bestimmte Netzwerkanfragedaten aggregiert, um die Anwendungsfälle Ihrer App besser zu unterstützen. Wir bieten Ihnen zwei Möglichkeiten, die Datenaggregation für Netzwerkanfragen anzupassen: Daten unter benutzerdefinierten URL-Mustern zu aggregieren und anzupassen, wie die Erfolgsrate berechnet wird .

Aggregieren Sie Daten nach benutzerdefinierten URL-Mustern

Bei jeder Anfrage prüft Firebase, ob die URL der Netzwerkanfrage mit einem URL-Muster übereinstimmt. Wenn die Anfrage-URL mit einem URL-Muster übereinstimmt, aggregiert Firebase die Daten der Anfrage automatisch unter dem URL-Muster.

Sie können benutzerdefinierte URL-Muster erstellen, um bestimmte URL-Muster zu überwachen, die Firebase mit dem abgeleiteten automatischen URL-Musterabgleich nicht erfasst. Sie können beispielsweise ein benutzerdefiniertes URL-Muster verwenden, um Fehler bei einer bestimmten URL zu beheben oder eine bestimmte Gruppe von URLs im Laufe der Zeit zu überwachen.

Firebase zeigt alle URL-Muster (einschließlich benutzerdefinierter URL-Muster) und ihre aggregierten Daten auf der Unterregisterkarte „Netzwerkanforderungen“ der Traces-Tabelle an, die sich unten im Leistungs- Dashboard der Firebase-Konsole befindet.

Wie funktioniert der benutzerdefinierte URL-Musterabgleich?

Firebase versucht, Anforderungs-URLs mit allen konfigurierten benutzerdefinierten URL-Mustern abzugleichen, bevor auf den automatischen URL-Musterabgleich zurückgegriffen wird. Für alle übereinstimmenden Anfragen mit einem benutzerdefinierten URL-Muster aggregiert Firebase die Daten der Anfragen unter dem benutzerdefinierten URL-Muster.

Wenn die URL einer Anfrage mit mehr als einem benutzerdefinierten URL-Muster übereinstimmt, ordnet Firebase die Anfrage gemäß der folgenden Spezifitätsreihenfolge nur dem spezifischsten benutzerdefinierten URL-Muster zu: einfacher Text > * > ** von links nach rechts im Pfad . Beispielsweise stimmt eine Anfrage an example.com/books/dog mit zwei benutzerdefinierten URL-Mustern überein:

  • example.com/books/*
  • example.com/*/dog

Allerdings ist das Muster example.com/books/* das spezifischste übereinstimmende URL-Muster, da das ganz linke Segment „ books in example.com/books/* Vorrang vor dem ganz linken Segment * in example.com/*/dog “ hat.

Beachten Sie beim Erstellen eines neuen benutzerdefinierten URL-Musters Folgendes:

  • Übereinstimmungen und aggregierte Daten aus früheren Anfragen werden durch die Erstellung eines neuen benutzerdefinierten URL-Musters nicht beeinflusst. Firebase aggregiert die Anforderungsdaten nicht rückwirkend neu.

  • Nur zukünftige Anfragen sind von der Erstellung eines neuen benutzerdefinierten URL-Musters betroffen. Möglicherweise müssen Sie bis zu 12 Stunden warten, bis Performance Monitoring Daten unter einem neuen benutzerdefinierten URL-Muster erfasst und aggregiert.

Erstellen Sie ein benutzerdefiniertes URL-Muster

Sie können ein benutzerdefiniertes URL-Muster über die Unterregisterkarte „Netzwerkanforderungen“ in der Traces-Tabelle erstellen, die sich unten im Leistungs- Dashboard der Firebase-Konsole befindet.

Ein Projektmitglied muss Eigentümer oder Bearbeiter sein, um ein neues benutzerdefiniertes URL-Muster zu erstellen. Alle Projektmitglieder können jedoch benutzerdefinierte URL-Muster und deren aggregierte Daten anzeigen.

Sie können insgesamt bis zu 400 benutzerdefinierte URL-Muster pro App und bis zu 100 benutzerdefinierte URL-Muster pro Domain für diese App erstellen.

Um ein benutzerdefiniertes URL-Muster zu erstellen, beginnen Sie mit einem Hostnamen, gefolgt von Pfadsegmenten. Der Hostname muss eine gültige Domäne enthalten und kann optional die Subdomäne enthalten. Verwenden Sie die folgende Pfadsegmentsyntax, um ein Muster zu erstellen, das mit URLs übereinstimmen kann.

  • Klartext – entspricht einer genauen Zeichenfolge
  • * – entspricht dem ersten Subdomain-Segment oder einer beliebigen Zeichenfolge in einem einzelnen Pfadsegment
  • ** – entspricht einem beliebigen Pfadsuffix

In der folgenden Tabelle werden einige mögliche benutzerdefinierte URL-Mustervergleiche beschrieben.

Passen... Erstellen Sie ein benutzerdefiniertes URL-Muster wie ... Beispielübereinstimmungen mit diesem URL-Muster
Eine genaue URL example.com/foo/baz example.com/foo/baz
Beliebiges einzelnes Pfadsegment ( * ) example.com/*/baz example.com/foo/baz
example.com/bar/baz
example.com/*/*/baz example.com/foo/bar/baz
example.com/bah/qux/baz
example.com/foo/* example.com/foo/baz
example.com/foo/bar

Hinweis: Dieses Muster stimmt nicht mit example.com/foo überein.

Ein beliebiges Pfadsuffix ( ** ) example.com/foo/** example.com/foo
example.com/foo/baz
example.com/foo/baz/more/segments
subdomain.example.com/foo.bar/** subdomain.example.com/foo.bar
subdomain.example.com/foo.bar/baz
subdomain.example.com/foo.bar/baz/more/segments
Das erste Subdomain-Segment ( * ) *.example.com/foo bar.example.com/foo
baz.example.com/foo

Zeigen Sie benutzerdefinierte URL-Muster und deren Daten an

Firebase zeigt alle URL-Muster (einschließlich benutzerdefinierter URL-Muster) und ihre aggregierten Daten auf der Unterregisterkarte „Netzwerkanforderungen“ der Traces-Tabelle an, die sich unten im Leistungs- Dashboard der Firebase-Konsole befindet.

Um nur benutzerdefinierte URL-Muster anzuzeigen, wählen Sie im Dropdown-Menü auf der Unterregisterkarte „Netzwerkanforderungen“ der Traces-Tabelle die Option „Benutzerdefinierte Muster“ aus. Beachten Sie: Wenn ein benutzerdefiniertes URL-Muster keine aggregierten Daten enthält, wird es nur in dieser Liste angezeigt.

Wenn der Datenaufbewahrungszeitraum für die unter einem URL-Muster aggregierten Daten endet, löscht Firebase diese Daten aus dem URL-Muster. Wenn alle unter einem benutzerdefinierten URL-Muster aggregierten Daten ablaufen, löscht Firebase das benutzerdefinierte URL-Muster nicht aus der Firebase-Konsole. Stattdessen listet Firebase weiterhin „leere“ benutzerdefinierte URL-Muster in der Liste „Benutzerdefinierte Muster“ der Unterregisterkarte „Netzwerkanforderungen“ der Traces-Tabelle auf.

Entfernen Sie ein benutzerdefiniertes URL-Muster

Sie können benutzerdefinierte URL-Muster aus Ihrem Projekt entfernen. Beachten Sie, dass Sie ein automatisches URL-Muster nicht entfernen können.

  1. Scrollen Sie im Performance- Dashboard nach unten zur Traces-Tabelle und wählen Sie dann die Unterregisterkarte „Netzwerkanforderungen“ aus.

  2. Wählen Sie im Dropdown-Menü auf der Unterregisterkarte „Netzwerkanforderungen“ die Option „Benutzerdefinierte Muster“ aus.

  3. Bewegen Sie den Mauszeiger über die Zeile des benutzerdefinierten URL-Musters, das Sie entfernen möchten.

  4. Klicken Sie ganz rechts in der Zeile auf , wählen Sie „Benutzerdefiniertes Muster entfernen“ aus und bestätigen Sie dann das Entfernen im Dialogfeld.

Beachten Sie beim Entfernen eines benutzerdefinierten URL-Musters Folgendes:

  • Alle zukünftigen Anfragen werden dem nächstspezifischsten passenden benutzerdefinierten URL-Muster zugeordnet. Wenn Firebase keine passenden benutzerdefinierten URL-Muster findet, greift es auf den automatischen URL-Mustervergleich zurück.

  • Übereinstimmungen und aggregierte Daten aus früheren Anfragen sind durch das Entfernen eines benutzerdefinierten URL-Musters nicht betroffen.

    Sie können bis zum Ende des geltenden Datenaufbewahrungszeitraums weiterhin auf ein entferntes benutzerdefiniertes URL-Muster und seine aggregierten Daten auf der Unterregisterkarte „Netzwerkanfragen“ zugreifen (wobei „Alle Netzwerkanfragen“ ausgewählt ist). Wenn alle aggregierten Daten unter dem entfernten benutzerdefinierten URL-Muster ablaufen, löscht Firebase das benutzerdefinierte URL-Muster.

  • Auf der Unterregisterkarte „Netzwerkanfragen“ (mit ausgewählter Option „Benutzerdefinierte Muster“ ) werden keine entfernten benutzerdefinierten URL-Muster aufgeführt.

Nächste Schritte

  • Richten Sie Benachrichtigungen für Netzwerkanfragen ein , die die Leistung Ihrer App beeinträchtigen. Sie können beispielsweise eine E-Mail-Benachrichtigung für Ihr Team konfigurieren, wenn die Antwortzeit für ein bestimmtes URL-Muster einen von Ihnen festgelegten Schwellenwert überschreitet.

Passen Sie an, wie die Erfolgsquote berechnet wird

Eine der Metriken, die Firebase für jede Netzwerkanfrage überwacht, ist die Erfolgsquote der Anfrage. Die Erfolgsquote ist der Prozentsatz der erfolgreichen Antworten im Vergleich zur Gesamtantwort. Diese Metrik hilft Ihnen, Netzwerk- und Serverausfälle zu messen.

Konkret zählt Firebase automatisch Netzwerkanfragen mit einem Antwortcode im Bereich von 100 bis 399 als erfolgreiche Antworten.

Sie können die Berechnung der Erfolgsquote anpassen, indem Sie zusätzlich zu den Antwortcodes, die Firebase automatisch als erfolgreich zählt, bestimmte Fehlercodes als „erfolgreiche Antworten“ zählen.

Wenn Ihre App beispielsweise über eine Suchendpunkt-API verfügt, können Sie 404-Antworten als „erfolgreich“ zählen, da für einen Suchendpunkt 404-Antworten erwartet werden. Angenommen, es gibt jede Stunde 100 Stichproben für diesen Suchendpunkt, und 60 davon sind 200-Antworten und 40 davon sind 404-Antworten. Bevor Sie die Erfolgsquote konfigurieren, beträgt die Erfolgsquote 60 %. Nachdem Sie die Berechnung der Erfolgsquote so konfiguriert haben, dass 404 Antworten als erfolgreich gezählt werden, beträgt die Erfolgsquote 100 %.

Konfigurieren Sie die Berechnung der Erfolgsquote

Um die Erfolgsratenberechnung für ein Netzwerk-URL-Muster zu konfigurieren, müssen Sie über die Berechtigung firebaseperformance.config.update verfügen. Die folgenden Rollen umfassen standardmäßig diese erforderliche Berechtigung: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin und Projektbesitzer oder -editor .

  1. Gehen Sie in der Firebase-Konsole zur Registerkarte „Performance Monitoring Dashboard“ und wählen Sie dann die App aus, für die Sie eine Erfolgsratenberechnung konfigurieren möchten.
  2. Scrollen Sie nach unten zur Traces-Tabelle am unteren Bildschirmrand und wählen Sie die Registerkarte Netzwerkanforderungen aus.
  3. Suchen Sie das URL-Muster, für das Sie die Berechnung der Erfolgsquote konfigurieren möchten.
  4. Öffnen Sie ganz rechts in der Zeile das Überlaufmenü ( ) und wählen Sie Erfolgsrate konfigurieren aus .
  5. Befolgen Sie die Anweisungen auf dem Bildschirm, um Antwortcodes auszuwählen, die Sie als erfolgreiche Antwortcodes zählen möchten.