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
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
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.
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.
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.
Fahren Sie mit der Entwicklung Ihrer App mit einem Simulator oder Testgerät fort.
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.
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
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:
FirebasePerformance
- iOS +:
Prüfen Sie, ob die folgenden Arten von Protokollen vorhanden sind, die darauf hinweisen, dass Leistungsereignisse vom Leistungsmonitoring protokolliert werden:
Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
Logging network request trace: URL
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: Benutzerdefinierte Überwachung 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. Sie können aber auch benutzerdefinierte Messwerte wie Cachetreffer 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.
Unter Monitoring für bestimmten Code hinzufügen finden Sie weitere Informationen zu diesen Funktionen und dazu, wie Sie sie Ihrer App 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.