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
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.
Die standardmäßige Überwachung umfasst die meisten Netzwerkanfragen für Ihre App. Wenn bestimmte URLs jedoch nicht mit der automatischen URL-Musterübereinstimmung von Firebase erfasst werden, können Sie benutzerdefinierte URL-Muster erstellen, um eine bestimmte Gruppe von URLs im Zeitverlauf zu überwachen.
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:
- Firebase-abgeleitete Muster, sogenannte automatische URL-Muster
- Benutzerdefinierte Muster, sogenannte benutzerdefinierte URL-Muster
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.
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.Nach einer Woche gehen die meisten Anfragen für Ihre App an
example.com/germany/animals/bears
undexample.com/germany/animals/birds
. Daher leitet Firebase ein repräsentativeres URL-Muster vonexample.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
unterexample.com/germany/**
.In den nächsten Wochen werden die Anfragen Ihrer App an
example.com/germany/animals/bears
undexample.com/germany/animals/birds
jedoch deutlich zurückgehen. Firebase stellt fest, dassexample.com/germany/animals/**
nicht repräsentativ für das aktuelle Nutzungsverhalten Ihrer App ist. Daher werden diese beiden Anfragen wieder mitexample.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.
Dashboard „Firebase Performance Monitoring“ />So fügen Sie Ihrem Messwertbereich einen Messwert hinzu:
- Rufen Sie in der Firebase-Konsole das Dashboard „Leistung“ auf.
- Klicken Sie auf eine leere Messwertkarte und wählen Sie einen vorhandenen Messwert aus, um ihn dem Dashboard hinzuzufügen.
- 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
. Auf der Seite zur Fehlerbehebung werden Informationen zum ausgewählten Messwert angezeigt. > Details ansehen - 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
- Filtern Sie nach Seiten-URL, um Daten für eine bestimmte Seite Ihrer Website aufzurufen.
- Filtern Sie nach Effektiver Verbindungstyp, um zu sehen, wie sich eine 3G-Verbindung auf Ihre App auswirkt.
- 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
Weitere Informationen zum Überwachen von Leistungsproblemen in der Firebase-Konsole
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.