Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Informationen zu Leistungsdaten für HTTP/S-Netzwerkanforderungen (beliebige App)

Die Leistungsüberwachung verwendet Ablaufverfolgungen , um Daten zu überwachten Prozessen in Ihrer App zu sammeln. Ein Trace ist ein Bericht, der Daten enthält, die zwischen zwei Zeitpunkten in Ihrer App erfasst wurden.

Für alle App-Typen erfasst die Leistungsüberwachung automatisch eine Ablaufverfolgung für jede von Ihrer App ausgegebene Netzwerkanforderung, die als HTTP/S-Netzwerkanforderungs-Trace bezeichnet wird . Diese Ablaufverfolgungen erfassen Metriken für die Zeit zwischen dem Ausgeben einer Anforderung durch Ihre App an einen Dienstendpunkt und dem Abschluss der Antwort von diesem Endpunkt. Für jeden Endpunkt, an den Ihre App eine Anfrage stellt, erfasst die Leistungsüberwachung mehrere Metriken:

  • Antwortzeit – Zeit zwischen dem Stellen der Anfrage und dem vollständigen Erhalt der Antwort

  • Antwortnutzlastgröße – Bytegröße der von der App heruntergeladenen Netzwerknutzlast

  • Nutzlastgröße anfordern – Bytegröße der von der App hochgeladenen Netzwerknutzlast

  • Erfolgsrate – Prozentsatz erfolgreicher Antworten im Vergleich zu den Gesamtantworten (um Netzwerk- oder Serverausfälle zu messen)

Sie können Daten aus diesen Ablaufverfolgungen auf der Unterregisterkarte Netzwerkanforderungen der Ablaufverfolgungstabelle anzeigen, die sich unten im Leistungs- Dashboard befindet (weitere Informationen zur Verwendung der Konsole später auf dieser Seite).

Dieses Out-of-the-Box-Monitoring umfasst die meisten Netzwerkanfragen für Ihre App. Einige Anforderungen werden jedoch möglicherweise nicht gemeldet oder Sie verwenden eine andere Bibliothek, um Netzwerkanforderungen zu stellen. In diesen Fällen können Sie die Performance Monitoring API verwenden, um benutzerdefinierte Netzwerkanforderungs-Traces manuell zu instrumentieren.

Datenaggregation nach URL-Mustern

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

Firebase prüft bei jeder Anfrage, ob die URL der Netzwerkanfrage mit einem URL-Muster übereinstimmt. Wenn die Anfrage-URL einem URL-Muster entspricht, fasst Firebase die Daten der Anfrage automatisch unter dem URL-Muster zusammen. Firebase zeigt URL-Muster und ihre aggregierten Daten auf der Registerkarte " Netzwerk" im Leistungs- Dashboard der Firebase-Konsole an.

Was ist ein URL-Muster?

