Firebase is back at Google I/O on May 10! Register now

Passen Sie die Aggregation von Netzwerkanfragedaten an

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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

Manchmal müssen Sie jedoch anpassen, wie Firebase bestimmte Netzwerkanforderungsdaten aggregiert, um die Anwendungsfälle Ihrer App besser zu unterstützen. Wir bieten zwei Möglichkeiten zum Anpassen der Datenaggregation für Netzwerkanfragen: Aggregieren von Daten unter benutzerdefinierten URL-Mustern und Anpassen der Berechnung der Erfolgsrate .

Aggregieren Sie Daten unter benutzerdefinierten URL-Mustern

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

Sie können benutzerdefinierte URL-Muster erstellen, um bestimmte URL-Muster zu überwachen, die Firebase mit seinem 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 Ablaufverfolgungstabelle 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 Anforderungen an ein benutzerdefiniertes URL-Muster aggregiert Firebase die Daten der Anforderungen 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

Das Muster example.com/books/* ist jedoch das spezifischste übereinstimmende URL-Muster, da das Segment books ganz links in example.com/books/* Vorrang vor dem Segment ganz links * 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 das Erstellen eines neuen benutzerdefinierten URL-Musters nicht beeinflusst. Firebase aggregiert Anfragedaten nicht rückwirkend neu.

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

Erstellen Sie ein benutzerdefiniertes URL-Muster

Sie können ein benutzerdefiniertes URL-Muster auf der Unterregisterkarte Netzwerkanforderungen in der Ablaufverfolgungstabelle 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 ihre aggregierten 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 Syntax für Pfadsegmente, um ein Muster zu erstellen, das mit URLs übereinstimmen kann.

  • Einfacher Text – stimmt mit einer exakten Zeichenfolge überein
  • * – stimmt mit dem ersten Subdomain-Segment oder einer beliebigen Zeichenfolge in einem einzelnen Pfadsegment überein
  • ** — stimmt mit einem beliebigen Pfadsuffix überein

In der folgenden Tabelle werden einige mögliche Übereinstimmungen mit benutzerdefinierten URL-Mustern 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 ihre Daten an

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

Um nur benutzerdefinierte URL-Muster anzuzeigen, wählen Sie Benutzerdefinierte Muster aus dem Dropdown-Menü auf der Unterregisterkarte Netzwerkanforderungen der Ablaufverfolgungstabelle aus. Beachten Sie, dass ein benutzerdefiniertes URL-Muster, das keine aggregierten Daten enthält, nur in dieser Liste angezeigt wird.

Wenn die Datenaufbewahrungsfrist 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 auf der Unterregisterkarte Netzwerkanforderungen der Ablaufverfolgungstabelle 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 Leistungs- Dashboard nach unten zur Ablaufverfolgungstabelle 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 Anforderungen werden dem nächstspezifischsten übereinstimmenden benutzerdefinierten URL-Muster zugeordnet. Wenn Firebase keine übereinstimmenden benutzerdefinierten URL-Muster findet, greift es auf den automatischen URL-Musterabgleich zurück .

  • Übereinstimmungen und aggregierte Daten aus früheren Anfragen werden durch das Entfernen eines benutzerdefinierten URL-Musters nicht beeinträchtigt.

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

  • Auf der Unterregisterkarte Netzwerkanforderungen (mit ausgewählten benutzerdefinierten Mustern ) werden keine entfernten benutzerdefinierten URL-Muster aufgeführt.

Nächste Schritte

  • Richten Sie Warnungen 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 Erfolgsrate berechnet wird

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

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

Sie können die Berechnung der Erfolgsrate 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 Erfolgsrate konfigurieren, beträgt die Erfolgsrate 60 %. Nachdem Sie die Erfolgsratenberechnung so konfiguriert haben, dass 404-Antworten als erfolgreich gezählt werden, beträgt die Erfolgsrate 100 %.

Erfolgsratenberechnung konfigurieren

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 beinhalten diese erforderliche Berechtigung standardmäßig: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin und Project Owner or Editor .

  1. Wechseln Sie in der Firebase-Konsole zur Registerkarte Leistungsüberwachungs -Dashboard und wählen Sie dann die App aus, für die Sie eine Erfolgsratenberechnung konfigurieren möchten.
  2. Scrollen Sie nach unten zur Ablaufverfolgungstabelle am unteren Rand des Bildschirms und wählen Sie die Registerkarte Netzwerkanforderungen aus.
  3. Suchen Sie das URL-Muster, für das Sie die Erfolgsratenberechnung 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.