Erste Schritte mit der Leistungsüberwachung für Flutter

In dieser Kurzanleitung wird beschrieben, wie Sie Firebase Performance Monitoring einrichten, um einen Einblick in die Leistungsmerkmale Ihrer Flutter-Apps zu erhalten.

Hinweis

Konfigurieren und initialisieren Sie Firebase in Ihrem Flutter-Projekt, falls noch nicht geschehen.

Schritt 1: Performance Monitoring zur App hinzufügen

1. Führen Sie im Stammverzeichnis Ihres Flutter-Projekts folgenden Befehl aus: Befehl zum Installieren des Flutter-Plug-ins für Performance Monitoring:

   flutter pub add firebase_performance
   

2. Führen Sie im Stammverzeichnis Ihres Flutter-Projekts den folgenden Befehl aus:

   flutterfire configure
   

   Durch Ausführen dieses Befehls wird die Firebase-Konfiguration Ihrer Flutter-App aktuell ist und für Android die erforderliche Leistungsüberwachung Gradle-Plug-in zu Ihrer App hinzufügen.

3. Erstellen Sie danach das Flutter-Projekt neu:

   flutter run
   

Nachdem Sie das Performance Monitoring SDK hinzugefügt haben, beginnt Firebase automatisch, Daten zum Lebenszyklus Ihrer App (z. B. die App-Startzeit) und Daten für HTTP/S-Netzwerkanfragen zu erheben.

Bei Flutter ist die automatische Leistungsüberwachung des Bildschirmrenderings für einzelne Flutter-Bildschirme nicht möglich. Ein einzelner View Controller kapselt Ihre gesamte Flutter-Anwendung nativ ein, sodass das zugrunde liegende native Firebase SDK keine Bildschirmübergänge erkennt.

Hinweis :Wenn Sie Ihrer App Performance Monitoring hinzufügen, wird das Remote Config SDK als Abhängigkeit eingefügt werden. Wenn Sie Remote Config bereits verwenden, ändert sich nichts. Wenn Sie jedoch noch nicht mit Remote Config vertraut sind, sehen Sie sich die Weitere Informationen finden Sie in der Remote Config-Dokumentation. zu den verschiedenen Funktionen, auf die Sie in Ihrer App zugreifen können.

Schritt 2: Leistungsereignisse für die erste Datenanzeige generieren

Firebase beginnt mit der Verarbeitung der Ereignisse, sobald Sie das SDK Ihrer App hinzugefügt haben. Wenn Sie noch lokal entwickeln, interagieren Sie mit Ihrer App, um Ereignisse für die anfängliche Datenerhebung und -verarbeitung zu generieren.

Hinweis: Das Performance Monitoring SDK bündelt Ereignisse lokal und sendet sie dann regelmäßig (alle 30 Sekunden) oder wenn die App wieder im Vordergrund ist, an Firebase. Es gibt also eine Verzögerung zwischen einer App-Interaktion und dem Zeitpunkt, zu dem Firebase die Ereignisinformationen von Ihrer App empfängt.

1. Entwickeln Sie Ihre App weiter mit einem Simulator oder Testgerät.

2. Ereignisse durch Wechseln der App zwischen Hintergrund und Vordergrund generieren beim Wechseln zwischen Bildschirmen und der Interaktion mit Ihrer App und/oder Netzwerkanfragen auslösen.

3. Rufen Sie in der Firebase Console das Dashboard „Leistung“ auf. Die ersten Daten sollten innerhalb weniger Minuten angezeigt werden.

   Wenn Ihre ursprünglichen Daten nicht angezeigt werden, lesen Sie die Tipps zur Fehlerbehebung.

Schritt 3: Optional: Protokollmeldungen für Leistungsereignisse ansehen

1. Prüfen Sie Ihre Logeinträge auf Fehlermeldungen.

   Die Protokollmeldungen von Performance Monitoring sind mit den folgenden Tags getaggt, damit Sie sie filtern können:

   • iOS +: Firebase/Performance
   • Android: FirebasePerformance

2. Suchen Sie nach den folgenden Logtypen, die angeben, dass die Leistungsüberwachung Logging von Leistungsereignissen:

   • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
   • Logging network request trace: URL

3. Klicken Sie auf die URL, um Ihre Daten in der Firebase Console aufzurufen. Es kann einige Minuten dauern, bis die Daten im Dashboard aktualisiert werden.

Schritt 4: (Optional) Benutzerdefiniertes Monitoring für bestimmten Code hinzufügen

Wenn Sie Leistungsdaten im Zusammenhang mit bestimmtem Code in Ihrer App erfassen möchten, können Sie benutzerdefinierte Code-Traces instrumentieren.

Mit einem benutzerdefinierten Code-Trace können Sie messen, wie lange es dauert, bis Ihre App eine bestimmte Aufgabe oder eine Gruppe von Aufgaben abgeschlossen hat, z. B. das Laden einer Reihe von Bildern oder das Abfragen Ihrer Datenbank. Der Standardmesswert für einen benutzerdefinierten Code-Trace ist seine Dauer. können Sie auch benutzerdefinierte Messwerte wie Cache-Treffer und Arbeitsspeicherwarnungen hinzufügen.

In Ihrem Code definieren Sie mithilfe der vom Performance Monitoring SDK bereitgestellten API den Anfang und das Ende eines benutzerdefinierten Code-Traces und fügen beliebige benutzerdefinierte Messwerte hinzu.

Weitere Informationen finden Sie unter Monitoring für bestimmten Code hinzufügen. findest du weitere Informationen zu diesen Funktionen und dazu, wie du sie deiner App hinzufügst.

Schritt 5: App bereitstellen und Ergebnisse prüfen

Nachdem Sie die Leistungsüberwachung mit einem Emulator und mindestens einem Emulator validiert haben Testgeräte können Sie Ihren Nutzern die aktualisierte Version Ihrer App bereitstellen.

Sie können Leistungsdaten im Dashboard „Leistung“ der Firebase Console beobachten.

Nächste Schritte

• Weitere Informationen zu Daten, die automatisch über die Leistungsüberwachung erfasst werden:

  • Daten zum Lebenszyklus Ihrer App, z. B. App-Startzeit
  • Daten für ausgeführte HTTP/S-Netzwerkanfragen durch deine App

• Leistungsdaten in der Firebase Console ansehen, verfolgen und filtern

• Fügen Sie Monitoring für bestimmte Aufgaben oder Workflows in Ihrer App hinzu, indem Sie Instrumentierung von benutzerdefinierten Code-Traces.

• Leistungsdaten mithilfe von Attributen filtern