Datenaggregation für Netzwerkanfrage anpassen

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

Firebase prüft bei jeder Anfrage, ob die URL der Netzwerkanfrage mit einem URL-Muster: Wenn die Anfrage-URL mit einem URL-Muster übereinstimmt, aggregiert Firebase die Anfragedaten unterhalb des URL-Musters.

Sie können benutzerdefinierte URL-Muster erstellen, um bestimmte URL-Muster zu überwachen, Firebase erfasst keine Daten mit dem abgeleiteten automatischen URL-Muster zu Übereinstimmungen. 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 deren zusammengefasste Daten auf dem Unter-Tab Netzwerkanfragen der Trace-Tabelle. unten im Menü Dashboard zur Leistungsüberwachung der Firebase-Konsole.

Wie funktioniert der benutzerdefinierte URL-Musterabgleich?

Firebase versucht, Anfrage-URLs mit konfigurierten benutzerdefinierten URL-Mustern abzugleichen bevor auf den automatischen URL-Musterabgleich zurückgegriffen wird. Bei übereinstimmenden Anfragen benutzerdefinierten URL-Muster hinzufügen, aggregiert Firebase die Daten unter der benutzerdefinierten URL-Muster.

Wenn die URL einer Anfrage mit mehr als einem benutzerdefinierten URL-Muster übereinstimmt, ordnet Firebase das Element nur das spezifischste benutzerdefinierte URL-Muster anfordern, gemäß der folgende Spezifitätsreihenfolge: plain text > * > ** von links nach direkt im Pfad. Eine Anfrage an example.com/books/dog stimmt z. B. überein, zwei benutzerdefinierte URL-Muster:

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

Das Muster example.com/books/* ist das spezifischste übereinstimmende URL-Muster, da die Das Segment books ganz links in example.com/books/* hat Vorrang vor dem Segment Segment ganz links in example.com/*/dog *.

Beachten Sie beim Erstellen eines benutzerdefinierten URL-Musters Folgendes:

  • Übereinstimmungen und aggregierte Daten aus vorherigen Anfragen sind nicht betroffen von ein neues benutzerdefiniertes URL-Muster erstellt. Firebase wird nicht rückwirkend Anfragedaten neu aggregieren.

  • Nur zukünftige Anfragen sind vom Erstellen eines neuen benutzerdefinierten URL-Musters betroffen. 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

Ein benutzerdefiniertes URL-Muster können Sie über den Unter-Tab Netzwerkanfragen auf der Traces-Tabelle am Ende der Dashboard zur Leistungsüberwachung der Firebase-Konsole.

Ein Projektmitglied muss Inhaber oder Bearbeiter sein, um Sie erstellen ein neues benutzerdefiniertes URL-Muster. Alle Projektmitglieder können jedoch benutzerdefinierte URL-Muster und ihre aggregierten Daten.

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 der Subdomain. Verwenden Sie die folgende Pfadsegmentsyntax, um ein Muster zu erstellen, mit URLs übereinstimmen.

  • Nur-Text: entspricht einem genauen String
  • *: entspricht dem ersten Subdomainsegment oder einem String in einem einzelnen Pfadsegment
  • ** – entspricht einem beliebigen Pfadsuffix

In der folgenden Tabelle werden einige potenzielle benutzerdefinierte URL-Musterübereinstimmungen beschrieben.

Übereinstimmung... 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
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 überein. example.com/foo
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

Benutzerdefinierte URL-Muster und die dazugehörigen Daten ansehen

Firebase zeigt alle URL-Muster, einschließlich benutzerdefinierter URL-Muster, und deren zusammengefasste Daten auf dem Unter-Tab Netzwerkanfragen der Trace-Tabelle. unten im Menü Dashboard zur Leistungsüberwachung der Firebase-Konsole.

Wenn Sie nur benutzerdefinierte URL-Muster anzeigen möchten, wählen Sie im Drop-down-Menü Benutzerdefinierte Muster aus. der Trace-Tabelle auf dem Untertab Netzwerkanfragen. Wenn für ein benutzerdefiniertes URL-Muster keine aggregierten Daten vorhanden sind, wird es nur in dieser Liste angezeigt.

