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.

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.

  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