Weitere Informationen zu Leistungsdaten von HTTP/S-Netzwerkanfragen (alle Apps)


Performance Monitoring verwendet Traces, um Daten zu überwachten Prozessen in Ihrer App zu erfassen. Ein Trace ist ein Bericht, der Daten enthält, die zwischen zwei Zeitpunkten in Ihrer App erfasst wurden.

Für alle App-Typen erfasst Performance Monitoring automatisch einen Trace für jede Netzwerkanfrage, die von Ihrer App ausgegeben wird. Dieser Trace wird als HTTP/S-Netzwerkanfrage-Trace bezeichnet. Diese Traces erfassen Messwerte für die Zeit zwischen dem Senden einer Anfrage von Ihrer App an einen Dienstendpunkt und dem Abschluss der Antwort von diesem Endpunkt. Für jeden Endpunkt, an den Ihre App eine Anfrage sendet, erfasst Performance Monitoring mehrere Messwerte:

  • Antwortzeit: Zeit zwischen dem Senden der Anfrage und dem vollständigen Empfang der Antwort

  • Größe der Antwortnutzlast – Größe der von der App heruntergeladenen Netzwerk-Nutzlast in Byte

  • Größe der Anfragenutzlast – Größe der von der App hochgeladenen Netzwerknutzlast in Byte

  • Erfolgsquote: Prozentsatz der erfolgreichen Antworten (Antwortcodes im Bereich von 100 bis 399) im Vergleich zu den Gesamtantworten

Sie können Daten aus diesen Traces auf dem Untertab Netzwerkanfragen der Trace-Tabelle unten im Dashboard Leistung aufrufen. Weitere Informationen zur Verwendung der Console finden Sie weiter unten auf dieser Seite.

Performance Monitoring erfasst automatisch Messwerte für Netzwerkanfragen, die die folgenden Netzwerkbibliotheken verwenden:

Datenaggregation für Netzwerkanfragen anpassen

Zusätzlich zu den vordefinierten Tools und der Datenaggregation für Netzwerkanfragen unterstützt Performance Monitoring auch die folgenden Optionen:

  • Netzwerkanfrage-Traces manuell instrumentieren: Das Standardmonitoring umfasst die meisten Netzwerkanfragen für Ihre App. Einige Anfragen werden jedoch möglicherweise nicht gemeldet oder Sie verwenden eine andere Bibliothek für Netzwerkanfragen. In diesen Fällen können Sie die Performance Monitoring API verwenden, um benutzerdefinierte Netzwerkanfrage-Traces manuell zu instrumentieren.
  • Daten unter benutzerdefinierten URL-Mustern aggregieren: Wenn es bestimmte URLs gibt, die Firebase mit dem abgeleiteten automatischen URL-Musterabgleich nicht erfasst, können Sie benutzerdefinierte URL-Muster erstellen, um eine bestimmte Gruppe von URLs im Zeitverlauf zu beobachten.
  • Berechnung der Erfolgsquote anpassen: Manchmal wird ein Fehlercode für bestimmte API-Endpunkte erwartet oder ist bereits in Ihrer App berücksichtigt. In diesen Fällen können Sie die Berechnung der Erfolgsquote konfigurieren und die Erfolgsquote der Netzwerkaufrufe Ihrer App genauer im Blick behalten.

Datenaggregation unter URL-Mustern

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

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. Firebase zeigt URL-Muster und die zugehörigen aggregierten Daten auf dem Tab Netzwerk im Dashboard Leistung der Firebase-Konsole an.

Was ist ein URL-Muster?

