Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

Die Leistungsüberwachung verwendet Ablaufverfolgungen , um Daten zu überwachten Prozessen in Ihrer App zu sammeln. Eine Ablaufverfolgung 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 Senden einer Anforderung an einen Dienstendpunkt durch Ihre App und dem Abschluss der Antwort von diesem Endpunkt. Für jeden Endpunkt, an den Ihre App eine Anfrage sendet, erfasst die Leistungsüberwachung mehrere Metriken:

  • Reaktionszeit – Zeit zwischen dem Stellen der Anfrage und dem vollständigen Empfang der Antwort

  • Antwortnutzlastgröße – Bytegröße der Netzwerknutzlast, die von der App heruntergeladen wurde

  • Nutzlastgröße anfordern – Byte-Größe der Netzwerknutzlast, die von der App hochgeladen wird

  • Erfolgsrate – Prozentsatz erfolgreicher Antworten (Antwortcodes im Bereich von 100 bis 399) im Vergleich zu allen Antworten

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 finden Sie weiter unten auf dieser Seite).

Passen Sie die Aggregation von Netzwerkanfragedaten an

Neben den sofort einsatzbereiten Tools und der Datenaggregation für Netzwerkanfragen unterstützt Performance Monitoring auch die folgenden Optionen:

  • Traces für Netzwerkanfragen manuell instrumentieren: Die Out-of-the-Box-Überwachung umfasst die meisten Netzwerkanfragen für Ihre App. Einige Anforderungen werden jedoch möglicherweise nicht gemeldet, oder Sie verwenden möglicherweise eine andere Bibliothek, um Netzwerkanforderungen zu stellen. In diesen Fällen können Sie die Leistungsüberwachungs-API verwenden, um benutzerdefinierte Netzwerkanforderungs-Traces manuell zu instrumentieren .
  • Aggregieren von Daten unter benutzerdefinierten URL-Mustern: Wenn es bestimmte URLs gibt, die Firebase nicht mit seinem abgeleiteten automatischen URL-Musterabgleich erfasst, können Sie benutzerdefinierte URL-Muster erstellen, um eine bestimmte Gruppe von URLs im Laufe der Zeit zu überwachen.
  • Passen Sie an, wie die Erfolgsrate berechnet wird: Manchmal wird ein Fehlercode für bestimmte API-Endpunkte erwartet oder wird bereits in Ihrer App behandelt. In diesen Fällen können Sie konfigurieren, wie die Erfolgsrate berechnet wird, und die Erfolgsrate der Netzwerkaufrufe Ihrer App genauer überwachen.

Datenaggregation unter URL-Mustern

Firebase Performance Monitoring aggregiert automatisch Daten für ähnliche Netzwerkanfragen, um Ihnen dabei zu helfen, Trends in der Leistung Ihrer Netzwerkanfragen zu verstehen.

