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: Leistungsüberwachung zur App hinzufügen

1. Führen Sie im Stammverzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um das Flutter-Plug-in für die Leistungsüberwachung zu installieren:

   flutter pub add firebase_performance
   

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

   flutterfire configure
   

   Wenn Sie diesen Befehl ausführen, wird die Firebase-Konfiguration Ihrer Flutter-App auf den neuesten Stand gebracht und Ihrer Android-App wird das erforderliche Gradle-Plug-in für die Leistungsüberwachung hinzugefügt.

3. Erstellen Sie anschließend Ihr Flutter-Projekt neu:

   flutter run
   

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

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 die Funktion „Leistungsüberwachung“ hinzufügen, wird das Remote Config SDK als Abhängigkeit hinzugefügt. Wenn Sie Remote Config bereits verwenden, ändert sich nichts. Wenn Sie mit Remote Config noch nicht vertraut sind, lesen Sie die Remote Config-Dokumentation, um mehr über die verschiedenen Funktionen zu erfahren, 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. Daher gibt es eine Verzögerung zwischen einer App-Interaktion und dem Empfang der Ereignisinformationen von Ihrer App durch Firebase.

1. Fahren Sie mit der Entwicklung Ihrer App mit einem Simulator oder Testgerät fort.

2. Erzeugen Sie Ereignisse, indem Sie Ihre App mehrmals zwischen Hintergrund und Vordergrund wechseln, mit Ihrer App interagieren, indem Sie zwischen Bildschirmen wechseln, und/oder Netzwerkanfragen auslösen.

3. Rufen Sie in der Firebase Console das Dashboard Leistungs auf. Die erste Datenanzeige sollte 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 die Protokollmeldungen auf Fehler.

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

   • iOS +: Firebase/Performance
   • Android-Gerät: FirebasePerformance

2. Suchen Sie nach den folgenden Arten von Logs, die darauf hinweisen, dass Performance Monitoring Leistungsereignisse protokolliert:

   • 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 einen Moment dauern, bis die Daten im Dashboard aktualisiert werden.

Schritt 4: Optional: Benutzerdefinierte Überwachung für bestimmten Code hinzufügen

Zum Überwachen von Leistungsdaten, die mit einem bestimmten Code in Ihrer App verknüpft sind, 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 Reihe von Aufgaben erledigt 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. Sie können aber auch benutzerdefinierte Messwerte wie Cache-Treffer und Speicherwarnungen 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 zu diesen Features und dazu, wie Sie sie Ihrer Anwendung hinzufügen, finden Sie unter Monitoring für bestimmten Code hinzufügen.

Schritt 5: App bereitstellen und Ergebnisse prüfen

Nachdem Sie die Leistungsüberwachung mit einem Emulator und einem oder mehreren Testgeräten validiert haben, können Sie die aktualisierte Version Ihrer App für Ihre Nutzer 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. Startzeit der App
  • Daten zu HTTP/S-Netzwerkanfragen, die von Ihrer App gesendet wurden

• Leistungsdaten in der Firebase Console ansehen, verfolgen und filtern

• Sie können die Überwachung bestimmter Aufgaben oder Workflows in Ihrer App hinzufügen, indem Sie benutzerdefinierte Code-Traces instrumentieren.

• Leistungsdaten mithilfe von Attributen filtern