Erste Schritte mit der Leistungsüberwachung für Flutter

In dieser Kurzanleitung wird beschrieben, wie Sie Firebase Performance Monitoring einrichten, um Einblicke 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 in Ihre App einfügen

1. Führen Sie im Stammverzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um das Performance Monitoring-Flutter-Plug-in 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 aktualisiert und für Android wird das erforderliche Gradle-Plug-in für Performance Monitoring zu Ihrer App hinzugefügt.

3. Wenn Sie fertig sind, erstellen Sie Ihr Flutter-Projekt neu:

   flutter run
   

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

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

Hinweis :Wenn Sie Performance Monitoring in Ihre App einbinden, ist das Remote Config SDK als Abhängigkeit enthalten. Wenn Sie Remote Config bereits verwenden, werden Sie keinen Unterschied feststellen. Wenn Sie Remote Config noch nicht kennen, können Sie in der Remote Config-Dokumentation mehr über die verschiedenen Funktionen 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, wenn Sie das SDK erfolgreich in Ihre App eingebunden haben. Wenn Sie noch lokal entwickeln, interagieren Sie mit Ihrer App, um Ereignisse für die erste Datenerhebung und ‑verarbeitung zu generieren.

Hinweis :Das Performance Monitoring SDK fasst Ereignisse lokal zusammen und sendet sie dann regelmäßig (alle 30 Sekunden) oder wenn die App wieder in den Vordergrund kommt an Firebase. Daher gibt es 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 mit einem Simulator oder Testgerät weiter.

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

3. Rufen Sie in der Firebase Console das Dashboard zur Leistungsüberwachung auf. Die ersten Daten sollten innerhalb weniger Minuten angezeigt werden.

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

Schritt 3: (Optional) Log-Nachrichten für Leistungsereignisse ansehen

1. Prüfen Sie Ihre Logmeldungen auf Fehlermeldungen.

   Performance Monitoring kennzeichnet seine Lognachrichten mit den folgenden Tags, damit Sie Ihre Lognachrichten filtern können:

   • iOS+: Firebase/Performance
   • Android: 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 einige Momente dauern, bis die Daten im Dashboard aktualisiert werden.

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

Wenn Sie Leistungsdaten für bestimmten 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 Ihre App für die Ausführung einer bestimmten Aufgabe oder einer Reihe von Aufgaben benötigt, z. B. zum Laden einer Reihe von Bildern oder zum 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 den Anfang und das Ende eines benutzerdefinierten Code-Traces und fügen mithilfe der API des Performance Monitoring SDK alle gewünschten benutzerdefinierten Messwerte hinzu.

Weitere Informationen zu diesen Funktionen und dazu, wie Sie sie in Ihre App einfügen, finden Sie hier.

Schritt 5: App bereitstellen und Ergebnisse ansehen

Nachdem Sie Performance Monitoring mit einem Emulator und einem oder mehreren Testgeräten validiert haben, können Sie die aktualisierte Version Ihrer App für Ihre Nutzer bereitstellen.

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

Nächste Schritte

• Weitere Informationen zu Daten, die automatisch von Performance Monitoring erfasst werden:

  • Daten zum Lebenszyklus Ihrer App, z. B. die Startzeit der App
  • Daten für HTTP/S-Netzwerkanfragen, die von Ihrer App gesendet werden

• Leistungsdaten in der Firebase Console ansehen, verfolgen und filtern

• Sie können die Überwachung für bestimmte Aufgaben oder Arbeitsabläufe in Ihrer App hinzufügen, indem Sie benutzerdefinierte Code-Traces instrumentieren.

• Leistungsdaten mit Attributen filtern