Firebase prüft bei jeder Anfrage, ob die URL der Netzwerkanfrage mit einem URL-Muster übereinstimmt. Wenn die Anforderungs-URL mit einem URL-Muster übereinstimmt, aggregiert Firebase die Daten der Anforderung automatisch unter dem URL-Muster. 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 Domain und ein Muster, das mit einem URL-Pfad übereinstimmen kann, zum Beispiel: example.com/*/animals/** .

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

    • Einfacher Text – stimmt mit einer exakten Zeichenfolge überein
    • * — stimmt mit einer beliebigen Zeichenfolge in einem einzelnen Pfadsegment überein
    • ** — stimmt mit einem beliebigen Pfadsuffix überein

  • URL-Muster können entweder sein:

Beispiel: Jede der folgenden URL-Anforderungen 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, zum Beispiel: *.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, gleicht es eine Anfrage-URL mit dem repräsentativsten automatischen URL-Muster ab . Weitere Informationen zu automatischen und benutzerdefinierten URL-Mustern finden Sie in den folgenden Abschnitten.

Automatische URL-Muster

Ohne Konfiguration durch Sie versucht die Leistungsüberwachung, das neueste Nutzungsverhalten Ihrer App widerzuspiegeln, indem die Anfragen 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 es aus den von Ihrer App gesendeten Anfragen abgeleitet hat. Beachten Sie jedoch, dass Firebase zunächst versucht, Anforderungs-URLs mit konfigurierten benutzerdefinierten URL-Mustern abzugleichen.

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

  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 Anforderungen an dieses URL-Muster aggregiert Firebase die Daten der Anforderungen unter dem automatischen URL-Muster example.com/germany/** .

  2. Nach einer Woche gehen die meisten Anfragen Ihrer 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 übereinstimmenden Anforderungen an dieses neue URL-Muster aggregiert Firebase die Daten der Anforderungen nur unter dem neuen URL-Muster. Firebase sammelt 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, sodass Firebase damit beginnt, diese beiden Anfragen mit example.com/germany/** abzugleichen.

    Firebase sammelt keine weiteren Anfragedaten unter example.com/germany/animals/** , da es 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 Anforderungen sind von neuen URL-Mustern betroffen. Firebase ordnet jede neue Anfrage dem repräsentativsten automatischen URL-Muster zu. Beachten Sie jedoch, dass Firebase zunächst versucht, Anforderungs-URLs mit konfigurierten benutzerdefinierten URL-Mustern abzugleichen.

Zeigen Sie automatische URL-Muster und ihre Daten an

Firebase zeigt alle URL-Muster und ihre aggregierten Daten auf der Unterregisterkarte Netzwerkanforderungen der Ablaufverfolgungstabelle an, die sich unten im Leistungs- Dashboard der Firebase-Konsole befindet.

Möglicherweise sehen Sie URL-Muster mit dem Label „Nicht kategorisiert“ . Hierbei handelt es sich um „allgemeine“ automatische URL-Muster, unter 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 mit seinem abgeleiteten automatischen URL-Musterabgleich nicht 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 Laufe der Zeit zu überwachen.

Besuchen Sie Benutzerdefinierte URL-Muster erstellen, um mehr zu erfahren.

Leistungsdaten verfolgen, anzeigen und filtern

Stellen Sie zum Anzeigen von Echtzeit-Leistungsdaten sicher, dass Ihre App eine Leistungsüberwachungs-SDK-Version verwendet, die mit der Echtzeit-Datenverarbeitung kompatibel ist. Erfahren Sie mehr über Echtzeit-Leistungsdaten .

Verfolgen Sie bestimmte Metriken in Ihrem Dashboard

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

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

Führen Sie die folgenden Schritte aus, um Ihrem Metrik-Board eine Metrik hinzuzufügen:

  1. Rufen Sie das Leistungs- Dashboard in der Firebase-Konsole auf.
  2. Klicken Sie auf eine leere Metrikkarte und wählen Sie dann eine vorhandene Metrik aus, die Sie Ihrem Board hinzufügen möchten.
  3. Klicken Sie auf einer ausgefüllten Metrikkarte auf , um weitere Optionen anzuzeigen, z. B. um eine Metrik zu ersetzen oder zu entfernen.

Das Metrik-Board zeigt gesammelte Metrikdaten im Laufe der Zeit, sowohl in grafischer Form als auch als numerische prozentuale Veränderung.

Erfahren Sie mehr über die Verwendung des Dashboards .

Traces und ihre Daten anzeigen

Um Ihre Ablaufverfolgungen anzuzeigen, gehen Sie zum Leistungs- Dashboard in der Firebase-Konsole, scrollen Sie nach unten zur Ablaufverfolgungstabelle und klicken Sie dann auf die entsprechende Unterregisterkarte. Die Tabelle zeigt einige Top-Metriken für jede Ablaufverfolgung, und Sie können die Liste sogar nach der prozentualen Änderung für eine bestimmte Metrik sortieren.

Die Leistungsüberwachung bietet eine Fehlerbehebungsseite in der Firebase-Konsole, die Metrikänderungen hervorhebt, sodass Sie die Auswirkungen von Leistungsproblemen auf Ihre Apps und Benutzer schnell beheben und minimieren können. Sie können die Seite zur Problembehandlung verwenden, wenn Sie Informationen zu potenziellen Leistungsproblemen erhalten, z. B. in den folgenden Szenarien:

  • Sie wählen relevante Metriken auf dem Dashboard aus und stellen ein großes Delta fest.
  • In der Ablaufverfolgungstabelle sortieren Sie, um die größten Deltas ganz oben anzuzeigen, und Sie sehen eine signifikante prozentuale Änderung.
  • Sie erhalten eine E-Mail-Benachrichtigung, die Sie über ein Leistungsproblem informiert.

Sie können auf folgende Weise auf die Fehlerbehebungsseite zugreifen:

  • Klicken Sie im Metrik-Dashboard auf die Schaltfläche Metrikdetails anzeigen .
  • Wählen Sie auf einer beliebigen Metrikkarte => Details anzeigen aus. Auf der Fehlerbehebungsseite werden Informationen zu der ausgewählten Metrik angezeigt.
  • Klicken Sie in der Ablaufverfolgungstabelle auf einen Ablaufverfolgungsnamen oder einen beliebigen Metrikwert in der Zeile, die dieser Ablaufverfolgung zugeordnet 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 einen Drilldown zu relevanten Metriken durchführen. Klicken Sie auf die Schaltfläche Filter , 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 Spuren .

Nächste Schritte

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