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 aggregiert, um die Anwendungsfälle Ihrer App besser zu unterstützen. Wir bieten zwei Möglichkeiten, die Datenaggregation für Netzwerkanfragen anzupassen: Daten unter benutzerdefinierten URL-Mustern aggregieren und Berechnung der Erfolgsquote anpassen.

Daten unter benutzerdefinierten URL-Mustern aggregieren

Firebase prüft bei jeder Anfrage, 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 nicht mit dem abgeleiteten automatischen URL-Musterabgleich 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 Zeitverlauf zu beobachten.

Firebase zeigt alle URL-Muster (einschließlich benutzerdefinierter URL-Muster) und die zugehörigen aggregierten Daten auf dem Untertab Netzwerkanfragen der Traces-Tabelle an, die sich unten im Leistungs-Dashboard der Firebase-Konsole befindet.

Wie funktioniert der Abgleich mit benutzerdefinierten URL-Mustern?

Firebase versucht, Anfrage-URLs mit allen konfigurierten benutzerdefinierten URL-Mustern abzugleichen, bevor auf den automatischen Abgleich von URL-Mustern zurückgegriffen wird. Bei allen Anfragen mit Übereinstimmung an ein benutzerdefiniertes 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 nur dem spezifischsten benutzerdefinierten URL-Muster zu. Dabei gilt die folgende Reihenfolge der Spezifität: 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 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 sind von der Erstellung eines neuen benutzerdefinierten URL-Musters nicht betroffen. Firebase aggregiert Anfragedaten nicht rückwirkend neu.

• 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 unter einem neuen benutzerdefinierten URL-Muster erfasst und aggregiert.

Benutzerdefiniertes URL-Muster erstellen

Sie können ein benutzerdefiniertes URL-Muster auf dem Untertab Netzwerkanfragen in der Trace-Tabelle erstellen, die sich unten im Leistungs-Dashboard der Firebase-Konsole befindet.

Ein Projektmitglied muss Inhaber oder Bearbeiter sein, um ein neues benutzerdefiniertes URL-Muster zu erstellen. Alle Projektmitglieder können jedoch benutzerdefinierte URL-Muster und die zugehörigen aggregierten Daten aufrufen.

Sie können pro App insgesamt bis zu 400 benutzerdefinierte URL-Muster und pro Domain für diese App bis zu 100 benutzerdefinierte URL-Muster 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 Pfadsegment-Syntax, um ein Muster zu erstellen, das mit URLs übereinstimmen kann.

• Nur-Text: stimmt mit einem genauen String überein
• *: 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 Muster für benutzerdefinierte URLs beschrieben.

Abgleich mit…	Benutzerdefiniertes URL-Muster erstellen, z. B.	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 mit example.com/foo überein.
Ein beliebiges Pfad-Suffix (**)	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

Hinweis: Für benutzerdefinierte URL-Muster unterstützt Firebase nicht die Syntax von *.file-extension, wie *.png oder *.css.

Benutzerdefinierte URL-Muster und die zugehörigen Daten ansehen

Firebase zeigt alle URL-Muster (einschließlich benutzerdefinierter URL-Muster) und die zugehörigen aggregierten Daten auf dem Untertab Netzwerkanfragen der Traces-Tabelle an, die sich unten im Leistungs-Dashboard der Firebase-Konsole 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 vorliegen, wird es nur in dieser Liste angezeigt.

Wenn die Aufbewahrungsdauer für die unter einem URL-Muster zusammengefassten Daten endet, löscht Firebase diese Daten aus dem URL-Muster. Wenn alle unter einem benutzerdefinierten URL-Muster zusammengefassten Daten ablaufen, löscht Firebase das benutzerdefinierte URL-Muster nicht aus der Firebase-Konsole. Stattdessen werden in Firebase weiterhin „leere“ benutzerdefinierte URL-Muster in der Liste Benutzerdefinierte Muster auf dem Untertab Netzwerkanfragen der Tabelle mit Traces aufgeführt.

Benutzerdefiniertes URL-Muster entfernen

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 Tabelle mit den Traces und wählen Sie den Untertab Netzwerkanfragen aus.

2. Wählen Sie im Drop-down-Menü auf dem Untertab Netzwerkanfragen die Option Benutzerdefinierte Muster aus.

3. Bewegen Sie den Mauszeiger auf 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 das Entfernen im Dialogfeld.

Beachten Sie beim Entfernen eines benutzerdefinierten URL-Musters Folgendes:

• Alle zukünftigen Anfragen werden dem nächstspezifischeren übereinstimmenden benutzerdefinierten URL-Muster zugeordnet. Wenn Firebase keine übereinstimmenden benutzerdefinierten URL-Muster findet, wird auf den automatischen URL-Musterabgleich zurückgegriffen.

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

  Sie können bis zum Ende des entsprechenden Datenaufbewahrungszeitraums weiterhin auf ein entferntes benutzerdefiniertes URL-Muster und die zugehörigen aggregierten Daten auf dem Untertab Netzwerkanfragen zugreifen, wenn Alle Netzwerkanfragen ausgewählt ist. Wenn alle aggregierten Daten unter dem entfernten benutzerdefinierten URL-Muster ablaufen, löscht Firebase das benutzerdefinierte URL-Muster.

• Auf dem Untertab Netzwerkanfragen (mit ausgewählten benutzerdefinierten Mustern) 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 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 zu den Gesamtantworten. Mit diesem Messwert können Sie Netzwerk- und Serverfehler messen.

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

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 Anwendung beispielsweise eine Such-Endpunkt-API hat, können Sie 404-Antworten als „erfolgreich“ zählen, da 404-Antworten für einen Such-Endpunkt erwartet werden. Angenommen, es gibt jede Stunde 100 Stichproben für diesen Suchendpunkt. 60 davon sind 200-Antworten und 40 sind 404-Antworten. Bevor Sie die Erfolgsquote konfigurieren, beträgt sie 60 %. Nachdem Sie die Berechnung der Erfolgsquote so konfiguriert haben, dass 404-Antworten als erfolgreich gezählt werden, beträgt die Erfolgsquote 100 %.

Hinweis: Neue Konfigurationen für die Erfolgsquote gelten nur für Daten, die nach dem Erstellen der Konfiguration erhoben werden.

Berechnung der Erfolgsquote konfigurieren

Wenn Sie die Berechnung der Erfolgsquote für ein Netzwerk-URL-Muster konfigurieren möchten, benötigen Sie die Berechtigung firebaseperformance.config.update. Die folgenden Rollen enthalten diese erforderliche Berechtigung standardmäßig: Firebase Performance Admin, Firebase Quality Admin, Firebase Admin und Projektinhaber oder ‑bearbeiter.

1. 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.
2. Scrollen Sie nach unten zur Tabelle mit den Traces und wählen Sie den Tab Netzwerkanfragen 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 Dreipunkt-Menü () und wählen Sie Erfolgsquote konfigurieren aus.
5. Folgen Sie der Anleitung auf dem Bildschirm, um Antwortcodes auszuwählen, die als erfolgreiche Antwortcodes gezählt werden sollen.

Hinweis: Sie können die Erfolgsquote sowohl für automatische als auch für benutzerdefinierte URL-Muster konfigurieren. Wir empfehlen, die Erfolgsquote nur für benutzerdefinierte URL-Muster zu konfigurieren, da sich automatische URL-Muster im Laufe der Zeit ändern können, wenn sich Ihre Daten ändern.