Erste Schritte mit der Leistungsüberwachung für Android

Hinweis

Falls noch nicht geschehen, Fügen Sie Firebase zu Ihrem Android-Projekt hinzu.

Schritt 1: Performance Monitoring SDK zur App hinzufügen

Nachdem Sie das Performance Monitoring SDK hinzugefügt haben, beginnt Firebase automatisch mit der Erfassung Daten für das Bildschirmrendering und die Daten Ihrer App die mit dem Lebenszyklus Ihrer App zusammenhängen (z. B. App-Startzeit). Damit Firebase Netzwerkanfragen überwachen kann, müssen Sie auch das Performance Monitoring-Gradle-Plug-in hinzufügen (nächster Schritt).

  1. In der Gradle-Datei des Moduls (auf App-Ebene) (normalerweise <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) Fügen Sie die Abhängigkeit für die Performance Monitoring-Bibliothek für Android hinzu. Wir empfehlen die Verwendung des Firebase Android BoM um die Versionsverwaltung der Bibliothek zu steuern. 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.2.0"))

    // Add the dependency for the Performance Monitoring library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-perf")
}

    Mit dem Firebase Android BoM Ihre App verwendet immer kompatible Versionen der Firebase Android Libraries.

    (Alternative) Firebase-Bibliotheksabhängigkeiten ohne BoM hinzufügen

    Wenn Sie Firebase BoM nicht verwenden, müssen Sie jede Firebase-Bibliotheksversion angeben in der Abhängigkeitszeile ein.

    Wenn Sie mehrere Firebase-Bibliotheken in Ihrer App verwenden, empfehlen wir Ihnen dringend, die Bibliotheksversionen mithilfe der BoM zu verwalten. So wird sichergestellt, dass alle Versionen kompatibel sind. 

    dependencies {
    // Add the dependency for the Performance Monitoring library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-perf:21.0.1")
}
         Suchen Sie nach einem Kotlin-spezifischen Bibliotheksmodul? Ab Oktober 2023 (Firebase BoM 32.5.0) können sowohl Kotlin- als auch Java-Entwickler das Hauptbibliotheksmodul verwenden. Weitere Informationen finden Sie in den häufig gestellten Fragen zu dieser Initiative.

  2. Kompilieren Sie Ihre Anwendung neu.

Schritt 2: Der App das Gradle-Plug-in Performance Monitoring hinzufügen

Nachdem Sie das Gradle-Plug-in Performance Monitoring hinzugefügt haben, startet Firebase automatisch zum Sammeln von Daten HTTP/S-Netzwerkanfragen. Mit dem Plug-in können Sie auch benutzerdefinierte Code-Traces mithilfe der Anmerkung @AddTrace instrumentieren.

  1. In der Gradle-Datei auf Stammebene (Projektebene) (<project>/build.gradle.kts oder <project>/build.gradle), fügen Sie den Gradle-Plug-in Performance Monitoring:

    Kotlin 

    plugins {
    // To benefit from the latest Performance Monitoring plugin features,
    // update your Android Gradle plugin dependency to at least v3.4.0
    id("com.android.application") version "7.3.0" apply false

    // Make sure that you have the Google services Gradle plugin dependency
    id("com.google.gms.google-services") version "4.4.2" apply false

    // Add the dependency for the Performance Monitoring Gradle plugin
    id("com.google.firebase.firebase-perf") version "1.4.2" apply false
}

    Groovy 

    plugins {
    // To benefit from the latest Performance Monitoring plugin features,
    // update your Android Gradle plugin dependency to at least v3.4.0
    id 'com.android.application' version '7.3.0' apply false

    // Make sure that you have the Google services Gradle plugin dependency
    id 'com.google.gms.google-services' version '4.4.2' apply false

    // Add the dependency for the Performance Monitoring Gradle plugin
    id 'com.google.firebase.firebase-perf' version '1.4.2' apply false
}

  2. Fügen Sie in der Gradle-Datei des Moduls (auf App-Ebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) das Performance Monitoring-Gradle-Plug-in hinzu:

    Kotlin 

    plugins {
    id("com.android.application")

    // Make sure that you have the Google services Gradle plugin
    id("com.google.gms.google-services")

    // Add the Performance Monitoring Gradle plugin
    id("com.google.firebase.firebase-perf")
    ...
}

    Groovy 

    plugins {
    id 'com.android.application'

    // Make sure that you have the Google services Gradle plugin
    id 'com.google.gms.google-services'

    // Add the Performance Monitoring Gradle plugin
    id 'com.google.firebase.firebase-perf'
    ...
}

  3. Kompilieren Sie Ihre Anwendung neu.

