Datenaggregation für Netzwerkanfrage anpassen

Firebase Performance Monitoring fasst automatisch Daten für ähnliche Netzwerkanfragen zusammen damit Sie Trends bei der Leistung Ihrer Netzwerkanfragen besser nachvollziehen können.

Manchmal müssen Sie jedoch anpassen, wie Firebase bestimmte Daten zu Netzwerkanfragen zusammenfasst, 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 zusammenfassen und die Berechnung der Erfolgsrate anpassen.

Daten unter benutzerdefinierten URL-Mustern zusammenfassen

Für jede Anfrage prüft Firebase, ob die URL der Netzwerkanfrage mit einem URL-Muster übereinstimmt. Wenn die Anfrage-URL mit einem URL-Muster übereinstimmt, fasst Firebase die Daten der Anfrage automatisch unter dem URL-Muster zusammen.

Sie können benutzerdefinierte URL-Muster erstellen, um bestimmte URL-Muster zu beobachten, die Firebase nicht mit dem abgeleiteten automatischen URL-Muster abgleich 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 zusammengefassten Daten auf dem Untertab Netzwerkanfragen der Tracetabelle an. Diese befindet sich unten auf dem Performance-Dashboard der Firebase Konsole.

Wie funktioniert der Abgleich mit benutzerdefinierten URL-Mustern?

Firebase versucht, Anfrage-URLs mit konfigurierten benutzerdefinierten URL-Mustern abzugleichen, bevor der automatische URL-Musterabgleich verwendet wird. Für alle Anfragen, die mit einem benutzerdefinierten URL-Muster übereinstimmen, fasst Firebase die Daten der Anfragen unter dem benutzerdefinierten URL-Muster zusammen.

Wenn die URL einer Anfrage mit mehr als einem benutzerdefinierten URL-Muster übereinstimmt, ordnet Firebase die Anfrage nur dem spezifischsten benutzerdefinierten URL-Muster zu. Die Spezifität wird dabei in der folgenden Reihenfolge berücksichtigt: Klartext > * > ** von links nach rechts im Pfad. Eine Anfrage an example.com/books/dog stimmt beispielsweise 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 zusammengefasste Daten aus früheren Anfragen sind nicht betroffen, wenn ein neues benutzerdefiniertes URL-Muster erstellt wird. Firebase fasst Anfragedaten nicht rückwirkend neu zusammen.

• Nur zukünftige Anfragen sind betroffen, wenn ein neues benutzerdefiniertes URL-Muster erstellt wird. Es kann bis zu 12 Stunden dauern, bis Performance Monitoring Daten unter einem neuen benutzerdefinierten URL-Muster erfasst und zusammenfasst.

Benutzerdefiniertes URL-Muster erstellen

Sie können ein benutzerdefiniertes URL-Muster auf dem Netzwerkanfragen-Untertab der Tracetabelle erstellen. Diese befindet sich unten auf dem Performance-Dashboard der Firebase Konsole.

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 zusammengefassten 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.

Erstellen Sie ein benutzerdefiniertes URL-Muster, indem Sie mit einem Hostnamen beginnen und dann Pfadsegmente hinzufügen. 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 übereinstimmen kann.

• Klartext: stimmt mit einem exakten String überein
• *: stimmt mit dem ersten Subdomainsegment oder einem beliebigen String 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.

Übereinstimmung mit...	Benutzerdefiniertes URL-Muster erstellen, z. B.:	Beispielü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/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 Subdomainsegment (*)	*.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, z. B. *.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 zusammengefassten Daten auf dem Untertab Netzwerkanfragen der Tracetabelle an. Diese befindet sich unten auf dem Performance-Dashboard der Firebase Konsole.

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

Wenn der Aufbewahrungszeitraum 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 „leere“ benutzerdefinierte URL-Muster weiterhin in der Liste Benutzerdefinierte Muster auf dem Untertab Netzwerkanfragen der Tracetabelle aufgeführt.

Benutzerdefiniertes URL-Muster entfernen

Sie können benutzerdefinierte URL-Muster aus Ihrem Projekt entfernen. Automatische URL-Muster können nicht entfernt werden.

1. Scrollen Sie auf dem Performance Dashboard nach unten zur Tracetabelle 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ächstspezifischen übereinstimmenden benutzerdefinierten URL-Muster zugeordnet. Wenn Firebase keine übereinstimmenden benutzerdefinierten URL-Muster findet, wird der automatische URL-Musterabgleich verwendet.

• Übereinstimmungen und zusammengefasste Daten aus früheren Anfragen sind nicht betroffen, wenn ein benutzerdefiniertes URL-Muster entfernt wird.

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

• Auf dem Untertab Netzwerkanfragen (wenn Benutzerdefinierte Muster ausgewählt ist) werden keine entfernten benutzerdefinierten URL-Muster aufgeführt.

Nächste Schritte

• Richten Sie Benachrichtigungen ein für Netzwerkanfragen, 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.

Berechnung der Erfolgsrate anpassen

Einer der Messwerte, die Firebase für jede Netzwerkanfrage beobachtet, ist die Erfolgsrate der Anfrage. Die Erfolgsrate ist der Prozentsatz der erfolgreichen Antworten im Vergleich zu allen Antworten. 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 Erfolgsrate 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 Such-Endpunkt 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 Such-Endpunkt, davon 60 mit dem Antwortcode 200 und 40 mit dem Antwortcode 404. Bevor Sie die Erfolgsrate konfigurieren, beträgt sie 60%. Nachdem Sie die Berechnung der Erfolgsrate so konfiguriert haben, dass 404-Antworten als erfolgreich gezählt werden, beträgt die Erfolgsrate 100%.

Hinweis: Neue Konfigurationen der Erfolgsrate gelten nur für Daten, die nach der Erstellung der Konfiguration erhoben wurden.

Berechnung der Erfolgsrate konfigurieren

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

1. Rufen Sie in der Firebase Konsole den Performance Monitoring Dashboard Tab auf und wählen Sie die App aus, für die Sie die Berechnung der Erfolgsrate konfigurieren möchten.
2. Scrollen Sie nach unten zur Tracetabelle und wählen Sie den Tab Netzwerkanfragen aus.
3. Suchen Sie das URL-Muster, für das Sie die Berechnung der Erfolgsrate konfigurieren möchten.
4. Öffnen Sie ganz rechts in der Zeile das Dreipunkt-Menü () und wählen Sie Erfolgsrate 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 Erfolgsrate sowohl für automatische als auch für benutzerdefinierte URL-Muster konfigurieren. Es wird empfohlen, die Erfolgsrate 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.