Wann die Aufbewahrungsdauer 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 zusammengefassten Daten abläuft, löscht Firebase das benutzerdefinierte URL-Muster nicht aus dem Firebase-Konsole. Stattdessen wird in Firebase weiterhin "leer" aufgelistet. benutzerdefinierte URL in der Liste Benutzerdefinierte Muster des Unter-Tabs Netzwerkanfragen Traces-Tabelle.

Benutzerdefiniertes URL-Muster entfernen

Sie können benutzerdefinierte URL-Muster aus Ihrem Projekt entfernen. Sie können automatische URL-Muster nicht entfernen.

  1. Klicken Sie auf der Seite Leistung Dashboard, Scrollen Sie nach unten zur Tabelle mit den Traces und wählen Sie den Unter-Tab Netzwerkanfragen aus.

  2. Wählen Sie im Drop-down-Menü unter Netzwerkanfragen die Option Benutzerdefinierte Muster aus. Untertab öffnen.

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

  4. Klicken Sie auf ganz rechts im wählen Sie Benutzerdefiniertes Muster entfernen aus und bestätigen Sie das Entfernen im Dialogfeld.

Wenn Sie ein benutzerdefiniertes URL-Muster entfernen, beachten Sie Folgendes:

  • Alle zukünftigen Anfragen werden der nächsten spezifischsten Übereinstimmung zugeordnet. benutzerdefiniertes URL-Muster. Wenn Firebase keine übereinstimmenden benutzerdefinierten URL-Muster findet, gilt Folgendes: wird auf den automatischen URL-Musterabgleich 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 Aggregierte Daten nach dem entfernten benutzerdefinierten URL-Muster laufen ab, Firebase Dadurch wird das benutzerdefinierte URL-Muster gelöscht.

  • Auf dem Unter-Tab Netzwerkanfragen (bei dem die Option Benutzerdefinierte Muster ausgewählt ist) werden entfernte benutzerdefinierte URL-Muster aufgelistet.

Nächste Schritte

Berechnung der Erfolgsquote anpassen

Einer der Messwerte, die Firebase für jede Netzwerkanfrage überwacht, ist der die Erfolgsquote der Anfrage ab. Die Erfolgsquote ist der Prozentsatz der erfolgreichen Antworten. verglichen mit der Gesamtzahl der Antworten. Mit diesem Messwert können Sie Netzwerk- und Serverdaten Störungen.

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 zählen. als „erfolgreiche Antworten“ zusätzlich zu den Antwortcodes, die Firebase gilt automatisch als erfolgreich.

Wenn Ihre Anwendung beispielsweise eine Suchendpunkt-API hat, können Sie 404 Antworten zählen. als „erfolgreich“ gekennzeichnet. 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 %. Nach der Konfiguration des Erfolgs um 404-Antworten als erfolgreich zu zählen, lautet die Erfolgsquote 100%.

Berechnung der Erfolgsquote konfigurieren

Um die Berechnung der Erfolgsquote für ein Netzwerk-URL-Muster zu konfigurieren, müssen Sie haben die Berechtigung firebaseperformance.config.update. Die folgenden Rollen umfassen standardmäßig diese erforderliche Berechtigung: Firebase-Leistungsadministrator, Firebase-Qualitätsadministrator, Firebase-Administrator und Projektinhaber oder ‑bearbeiter.

  1. Zum Dashboard von Performance Monitoring Tab in der Firebase-Konsole und wählen Sie die App aus, für die Sie eine Berechnung der Erfolgsquote konfigurieren.
  2. Scrollen Sie nach unten zur Traces-Tabelle am unteren Bildschirmrand und wählen Sie das Tab Netzwerkanfragen.
  3. Suchen Sie das URL-Muster, für das Sie die Erfolgsquote konfigurieren möchten. Berechnung.
  4. Öffnen Sie ganz rechts in der Zeile das Dreipunkt-Menü () und wählen Sie Erfolgreich konfigurieren rate.
  5. Folgen Sie der Anleitung auf dem Bildschirm, um die Antwortcodes auszuwählen, die Sie werden als erfolgreiche Antwortcodes gezählt.