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

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

Schritt 1: Performance Monitoring zur App hinzufügen

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

  3. Erstellen Sie anschließend 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 von Daten für HTTP/S-Netzwerkanfragen.

In Flutter ist die automatische Leistungsüberwachung für das Bildschirm-Rendering 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 Bildschirmübergänge erkennt.

Schritt 2: Leistungsereignisse für die erste Datenanzeige generieren

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

  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 Leistung auf. Die ersten Daten sollten innerhalb weniger Minuten angezeigt werden.

    Wenn Sie keine Anzeige Ihrer ursprünglichen Daten sehen, lesen Sie die Tipps zur Fehlerbehebung.

Schritt 3: (Optional) Logeinträge für Leistungsereignisse ansehen

  1. Prüfen Sie Ihre Logeinträge auf Fehlermeldungen.

    Performance Monitoring kennzeichnet seine Logeinträge mit den folgenden Tags, damit Sie Ihre Logeinträge 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 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 zu bestimmtem Code in Ihrer App im Blick behalten möchten, können Sie benutzerdefinierte Code-Traces instrumentieren.

Mit einem benutzerdefinierten Code-Trace können Sie messen, wie lange Ihre App für eine bestimmte Aufgabe oder eine Reihe von Aufgaben benötigt, z. B. für das Laden einer Reihe von Bildern oder das Abfragen Ihrer Datenbank. Der Standardmesswert für einen benutzerdefinierten Code-Trace ist die 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-Trace (und fügen alle gewünschten benutzerdefinierten Messwerte hinzu) mithilfe der API, die vom Performance Monitoring SDK bereitgestellt wird.

Weitere Informationen zu diesen Funktionen und dazu, wie Sie sie Ihrer App hinzufügen, finden Sie unter Monitoring für bestimmten Code hinzufügen.

Schritt 5: App bereitstellen und Ergebnisse prüfen

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.

Sie können die Leistungsdaten im Leistungs-Dashboard der Firebase Console im Blick behalten.

Nächste Schritte