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 gesendet wird. Dieser Trace wird als HTTP/S-Netzwerkanfrage-Trace bezeichnet. In diesen Protokollen werden Messwerte für den Zeitraum erfasst, der vergeht, zwischen dem Zeitpunkt, zu dem Ihre App eine Anfrage an einen Dienstendpunkt sendet, und dem Zeitpunkt, zu dem die Antwort von diesem Endpunkt vollständig ist. 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: Byte-Größe der Netzwerknutzlast, die von der App heruntergeladen wird

  • Größe der Anfragenutzlast: Byte-Größe der von der App hochgeladenen Netzwerknutzlast

  • Erfolgsquote: Prozentsatz der erfolgreichen Antworten (Antwortcodes im Bereich 100–399) im Vergleich zur Gesamtzahl der Antworten

Sie können Daten aus diesen Traces auf dem Untertab Netzwerkanfragen der Traces-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, bei denen die folgenden Netzwerkbibliotheken verwendet werden:

Swift

  • URLSession
  • URLConnection

Objective-C

  • NSURLSession
  • NSURLConnection

Datenaggregation für Netzwerkanfragen anpassen

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

  • Netzwerkanfrage-Traces manuell instrumentieren:Das standardmäßige Monitoring umfasst die meisten Netzwerkanfragen für Ihre App. Einige Anfragen werden jedoch möglicherweise nicht erfasst oder Sie verwenden eine andere Bibliothek, um Netzwerkanfragen zu stellen. In diesen Fällen können Sie mit der Performance Monitoring API manuell Traces für benutzerdefinierte Netzwerkanfragen instrumentieren.
  • Daten nach benutzerdefinierten URL-Mustern zusammenfassen:Wenn bestimmte URLs von Firebase nicht mithilfe der abgeleiteten automatischen URL-Musterübereinstimmung erfasst werden, können Sie benutzerdefinierte URL-Muster erstellen, um bestimmte URLs im Zeitverlauf zu überwachen.
  • Berechnung der Erfolgsrate anpassen:Manchmal ist für bestimmte API-Endpunkte ein Fehlercode zu erwarten oder wird bereits in Ihrer App verarbeitet. In diesen Fällen können Sie konfigurieren, wie die Erfolgsrate berechnet wird, und die Erfolgsrate der Netzwerkaufrufe Ihrer App genauer im Blick behalten.

Datenaggregation nach URL-Mustern

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

Bei jeder Anfrage prüft Firebase, ob die URL der Netzwerkanfrage mit einem URL-Muster übereinstimmt. Wenn die Anfrage-URL mit einem URL-Muster übereinstimmt, werden die Daten der Anfrage automatisch unter dem URL-Muster zusammengefasst. Firebase zeigt URL-Muster und die zugehörigen aggregierten Daten im Dashboard Leistung auf dem Tab Netzwerk der Firebase Console 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: Es wird eine genaue Übereinstimmung mit einem String gefunden.
    • * – entspricht jedem String in einem einzelnen Pfadsegment
    • ** – entspricht einem beliebigen Pfadsuffix

  • URL-Muster können folgendermaßen definiert werden:

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 weist jeder Anfrage nur ein URL-Muster zu. Wenn Sie benutzerdefinierte URL-Muster konfiguriert haben, versucht Firebase zuerst, Anfrage-URLs diesen Mustern zuzuordnen. Wenn Firebase kein übereinstimmendes 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 Ihre Konfiguration versucht Performance Monitoring, das aktuelle Nutzungsverhalten Ihrer App widerzuspiegeln, indem die Anfragen Ihrer App mit automatischen URL-Mustern abgeglichen werden.

Wie funktioniert die automatische Übereinstimmung mit URL-Mustern?

