Weitere Informationen zu Leistungsdaten für HTTP/S-Netzwerkanfragen (beliebige 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

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

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/** .

    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 .

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

Um Ihrem Metrik-Board eine Metrik hinzuzufügen, gehen Sie in der Firebase-Konsole zum Leistungs -Dashboard und klicken Sie dann auf die Registerkarte Dashboard . Klicken Sie auf eine leere Metrikkarte und wählen Sie dann eine vorhandene Metrik aus, die Sie Ihrem Board hinzufügen möchten. Klicken Sie auf einer auf more_vert, um weitere Optionen anzuzeigen, z. B. 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.

Wenn Sie in der Trace-Tabelle auf einen Trace-Namen klicken, können Sie sich durch verschiedene Bildschirme klicken, um den Trace zu untersuchen und einen Drilldown zu interessanten Metriken durchzuführen. Auf den meisten Seiten können Sie die Filter- -Schaltfläche (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 Seiten- URL , um Daten für eine bestimmte Seite Ihrer Website anzuzeigen
  • Filtern Sie nach effektivem Verbindungstyp , um zu erfahren, wie sich eine 3G-Verbindung auf Ihre App auswirkt
  • 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

  • Erfahren Sie mehr über die Verwendung von Attributen zur Untersuchung von Leistungsdaten.

  • Erfahren Sie mehr darüber, wie Sie Leistungsprobleme in der Firebase-Konsole nachverfolgen.

  • Richten Sie Warnungen 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 Schwellenwert überschreitet.