Beginnen Sie mit der Leistungsüberwachung für Flutter

In dieser Schnellstartanleitung wird beschrieben, wie Sie die Firebase-Leistungsüberwachung einrichten, um Einblicke in die Leistungsmerkmale Ihrer Flutter-Apps zu erhalten.

Bevor Sie beginnen

Falls noch nicht geschehen, konfigurieren und initialisieren Sie Firebase in Ihrem Flutter-Projekt.

Schritt 1 : Fügen Sie Ihrer App Leistungsüberwachung hinzu

  1. Führen Sie im Stammverzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um das Performance Monitoring Flutter-Plugin zu installieren:

    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 sichergestellt, dass die Firebase-Konfiguration Ihrer Flutter-App auf dem neuesten Stand ist, und für Android wird Ihrer App das erforderliche Performance Monitoring Gradle-Plugin 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 Daten für HTTP/S-Netzwerkanfragen .

Bei Flutter ist eine automatische Überwachung der Bildschirmwiedergabeleistung für einzelne Flutter-Bildschirme nicht möglich. Ein einzelner View-Controller kapselt Ihre gesamte Flutter-Anwendung nativ, sodass das zugrunde liegende native Firebase SDK keine Kenntnis von Bildschirmübergängen hat.

Schritt 2 : Leistungsereignisse für die erste Datenanzeige generieren

Firebase beginnt mit der Verarbeitung der Ereignisse, wenn Sie das SDK erfolgreich zu Ihrer App hinzugefügt haben. Wenn Sie noch lokal entwickeln, interagieren Sie mit Ihrer App, um Ereignisse für die erste Datenerfassung und -verarbeitung zu generieren.

  1. Entwickeln Sie Ihre App mithilfe eines Simulators oder Testgeräts weiter.

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

  3. Gehen Sie zum Performance- Dashboard der Firebase-Konsole. Innerhalb weniger Minuten sollten Sie Ihre erste Datenanzeige sehen.

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

Schritt 3 : (Optional) Protokollmeldungen für Leistungsereignisse anzeigen

  1. Überprüfen Sie Ihre Protokollnachrichten auf etwaige Fehlermeldungen.

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

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance
  2. Suchen Sie nach den folgenden Protokolltypen, 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-Konsole anzuzeigen. Es kann einen Moment dauern, bis die Daten im Dashboard aktualisiert werden.

Schritt 4 : (Optional) Fügen Sie eine benutzerdefinierte Überwachung für bestimmten Code hinzu

Um Leistungsdaten zu überwachen, die einem bestimmten Code in Ihrer App zugeordnet sind, können Sie benutzerdefinierte Code-Traces instrumentieren.

Mit einem benutzerdefinierten Code-Trace können Sie messen, wie lange Ihre App benötigt, um eine bestimmte Aufgabe oder eine Reihe von Aufgaben abzuschließen, z. B. das Laden einer Reihe von Bildern oder das Abfragen Ihrer Datenbank. Die Standardmetrik für einen benutzerdefinierten Code-Trace ist seine Dauer. Sie können jedoch auch benutzerdefinierte Metriken hinzufügen, z. B. Cache-Treffer und Speicherwarnungen.

In Ihrem Code definieren Sie den Anfang und das Ende eines benutzerdefinierten Code-Trace (und fügen alle gewünschten benutzerdefinierten Metriken hinzu), indem Sie die vom Performance Monitoring SDK bereitgestellte API verwenden.

Besuchen Sie „Überwachung für bestimmten Code hinzufügen“, um mehr über diese Funktionen zu erfahren und wie Sie sie Ihrer App hinzufügen können.

Schritt 5 : Stellen Sie Ihre App bereit und überprüfen Sie dann die Ergebnisse

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 Benutzer bereitstellen.

Sie können Leistungsdaten im Leistungs- Dashboard der Firebase-Konsole überwachen.

Nächste Schritte