Firebase gleicht jede Anfrage mit dem repräsentativsten automatischen URL-Muster ab, das aus Anfragen abgeleitet wurde, die von Ihrer App gesendet wurden. 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 erkennt, dass example.com/germany/** ein gängiges Anfragemuster für Ihre App ist, und fügt es Ihrem Projekt als automatisches URL-Muster hinzu.

    Für alle neuen Anfragen, die mit diesem URL-Muster übereinstimmen, werden die Daten der Anfragen in Firebase unter dem automatischen URL-Muster example.com/germany/** zusammengefasst.

  2. Nach einer Woche gehen die meisten Anfragen für Ihre App an example.com/germany/animals/bears und example.com/germany/animals/birds. Daher leitet Firebase ein repräsentativeres URL-Muster von example.com/germany/animals/** ab.

    Für alle neuen Anfragen, die mit diesem neuen URL-Muster übereinstimmen, werden die Daten der Anfragen nur unter dem neuen URL-Muster zusammengefasst. Firebase aggregiert weiterhin Daten für Anfragen an example.com/germany/cars unter example.com/germany/**.

  3. In den nächsten Wochen werden die Anfragen Ihrer App an example.com/germany/animals/bears und example.com/germany/animals/birds jedoch deutlich zurückgehen. Firebase stellt fest, dass example.com/germany/animals/** nicht repräsentativ für das aktuelle Nutzungsverhalten Ihrer App ist. Daher werden diese beiden Anfragen wieder mit example.com/germany/** abgeglichen.

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

Da die automatische Übereinstimmung mit URL-Mustern dynamisch ist, beachten Sie Folgendes:

  • Übereinstimmungen und aggregierte Daten aus vorherigen Anfragen sind von neuen URL-Mustern nicht betroffen. In Firebase werden Anfragen nicht rückwirkend neu zusammengefasst.

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

Automatische URL-Muster und ihre Daten ansehen

Firebase zeigt alle URL-Muster und ihre zusammengefassten Daten auf dem Untertab Netzwerkanfragen der Tabelle mit den Traces an, der sich unten im Dashboard „Leistung“ der Firebase Console befindet.

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

Wenn die Aufbewahrungsdauer für die Daten abgelaufen ist, die unter einem URL-Muster zusammengefasst wurden, werden diese Daten von Firebase aus dem URL-Muster gelöscht. Wenn alle Daten, die unter einem automatischen URL-Muster zusammengefasst wurden, ablaufen, löscht Firebase dieses URL-Muster aus der Firebase Console.

Benutzerdefinierte URL-Muster

Sie können benutzerdefinierte URL-Muster erstellen, um bestimmte URL-Muster zu erfassen, die von Firebase nicht mit der abgeleiteten automatischen URL-Musterübereinstimmung erfasst werden. Sie können ein benutzerdefiniertes URL-Muster beispielsweise verwenden, um Fehler bei einer bestimmten URL zu beheben oder eine bestimmte Gruppe von URLs im Zeitverlauf zu überwachen.

Weitere Informationen finden Sie unter Benutzerdefinierte URL-Muster erstellen.

Leistungsdaten erfassen, ansehen und filtern

Damit Sie Leistungsdaten in Echtzeit sehen können, muss Ihre App eine Version des Performance Monitoring SDK verwenden, die mit der Echtzeitdatenverarbeitung kompatibel ist. Weitere Informationen zu Echtzeit-Leistungsdaten

Bestimmte Messwerte im Dashboard beobachten

Wenn Sie wissen möchten, wie sich Ihre wichtigsten Messwerte entwickeln, fügen Sie sie oben im Dashboard Leistung Ihrem Messwertbereich hinzu. Sie können schnell Regressionen erkennen, indem Sie die Änderungen von Woche zu Woche analysieren, oder prüfen, ob die Leistung durch die letzten Änderungen am Code verbessert wurde.

Bild des Messwert-Dashboards im <span class=Dashboard „Firebase Performance Monitoring“ />

So fügen Sie Ihrem Messwertbereich einen Messwert hinzu:

  1. Rufen Sie in der Firebase-Konsole das Dashboard „Leistung“ auf.
  2. Klicken Sie auf eine leere Messwertkarte und wählen Sie einen vorhandenen Messwert aus, um ihn dem Dashboard hinzuzufügen.
  3. Klicken Sie auf einer ausgefüllten Messwertkarte auf , um weitere Optionen aufzurufen, z. B. um einen Messwert zu ersetzen oder zu entfernen.

Auf dem Messwert-Dashboard werden erfasste Messwertdaten im Zeitverlauf sowohl grafisch als auch als numerische prozentuale Änderung dargestellt.

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 Dashboard Leistung auf, scrollen Sie nach unten zur Tabelle mit den Traces 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 Messwertänderungen 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 potenzielle Leistungsprobleme feststellen, z. B. in den folgenden Fällen:

  • Sie wählen relevante Messwerte im Dashboard aus und stellen eine große Abweichung fest.
  • In der Tabelle mit den Traces sortieren Sie die Daten so, dass die größten Deltas oben angezeigt werden. Sie sehen eine deutliche prozentuale Änderung.
  • Sie erhalten eine E-Mail-Benachrichtigung über ein Leistungsproblem.

So rufen Sie die Seite zur Fehlerbehebung auf:

  • Klicken Sie auf dem Messwert-Dashboard auf die Schaltfläche Messwertdetails ansehen.
  • Klicken Sie auf einer Messwertkarte auf > Details ansehen. Auf der Seite zur Fehlerbehebung werden Informationen zum ausgewählten Messwert angezeigt.
  • Klicken Sie in der Tabelle „Traces“ auf einen Trace-Namen oder einen Messwert in der Zeile, die mit diesem Trace verknüpft ist.
  • Klicken Sie in einer E-Mail-Benachrichtigung auf Jetzt prüfen.

Wenn Sie in der Tabelle „Traces“ auf einen Trace-Namen klicken, können Sie sich die gewünschten Messwerte ansehen. Klicken Sie auf die Schaltfläche 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 Release oder Ihrem neuesten Release aufzurufen.
  • Filtern Sie nach Gerät, um zu sehen, wie ältere Geräte mit Ihrer App umgehen.
  • Filtern Sie nach Land, um sicherzustellen, dass sich der Speicherort Ihrer Datenbank nicht auf eine bestimmte Region auswirkt.

Weitere Informationen zum Ansehen 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, die während derselben Sitzung erfasst wurden