Firebase Performance Monitoring aggregiert automatisch Daten für ähnliche Netzwerkanfragen, damit Sie Trends bei der Leistung Ihrer Netzwerkanfragen besser nachvollziehen können.
Manchmal müssen Sie jedoch anpassen, wie Firebase bestimmte Netzwerkanfragedaten zusammenfasst, um die Anwendungsfälle Ihrer App besser zu unterstützen. Wir bieten zwei Möglichkeiten, die Datenaggregation für Netzwerkanfragen anzupassen: Daten nach benutzerdefinierten URL-Mustern zusammenfassen und Berechnung der Erfolgsquote anpassen.
Daten nach benutzerdefinierten URL-Mustern zusammenfassen
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, werden die Daten der Anfrage automatisch unter dem URL-Muster zusammengefasst.
Sie können benutzerdefinierte URL-Muster erstellen, um bestimmte URL-Muster zu erfassen, die von Firebase nicht mit der abgeleiteten automatischen URL-Musterübereinstimmung erfasst werden. Sie können beispielsweise ein benutzerdefiniertes URL-Muster verwenden, um Fehler für eine bestimmte URL zu beheben oder eine bestimmte Gruppe von URLs im Zeitverlauf zu überwachen.
Firebase zeigt alle URL-Muster (einschließlich benutzerdefinierter URL-Muster) und die zugehörigen zusammengefassten Daten im Untertab Netzwerkanfragen der Tabelle mit den Protokollen an, der sich unten im Dashboard „Leistung“ der Firebase Console befindet.
Wie funktioniert die Übereinstimmung mit benutzerdefinierten URL-Mustern?
Firebase versucht, Anfrage-URLs mit konfigurierten benutzerdefinierten URL-Mustern abzugleichen, bevor auf die automatische URL-Musterübereinstimmung zurückgegriffen wird. Bei Anfragen, die mit einem benutzerdefinierten URL-Muster übereinstimmen, werden die Daten der Anfragen in Firebase unter dem benutzerdefinierten URL-Muster zusammengefasst.
Wenn die URL einer Anfrage mit mehreren benutzerdefinierten URL-Mustern übereinstimmt, weist Firebase die Anfrage gemäß der folgenden Reihenfolge der Spezifität nur dem spezifischsten benutzerdefinierten URL-Muster zu: Nur-Text > * > ** von links nach rechts im Pfad. Eine Anfrage an example.com/books/dog entspricht beispielsweise zwei benutzerdefinierten URL-Mustern:
example.com/books/*example.com/*/dog
Das Muster example.com/books/* ist jedoch das spezifischste übereinstimmende URL-Muster, da das linkeste Segment books in example.com/books/* Vorrang vor dem linkesten Segment * in example.com/*/dog hat.
Beachten Sie beim Erstellen eines benutzerdefinierten URL-Musters Folgendes:
Übereinstimmungen und aggregierte Daten aus vorherigen Anfragen sind davon nicht betroffen. Firebase aggregiert Anfragedaten nicht rückwirkend noch einmal.
Das Erstellen eines neuen benutzerdefinierten URL-Musters wirkt sich nur auf zukünftige Anfragen aus. Es kann bis zu 12 Stunden dauern, bis Performance Monitoring Daten nach einem neuen benutzerdefinierten URL-Muster erfasst und zusammengefasst hat.
Benutzerdefiniertes URL-Muster erstellen
Sie können ein benutzerdefiniertes URL-Muster auf dem Untertab Netzwerkanfragen in der Tabelle mit den Traces erstellen, die sich unten im Dashboard „Leistung“ der Firebase-Konsole befindet.
Projektmitglieder müssen die Rolle Inhaber oder Bearbeiter haben, um ein neues benutzerdefiniertes URL-Muster zu erstellen. Alle Projektmitglieder können sich jedoch benutzerdefinierte URL-Muster und die zugehörigen aggregierten Daten ansehen.
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.
Wenn Sie ein benutzerdefiniertes URL-Muster erstellen möchten, beginnen Sie mit einem Hostnamen, gefolgt von Pfadsegmenten. Der Hostname muss eine gültige Domain enthalten und kann optional die Subdomain enthalten. Verwenden Sie die folgende Syntax für Pfadsegmente, um ein Muster zu erstellen, das mit URLs abgeglichen werden kann.
- Nur Text: Es wird eine genaue Übereinstimmung mit einem String gefunden.
*– entspricht dem ersten Subdomain-Segment oder einem beliebigen String in einem einzelnen Pfadsegment**– entspricht einem beliebigen Pfadsuffix
In der folgenden Tabelle werden einige mögliche Übereinstimmungen mit benutzerdefinierten URL-Mustern beschrieben.
| Abgleich | Erstellen Sie ein benutzerdefiniertes URL-Muster wie… | Beispiele für Übereinstimmungen mit diesem URL-Muster |
|---|---|---|
| Eine exakte URL | example.com/foo/baz |
example.com/foo/baz
|
Ein einzelnes Pfadsegment (*) |
example.com/*/baz |
example.com/foo/bazexample.com/bar/baz
|
example.com/*/*/baz |
example.com/foo/bar/bazexample.com/bah/qux/baz
|
|
example.com/foo/* |
example.com/foo/bazexample.com/foo/bar
Hinweis:Dieses Muster passt nicht zu |
|
Ein beliebiges Pfadsuffix (**) |
example.com/foo/** |
example.com/fooexample.com/foo/bazexample.com/foo/baz/more/segments
|
subdomain.example.com/foo.bar/** |
subdomain.example.com/foo.barsubdomain.example.com/foo.bar/bazsubdomain.example.com/foo.bar/baz/more/segments
|
|
Das erste Subdomain-Segment (*) |
*.example.com/foo |
bar.example.com/foobaz.example.com/foo |
Benutzerdefinierte URL-Muster und ihre Daten ansehen
Firebase zeigt alle URL-Muster (einschließlich benutzerdefinierter URL-Muster) und die zugehörigen zusammengefassten Daten im Untertab Netzwerkanfragen der Tabelle mit den Traces an, der sich unten im Dashboard „Leistung“ der Firebase Console befindet.
Wenn Sie nur benutzerdefinierte URL-Muster sehen möchten, wählen Sie im Drop-down-Menü auf dem Untertab Netzwerkanfragen der Traces-Tabelle die Option Benutzerdefinierte Muster aus. Wenn für ein benutzerdefiniertes URL-Muster keine aggregierten Daten vorhanden sind, wird es nur in dieser Liste angezeigt.
Wenn die Aufbewahrungsdauer für die Daten abgelaufen ist, die unter einem URL-Muster zusammengefasst wurden, werden diese Daten von Firebase aus dem URL-Muster gelöscht. Wenn alle Daten, die unter einem benutzerdefinierten URL-Muster zusammengefasst wurden, ablaufen, wird das benutzerdefinierte URL-Muster nicht aus der Firebase Console gelöscht. Stattdessen werden in Firebase weiterhin „leere“ benutzerdefinierte URL-Muster in der Liste Benutzerdefinierte Muster auf dem Untertab Netzwerkanfragen der Traces-Tabelle aufgeführt.
Benutzerdefiniertes URL-Muster entfernen
Sie können benutzerdefinierte URL-Muster aus Ihrem Projekt entfernen. Sie können automatische URL-Muster nicht entfernen.
Scrollen Sie im Dashboard Leistung nach unten zur Tabelle mit den Traces und wählen Sie den Untertab Netzwerkanfragen aus.
Wählen Sie auf dem Untertab Netzwerkanfragen im Drop-down-Menü die Option Benutzerdefinierte Muster aus.
Bewegen Sie den Mauszeiger auf die Zeile mit dem benutzerdefinierten URL-Muster, das Sie entfernen möchten.
Klicken Sie ganz rechts in der Zeile auf , wählen Sie Benutzerdefiniertes Muster entfernen aus und bestätigen Sie das Entfernen im Dialogfeld.
Beachten Sie beim Entfernen eines benutzerdefinierten URL-Musters Folgendes:
Alle zukünftigen Anfragen werden dem nächsten spezifischen benutzerdefinierten URL-Muster zugeordnet, mit dem sie übereinstimmen. Wenn Firebase keine übereinstimmenden benutzerdefinierten URL-Muster findet, wird auf die automatische Übereinstimmung mit URL-Mustern zurückgegriffen.
Übereinstimmungen und aggregierte Daten aus vorherigen Anfragen sind vom Entfernen eines benutzerdefinierten URL-Musters nicht betroffen.
Sie können bis zum Ende des entsprechenden Zeitraums für die Datenaufbewahrung weiterhin auf ein entferntes benutzerdefiniertes URL-Muster und die zugehörigen aggregierten Daten auf dem Untertab Netzwerkanfragen zugreifen (Alle Netzwerkanfragen muss ausgewählt sein). Wenn alle zusammengefassten Daten unter dem entfernten benutzerdefinierten URL-Muster ablaufen, löscht Firebase das benutzerdefinierte URL-Muster.
Auf dem Untertab Netzwerkanfragen (mit ausgewählter Option Benutzerdefinierte Muster) sind 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 Grenzwert überschreitet.
Berechnung der Erfolgsquote anpassen
Einer der Messwerte, die Firebase für jede Netzwerkanfrage überwacht, ist die Erfolgsquote der Anfrage. Die Erfolgsquote ist der Prozentsatz der erfolgreichen Antworten im Vergleich zur Gesamtzahl der Antworten. Mit diesem Messwert können Sie Netzwerk- und Serverausfälle messen.
Insbesondere werden Netzwerkanfragen mit einem Antwortcode im Bereich von 100 bis 399 von Firebase automatisch als erfolgreiche Antworten gezählt.
Sie können die Berechnung der Erfolgsquote anpassen, indem Sie bestimmte Fehlercodes zusätzlich zu den Antwortcodes, die Firebase automatisch als erfolgreich zählt, als „erfolgreiche Antworten“ zählen.
Wenn Ihre App beispielsweise eine API für einen Suchendpunkt hat, können Sie 404-Antworten als „erfolgreich“ zählen, da für einen Suchendpunkt 404-Antworten erwartet werden. Angenommen, es gibt jede Stunde 100 Beispiele für diesen Suchendpunkt, von denen 60 eine Antwort mit dem Statuscode 200 und 40 eine Antwort mit dem Statuscode 404 sind. Bevor Sie die Erfolgsquote konfigurieren, beträgt sie 60%. Wenn Sie die Berechnung der Erfolgsquote so konfigurieren, dass 404-Antworten als erfolgreich gezählt werden, beträgt die Erfolgsquote 100%.
Berechnung der Erfolgsquote konfigurieren
Um die Berechnung der Erfolgsquote für ein Netzwerk-URL-Muster zu konfigurieren, benötigen Sie die Berechtigung firebaseperformance.config.update. Die folgenden Rollen umfassen diese erforderliche Berechtigung standardmäßig: Firebase-Leistungsadministrator, Firebase-Qualitätsadministrator, Firebase-Administrator und Projektinhaber oder ‑bearbeiter.
- Rufen Sie in der Firebase-Konsole den Tab Performance Monitoring Dashboard auf und wählen Sie die App aus, für die Sie eine Berechnung der Erfolgsquote konfigurieren möchten.
- Scrollen Sie unten auf dem Bildschirm zur Tabelle mit den Traces und wählen Sie den Tab Netzwerkanfragen aus.
- Suchen Sie das URL-Muster, für das Sie die Berechnung der Erfolgsquote konfigurieren möchten.
- Öffnen Sie ganz rechts in der Zeile das Dreipunkt-Menü und wählen Sie Erfolgsrate konfigurieren aus.
- Folgen Sie der Anleitung auf dem Bildschirm, um Antwortcodes auszuwählen, die als erfolgreiche Antwortcodes gezählt werden sollen.