Ein URL-Muster enthält eine Domäne plus ein Muster, das einem URL-Pfad entsprechen kann, zum Beispiel: example.com/*/animals/** .

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

    • Klartext — entspricht einer genauen Zeichenfolge
    • * — stimmt mit einer beliebigen Zeichenfolge in einem einzelnen Pfadsegment überein
    • ** — entspricht einem beliebigen Pfadsuffix
  • URL-Muster können sein:

Beispiel: Jede der folgenden URL-Anforderungen könnte dem URL-Muster example.com/*/animals/** .

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

Die Domain für automatische URL-Muster kann auch * als erstes Segment enthalten, zum Beispiel: *.example.com/*/fruits/** . Dies wird derzeit für benutzerdefinierte URL-Muster nicht unterstützt.

Firebase ordnet jede Anfrage nur einem URL-Muster zu . Wenn Sie benutzerdefinierte URL-Muster konfiguriert haben , versucht Firebase, die Anfrage-URLs zuerst diesen Mustern zuzuordnen. Wenn Firebase kein passendes benutzerdefiniertes URL-Muster findet, ordnet es eine Anfrage-URL dem repräsentativsten automatischen URL-Muster zu . In den folgenden Abschnitten erfahren Sie mehr über automatische und benutzerdefinierte URL-Muster.

Automatische URL-Muster

Ohne Ihre Konfiguration versucht die Leistungsüberwachung, das neueste Nutzungsverhalten Ihrer App widerzuspiegeln, indem die Anforderungen Ihrer App mit automatischen URL-Mustern abgeglichen werden .

Wie funktioniert der automatische URL-Musterabgleich?

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

Im Folgenden finden Sie ein grundlegendes 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 allgemeines Anforderungsmuster für Ihre App ist, und fügt es Ihrem Projekt als automatisches URL-Muster hinzu.

    Für alle neuen übereinstimmenden Anfragen zu diesem URL-Muster fasst Firebase die Daten der Anfragen unter dem automatischen URL-Muster example.com/germany/** .

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

    Bei allen neuen übereinstimmenden Anfragen mit diesem neuen 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 jedoch die Anfragen Ihrer App an example.com/germany/animals/bears und example.com/germany/animals/birds erheblich ab. Firebase stellt fest, dass example.com/germany/animals/** nicht für das aktuelle Nutzungsverhalten Ihrer App repräsentativ ist, daher beginnt Firebase, diese beiden Anfragen mit example.com/germany/** .

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

Da der automatische URL-Musterabgleich dynamisch ist, beachten Sie Folgendes:

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

  • Nur zukünftige Anfragen sind von neuen URL-Mustern betroffen. Firebase ordnet jede neue Anfrage dem repräsentativsten automatischen URL-Muster zu. Beachten Sie jedoch, dass Firebase zuerst versucht, Anforderungs-URLs mit konfigurierten benutzerdefinierten URL-Mustern abzugleichen.

Sehen Sie sich automatische URL-Muster und deren Daten an

Firebase zeigt alle URL-Muster und ihre aggregierten Daten im Unterregister Netzwerkanfragen der Traces-Tabelle an, die sich unten im Performance- Dashboard der Firebase-Konsole befindet.

Möglicherweise sehen Sie URL-Muster mit einem nicht kategorisierten Label. Dies sind "breite" automatische URL-Muster, nach denen Firebase Daten für Anfragen aggregieren kann, die keinem spezifischeren URL-Muster entsprechen.

Wenn die Datenaufbewahrungsfrist für die unter einem URL-Muster aggregierten Daten endet, löscht Firebase diese Daten aus dem URL-Muster. Wenn alle unter einem automatischen URL-Muster aggregierten Daten 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 Probleme mit einer bestimmten URL zu beheben oder einen bestimmten Satz von URLs im Laufe der Zeit zu überwachen.

Weitere Informationen finden Sie unter Benutzerdefinierte URL-Muster erstellen .

Leistungsdaten verfolgen, anzeigen und filtern

Um Echtzeitleistungsdaten anzuzeigen, stellen Sie sicher, dass Ihre App eine Performance Monitoring SDK-Version verwendet, die mit der Echtzeitdatenverarbeitung kompatibel ist. Erfahren Sie mehr .

Verfolgen Sie bestimmte Metriken in Ihrem Dashboard

Um zu erfahren, wie sich Ihre wichtigsten Kennzahlen entwickeln, fügen Sie sie zu Ihrem Kennzahlen-Board oben im Leistungs- Dashboard hinzu. Sie können Regressionen schnell erkennen, indem Sie Änderungen von Woche zu Woche anzeigen oder überprüfen, ob die jüngsten Änderungen in Ihrem Code die Leistung verbessern.

ein Bild des Metrik-Boards im Firebase Performance Monitoring-Dashboard

Um Ihrem Metriken-Board einen Messwert hinzuzufügen, rufen Sie das Leistungs- Dashboard in der Firebase-Konsole auf und klicken Sie dann auf die Registerkarte Dashboard . Klicken Sie auf eine leere Messwertkarte und wählen Sie dann einen vorhandenen Messwert aus, den Sie zu Ihrem Board hinzufügen möchten. Klicken auf einer auf , um weitere Optionen einen zu ersetzen oder zu entfernen.

Das Metrics Board zeigt gesammelte Metrikdaten im Zeitverlauf sowohl in grafischer Form als auch als numerische prozentuale Veränderung an.

Erfahren Sie mehr über die Verwendung des Dashboards .

Anzeigen von Spuren und deren Daten

Um Ihre Traces anzuzeigen, rufen Sie das Performance- Dashboard in der Firebase-Konsole auf, scrollen Sie nach unten zur Tabelle mit den Traces und klicken Sie dann auf die entsprechende Unterregisterkarte. Die Tabelle zeigt einige der wichtigsten Metriken für jeden Trace an, und Sie können die Liste sogar nach der prozentualen Änderung für eine bestimmte Metrik sortieren.

Wenn Sie in der Trace-Tabelle auf einen Trace-Namen klicken, können Sie durch verschiedene Bildschirme klicken, um den Trace zu durchsuchen und die relevanten Metriken aufzuschlüsseln. Auf den meisten Seiten können Sie die Schaltfläche zum Filtern (oben links auf dem Bildschirm) verwenden, um die Daten nach Attributen zu filtern, zum Beispiel:

ein Bild von Firebase Performance Monitoring-Daten, die nach Attributen gefiltert werden
  • Filtern Sie nach App-Version , um Daten zu einer früheren Version oder Ihrer neuesten Version anzuzeigen
  • Filtern Sie nach Gerät , um zu erfahren, wie ältere Geräte mit Ihrer App umgehen
  • Filtern Sie nach Land , um sicherzustellen, dass sich Ihr Datenbankstandort nicht auf eine bestimmte Region auswirkt

Erfahren Sie mehr über das Anzeigen von Daten für Ihre Traces .

Nächste Schritte

  • Zeigen Sie detaillierte Berichte zu Benutzersitzungen an, in denen Sie eine bestimmte Ablaufverfolgung in einem Zeitachsenkontext anderer Ablaufverfolgungen sehen können, die während derselben Sitzung erfasst wurden.