Schritt 3: 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. Ereignisse durch Wechseln der App zwischen Hintergrund und Vordergrund generieren durch das Wechseln zwischen Bildschirmen mit Ihrer App interagieren, und/oder Netzwerkanfragen auslösen.

  2. Rufen Sie das Dashboard Leistungs auf. der Firebase-Konsole. Die ersten Daten sollten innerhalb weniger Minuten angezeigt werden.

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

Schritt 4: (Optional) Protokollnachrichten für Leistungsereignisse ansehen

  1. Aktivieren Sie das Fehlerbehebungs-Logging für Performance Monitoring bei der Build-Erstellung, indem Sie ein <meta-data> hinzufügen -Element in die Datei AndroidManifest.xml Ihrer App ein. Beispiel:

    <application>
    <meta-data
      android:name="firebase_performance_logcat_enabled"
      android:value="true" />
</application>

  2. Prüfen Sie die Protokollmeldungen auf Fehler.

  3. Performance Monitoring kennzeichnet die Logeinträge mit FirebasePerformance. Logcat verwenden können Sie speziell die Trace-Dauer und das HTTP/S-Netzwerk aufrufen, fordern Sie Logging an, indem Sie den folgenden Befehl ausführen:

    adb logcat -s FirebasePerformance

  4. Suchen Sie nach den folgenden Logtypen, die darauf hinweisen, dass Performance Monitoring Logging von Leistungsereignissen:

    • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  5. Klicken Sie auf die URL, um Ihre Daten in der Firebase Console aufzurufen. Es kann einige Zeit dauern, bis die Daten im Dashboard aktualisiert werden.

Wenn Ihre App keine Leistungsereignisse protokolliert, lesen Sie die Fehlerbehebung Tipps

Schritt 5: (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 abgeschlossen ist. eine bestimmte Aufgabe oder eine Reihe von Aufgaben, wie das Laden einer Reihe von Bildern oder das Abfragen von in 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 den Anfang und das Ende eines benutzerdefinierten Code-Trace (und Fügen Sie die gewünschten benutzerdefinierten Messwerte hinzu. Verwenden Sie dazu die vom Performance Monitoring SDK bereitgestellte API. Bei Android-Apps können Sie auch die Dauer mit bestimmten Methoden @AddTrace-Annotation.

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 6: Anwendung bereitstellen und Ergebnisse prüfen

Nachdem Sie Performance Monitoring mit einem oder mehreren Testgeräten validiert haben, können Sie Stellen Sie die aktualisierte Version Ihrer Anwendung für Ihre Nutzer bereit.

Sie können die Leistungsdaten in der Dashboard zur Leistungsüberwachung der Firebase-Konsole.

Bekannte Probleme

  • Das Performance Monitoring Gradle-Plug-in v1.1.0 kann zu Abweichungen in Guava führen Abhängigkeiten, was zu folgendem Fehler führt:

    Error:Execution failed for task ':app:packageInstantRunResourcesDebug'.
> com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;

    Wenn Sie diese Fehlermeldung sehen, haben Sie folgende Möglichkeiten:

    • Aktualisiere das Performance Monitoring-Plug-in auf Version 1.1.1 oder höher (die neueste Version ist v1.4.2).

    • Ersetzen Sie die Zeile für die Plug-in-Abhängigkeit Performance Monitoring in der Gradle-Datei auf Stammebene (Projektebene) (<project>/build.gradle.kts) oder <project>/build.gradle) wie folgt:

      Kotlin 

      buildscript {
  // ...

  dependencies {
    // ...

    // Replace the standard Performance Monitoring plugin dependency line, as follows:
    classpath("com.google.firebase:perf-plugin:1.1.0") {
        exclude(group = "com.google.guava", module = "guava-jdk5")
    }
  }
}

      Groovy 

      buildscript {
  // ...

  dependencies {
    // ...

    // Replace the standard Performance Monitoring plugin dependency line, as follows:
    classpath('com.google.firebase:perf-plugin:1.1.0') {
        exclude group: 'com.google.guava', module: 'guava-jdk5'
    }
  }
}

  • Performance Monitoring gibt die Gesamtnutzlastgröße für HTTP-Netzwerkanfragen an, basierend auf dem im HTTP-Header „Content-Length“ festgelegten Wert. Dieser Wert ist möglicherweise nicht immer korrekt.

  • Performance Monitoring unterstützt nur den Hauptprozess in Multi-Prozess-Android-Apps.

Nächste Schritte