Ein URL-Muster enthält eine Domain und ein Muster, das mit einem URL-Pfad übereinstimmen kann, z. B. example.com/*/animals/**.

  • URL-Muster können die folgenden Pfadsegmente enthalten:

    • Nur-Text: stimmt mit einem genauen String überein
    • *: entspricht einem beliebigen String in einem einzelnen Pfadsegment
    • **: entspricht einem beliebigen Pfadsuffix

  • URL-Muster können Folgendes sein:

Beispiel: Jede der folgenden URL-Anfragen könnte mit dem URL-Muster example.com/*/animals/** übereinstimmen.

  • example.com/singapore/animals
  • example.com/australia/animals/spiders
  • example.com/australia/animals/marsupials/koala.png

Die Domain für ein URL-Muster kann auch * als erstes Segment enthalten, z. B. *.example.com/*/fruits/**.

Firebase ordnet jede Anfrage nur einem URL-Muster zu. Wenn Sie benutzerdefinierte URL-Muster konfiguriert haben, versucht Firebase zuerst, Anfrage-URLs mit diesen Mustern abzugleichen. Wenn Firebase kein passendes benutzerdefiniertes URL-Muster findet, wird eine Anfrage-URL dem repräsentativsten automatischen URL-Muster zugeordnet. Weitere Informationen zu automatischen und benutzerdefinierten URL-Mustern finden Sie in den folgenden Abschnitten.

Automatische URL-Muster

Ohne dass Sie etwas konfigurieren müssen, versucht Performance Monitoring, das aktuelle Nutzungsverhalten Ihrer Anwendung widerzuspiegeln, indem die Anfragen Ihrer Anwendung mit automatischen URL-Mustern abgeglichen werden.

Wie funktioniert der automatische Abgleich von URL-Mustern?

Firebase gleicht jede Anfrage mit dem repräsentativsten automatischen URL-Muster ab, das aus den von Ihrer App gesendeten Anfragen abgeleitet wurde. Beachten Sie jedoch, dass Firebase zuerst versucht, Anfrage-URLs mit konfigurierten benutzerdefinierten URL-Mustern abzugleichen.

Im Folgenden finden Sie ein einfaches Beispiel dafür, wie Firebase versucht, Anfragen dem repräsentativsten automatischen URL-Muster für Ihre App zuzuordnen.

  1. Ihre App sendet viele Anfragen an URLs wie:

    • example.com/germany/animals/bears
    • example.com/germany/animals/birds
    • example.com/germany/cars

    Firebase stellt fest, dass example.com/germany/** ein gängiges Anfragemuster für Ihre App ist, und fügt es als automatisches URL-Muster in Ihr Projekt ein.

    Für alle neuen Anfragen mit Übereinstimmung an dieses URL-Muster aggregiert Firebase die Daten der Anfragen unter dem automatischen URL-Muster example.com/germany/**.

  2. Nach einer Woche werden die meisten Anfragen Ihrer App an example.com/germany/animals/bears und example.com/germany/animals/birds gesendet. Firebase leitet daher ein repräsentativeres URL-Muster von example.com/germany/animals/** ab.

    Für alle neuen Anfragen mit Übereinstimmung an dieses neue URL-Muster aggregiert Firebase die Daten der Anfragen nur unter dem neuen URL-Muster. Firebase aggregiert weiterhin Daten für Anfragen an example.com/germany/cars unter example.com/germany/**.

  3. In den nächsten Wochen nehmen die Anfragen Ihrer App an example.com/germany/animals/bears und example.com/germany/animals/birds jedoch erheblich ab. Firebase stellt fest, dass example.com/germany/animals/** nicht repräsentativ für das aktuelle Nutzungsverhalten Ihrer App ist. Daher beginnt Firebase, diese beiden Anfragen wieder example.com/germany/** zuzuordnen.

    Firebase aggregiert keine weiteren Anfragedaten unter example.com/germany/animals/**, da es nicht mehr das repräsentativste automatische URL-Muster ist.

Da der automatische Abgleich von URL-Mustern dynamisch ist, sollten Sie Folgendes beachten:

  • Übereinstimmungen und aggregierte Daten aus früheren Anfragen sind von neuen URL-Mustern nicht betroffen. Firebase aggregiert Anfragedaten nicht rückwirkend neu.

  • Neue URL-Muster wirken sich nur auf zukünftige Anfragen aus. Firebase ordnet jede neue Anfrage dem repräsentativsten automatischen URL-Muster zu. Beachten Sie jedoch, dass Firebase zuerst versucht, Anfrage-URLs mit konfigurierten benutzerdefinierten URL-Mustern abzugleichen.

Automatische URL-Muster und die zugehörigen Daten ansehen

Firebase zeigt alle URL-Muster und die zugehörigen aggregierten Daten auf dem Untertab Netzwerkanfragen der Trace-Tabelle an, die sich unten im Leistungs-Dashboard der Firebase-Konsole befindet.

Möglicherweise sehen Sie URL-Muster mit dem Label Nicht kategorisiert. Dies sind „grobe“ automatische URL-Muster, unter denen Firebase Daten für Anfragen aggregieren kann, die keinem spezifischeren URL-Muster entsprechen.

Wenn die Aufbewahrungsdauer für die unter einem URL-Muster zusammengefassten Daten endet, löscht Firebase diese Daten aus dem URL-Muster. Wenn alle Daten, die unter einem automatischen URL-Muster zusammengefasst sind, ablaufen, löscht Firebase dieses URL-Muster aus der Firebase-Konsole.

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

Weitere Informationen finden Sie unter Benutzerdefinierte URL-Muster erstellen.

Leistungsdaten erfassen, ansehen und filtern

Wenn Sie Leistungsdaten in Echtzeit sehen möchten, muss Ihre App eine Version des Performance Monitoring SDK verwenden, die mit der Echtzeit-Datenverarbeitung kompatibel ist. Weitere Informationen zu Echtzeit-Leistungsdaten

Bestimmte Messwerte im Dashboard im Blick behalten

Wenn Sie wissen möchten, wie sich Ihre wichtigsten Messwerte entwickeln, fügen Sie sie oben im Dashboard Leistung Ihrer Messwertübersicht hinzu. Sie können Regressionen schnell erkennen, indem Sie sich die Änderungen im Vergleich zur Vorwoche ansehen, oder prüfen, ob die letzten Änderungen am Code die Leistung verbessern.

Bild des Messwert-Boards in der <span class=Firebase Performance Monitoring-Dashboard" />

So fügen Sie Ihrem Messwert-Dashboard einen Messwert hinzu:

  1. Rufen Sie in der Firebase Console das Leistungs-Dashboard auf.
  2. Klicken Sie auf eine leere Messwertkarte und wählen Sie dann einen vorhandenen Messwert aus, um ihn Ihrem Board hinzuzufügen.
  3. Klicken Sie auf einer ausgefüllten Messwertkarte auf , um weitere Optionen aufzurufen, z. B. zum Ersetzen oder Entfernen eines Messwerts.

Auf dem Messwert-Dashboard werden die erfassten Messwertdaten im Zeitverlauf sowohl in grafischer Form als auch als numerische prozentuale Änderung angezeigt.

Weitere Informationen zur Verwendung des Dashboards

Traces und ihre Daten ansehen

Wenn Sie sich Ihre Traces ansehen möchten, rufen Sie in der Firebase-Konsole das Leistungs-Dashboard auf, scrollen Sie nach unten zur Trace-Tabelle und klicken Sie dann auf den entsprechenden Untertab. In der Tabelle werden einige der wichtigsten Messwerte für jeden Trace angezeigt. Sie können die Liste sogar nach der prozentualen Änderung für einen bestimmten Messwert sortieren.

Performance Monitoring bietet in der Firebase-Konsole eine Seite zur Fehlerbehebung, auf der Änderungen an Messwerten hervorgehoben werden. So können Sie Leistungsprobleme schnell beheben und die Auswirkungen auf Ihre Apps und Nutzer minimieren. Sie können die Seite zur Fehlerbehebung verwenden, wenn Sie von potenziellen Leistungsproblemen erfahren, z. B. in den folgenden Szenarien:

  • Sie wählen relevante Messwerte im Dashboard aus und bemerken eine große Abweichung.
  • In der Tabelle mit den Traces sortieren Sie die größten Deltas nach oben und sehen eine signifikante prozentuale Änderung.
  • Sie erhalten eine E‑Mail-Benachrichtigung über ein Leistungsproblem.

Sie können die Seite zur Fehlerbehebung auf folgende Weise aufrufen:

  • Klicken Sie im Messwert-Dashboard auf den Button Messwertdetails ansehen.
  • Wählen Sie auf einer beliebigen Messwertkarte  => Details ansehen aus. Auf der Seite zur Fehlerbehebung werden Informationen zum ausgewählten Messwert angezeigt.
  • Klicken Sie in der Tabelle „Traces“ auf einen Trace-Namen oder einen beliebigen Messwert in der Zeile, die mit diesem Trace verknüpft ist.
  • Klicken Sie in einer E‑Mail-Benachrichtigung auf Jetzt untersuchen.

Wenn Sie in der Trace-Tabelle auf einen Trace-Namen klicken, können Sie die gewünschten Messwerte aufrufen. Klicken Sie auf den Button Filter , um die Daten nach Attribut zu filtern, z. B.:

ein Bild von <span class=Firebase Performance Monitoring-Daten werden nach Attribut gefiltert" />
  • Filtern Sie nach App-Version, um Daten zu einem früheren oder dem neuesten Release aufzurufen.
  • Nach Gerät filtern, um zu sehen, wie ältere Geräte mit deiner App umgehen
  • Filtern Sie nach Land, um sicherzustellen, dass der Standort Ihrer Datenbank keine Auswirkungen auf eine bestimmte Region hat.

Weitere Informationen zum Aufrufen von Daten für Ihre Traces

Nächste Schritte

  • Detaillierte Berichte zu Nutzersitzungen aufrufen, in denen Sie einen bestimmten Trace im Zeitachsenkontext anderer Traces sehen können, die während derselben Sitzung erfasst wurden.