Performance Monitoring – Fehlerbehebung und FAQs

iOS+ Android Web

Auf dieser Seite finden Sie Tipps zur Fehlerbehebung für die ersten Schritte mit Performance Monitoring oder für die Verwendung von Performance Monitoring-Funktionen und -Tools.

Erste Schritte zur Fehlerbehebung

Die folgenden beiden Prüfungen sind allgemeine Best Practices, die vor der weiteren Fehlerbehebung empfohlen werden.

1. Logeinträge auf Leistungsereignisse prüfen

Prüfen Sie anhand der Log-Nachrichten, ob das Performance Monitoring SDK Leistungsereignisse erfasst.

So rufen Sie Logeinträge für Leistungsereignisse auf

1. Aktivieren Sie das Debug-Logging für Performance Monitoring zum Zeitpunkt des Builds, indem Sie der AndroidManifest.xml-Datei Ihrer App ein <meta-data>-Element hinzufügen. Beispiel:

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

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

3. Performance Monitoring kennzeichnet die Logeinträge mit FirebasePerformance. Mit der Logcat-Filterung können Sie sich mit dem folgenden Befehl speziell die Dauer der Traces und das Logging von HTTP/S-Netzwerkanfragen ansehen:

   adb logcat -s FirebasePerformance

4. Prüfen Sie die 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

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

Wenn Ihre Anwendung keine Leistungsereignisse protokolliert, lesen Sie die Tipps zur Fehlerbehebung.

2. Firebase-Status-Dashboard prüfen

Sehen Sie im Firebase-Status-Dashboard nach, ob ein bekannter Ausfall für Firebase oder Performance Monitoring vorliegt.

Erste Schritte mit Performance Monitoring

Bei den ersten Schritten mit Performance Monitoring (iOS+ | Android | Web) können die folgenden Tipps zur Fehlerbehebung bei Problemen hilfreich sein, bei denen Firebase das SDK erkennt oder Ihre ersten Leistungsdaten in der Firebase-Konsole angezeigt werden.

Ich habe das SDK der App hinzugefügt, aber in der Console wird weiterhin angezeigt, dass ich das SDK hinzufügen soll.

Firebase kann erkennen, ob Sie Ihrer App das Performance Monitoring SDK hinzugefügt haben, wenn es Ereignisinformationen (z. B. App-Interaktionen) von Ihrer App empfängt. In der Regel wird innerhalb von 10 Minuten nach dem Starten Ihrer App im Dashboard „Leistung“ der Firebase-Konsole die Meldung „SDK erkannt“ angezeigt. Innerhalb von 30 Minuten zeigt das Dashboard dann die ursprünglich verarbeiteten Daten an.

Wenn Sie Ihrer App vor mehr als 10 Minuten die neueste Version des SDKs hinzugefügt haben und immer noch keine Änderungen sehen, prüfen Sie die Protokollmeldungen, um sicherzustellen, dass Performance Monitoring Ereignisse protokolliert. Führen Sie die unten beschriebenen Schritte zur Fehlerbehebung aus, um eine Meldung zur verzögerten SDK-Erkennung zu beheben.

Die App protokolliert Ereignisse: Schritte zur Fehlerbehebung

Hinweis: Das Performance Monitoring SDK bündelt Ereignisse lokal und sendet sie dann regelmäßig an Firebase. Es gibt also eine Verzögerung zwischen einer App-Interaktion und dem Zeitpunkt, zu dem Firebase die Ereignisinformationen von Ihrer App empfängt.

1. Achte darauf, dass du das Performance Monitoring Android SDK 19.1.0 oder höher (oder Firebase BoM 26.3.0 oder höher) verwendest. Weitere Informationen findest du in den Versionshinweisen.

2. Wenn Sie noch lokal entwickeln, versuchen Sie, mehr Ereignisse für die Datenerhebung zu generieren:

   1. Sie können Ereignisse generieren, indem Sie Ihre App mehrmals zwischen Hintergrund und Vordergrund wechseln, mit Ihrer App über Bildschirme interagieren und/oder Netzwerkanfragen auslösen.

3. Achten Sie darauf, dass die Firebase-Konfigurationsdatei (google-services.json) Ihrer Anwendung korrekt hinzugefügt wurde und Sie die Datei nicht geändert haben. Überprüfen Sie insbesondere Folgendes:

   • Der Name der Konfigurationsdatei enthält keine zusätzlichen Zeichen wie z. B. (2).

   • Die Konfigurationsdatei befindet sich im Verzeichnis module (App-Ebene) Ihrer App.

   • Die in der Konfigurationsdatei angegebene Firebase-Android-App-ID (mobilesdk_app_id) ist für Ihre App korrekt. Sie finden Ihre Firebase-App-ID auf der Karte Meine Apps in den Projekteinstellungen von .

   Wenn die Konfigurationsdatei in Ihrer App nicht richtig aussieht, versuchen Sie Folgendes:

   1. Löschen Sie die Konfigurationsdatei, die sich derzeit in Ihrer App befindet.

   2. Folgen Sie dieser Anleitung, um eine neue Konfigurationsdatei herunterzuladen und Ihrer Android-App hinzuzufügen.

4. Wenn das SDK Ereignisse protokolliert und alles korrekt eingerichtet zu sein scheint, die SDK-Erkennungsmeldung oder verarbeitete Daten immer noch nicht angezeigt werden (nach 10 Minuten), wenden Sie sich an den Firebase-Support.

Die App protokolliert keine Ereignisse: Schritte zur Fehlerbehebung

1. So prüfen Sie die Einrichtung des Gradle-Plug-ins Performance Monitoring:

   1. Prüfen Sie, ob Sie das Plug-in richtig hinzugefügt haben. Prüfen Sie insbesondere Folgendes:

      • Sie haben das Plug-in (apply plugin: 'com.google.firebase.firebase-perf') in der Datei build.gradle Modul (auf App-Ebene) hinzugefügt.
      • Sie haben die ClassPath-Abhängigkeit für das Plug-in (classpath 'com.google.firebase:perf-plugin:1.4.2') in die Datei build.gradle auf Projektebene aufgenommen.

   2. Achten Sie darauf, dass das Plug-in nicht durch eines der folgenden Flags deaktiviert ist:

      • instrumentationEnabled in der build.gradle-Datei des Moduls (auf Anwendungsebene)
      • firebasePerformanceInstrumentationEnabled in der Datei gradle.properties

2. Prüfen Sie, ob das Performance Monitoring SDK nicht über eines der folgenden Flags in der Datei AndroidManifest.xml deaktiviert wurde:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

3. Achten Sie darauf, dass Performance Monitoring nicht zur Laufzeit deaktiviert ist.

4. Wenn Sie in Ihrer App nichts finden, das deaktiviert ist, wenden Sie sich an den Firebase-Support.

In der Console wird angezeigt, dass das SDK erkannt wurde, aber es werden keine Daten angezeigt

Performance Monitoring verarbeitet Leistungsereignisdaten, bevor sie im Dashboard „Leistung“ angezeigt werden.

Wenn mehr als 24 Stunden seit dem Erscheinen der Meldung „SDK erkannt“ vergangen sind und Sie immer noch keine Daten sehen, prüfen Sie das Firebase-Status-Dashboard, um einen bekannten Ausfall zu erhalten. Wenn kein Ausfall vorliegt, wenden Sie sich an den Firebase-Support.

Allgemeine Fehlerbehebung

Wenn du das SDK erfolgreich hinzugefügt hast und Performance Monitoring in deiner App verwendest, können dir die folgenden Tipps zur Fehlerbehebung bei allgemeinen Problemen im Zusammenhang mit den Funktionen und Tools von Performance Monitoring helfen.

Anwendung protokolliert keine Leistungsereignisse

Wenn keine Protokollmeldungen für Leistungsereignisse angezeigt werden, führen Sie die folgenden Schritte zur Fehlerbehebung aus:

1. So prüfen Sie die Einrichtung des Gradle-Plug-ins Performance Monitoring:

   1. Prüfen Sie, ob Sie das Plug-in korrekt hinzugefügt haben. Prüfen Sie insbesondere Folgendes:

      • Sie haben das Plug-in (apply plugin: 'com.google.firebase.firebase-perf') in der Datei build.gradle Modul (auf App-Ebene) hinzugefügt.
      • Sie haben die Klassenpfad-Abhängigkeit für das Plug-in (classpath 'com.google.firebase:perf-plugin:1.4.2') in die Datei build.gradle auf Projektebene aufgenommen.

   2. Achten Sie darauf, dass das Plug-in nicht über eines der folgenden Flags deaktiviert ist:

      • instrumentationEnabled in der Datei build.gradle des Moduls (auf App-Ebene)
      • firebasePerformanceInstrumentationEnabled in der Datei gradle.properties

2. Prüfen Sie, ob das Performance Monitoring SDK nicht über eines der folgenden Flags in der Datei AndroidManifest.xml deaktiviert wurde:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

3. Achten Sie darauf, dass Performance Monitoring nicht zur Laufzeit deaktiviert ist.

4. Wenn Sie in Ihrer Anwendung nichts deaktiviertes finden, wenden Sie sich an den Firebase-Support.

Im Dashboard zur Leistungsüberwachung fehlen Bildschirm-Trace-Daten

Wenn Daten für Bildschirm-Rendering-Traces fehlen, führen Sie die folgenden Schritte zur Fehlerbehebung aus:

1. Achte darauf, dass du die neueste Version des Android SDK (Version 21.0.2) verwendest. Bildschirm-Rendering-Tracks sind nur mit Version 15.2.0 oder höher verfügbar.

2. Achten Sie darauf, dass Sie die Hardwarebeschleunigung für einen Bildschirm nicht manuell deaktiviert haben.

3. DexGuard oder Jack dürfen nicht verwendet werden. Performance Monitoring ist mit diesen Toolchains nicht kompatibel.

   • DexGuard deaktiviert die automatische Erfassung von App-Start-, App-im-Vordergrund- und App-im-Hintergrund-Spuren. Alle benutzerdefinierten Code-Traces sollten sich jedoch normal verhalten, wenn Ihre App DexGuard verwendet.

   • Jack wurde eingestellt und sollte im Allgemeinen nicht in Ihrer App verwendet werden.

Im Dashboard zur Leistungsüberwachung fehlen benutzerdefinierte Trace-Daten

Sehen Sie Leistungsdaten für automatisch erfasste Traces, aber nicht für benutzerdefinierte Code-Traces? Führen Sie die folgenden Schritte zur Fehlerbehebung aus:

1. Wenn Sie benutzerdefinierte Code-Traces über die Trace API instrumentiert haben, überprüfen Sie die Einrichtung der Traces insbesondere auf Folgendes:

   • Namen für benutzerdefinierte Code-Traces und benutzerdefinierte Messwerte müssen die folgenden Anforderungen erfüllen: keine anführenden oder nachgestellten Leerzeichen, kein anführendes Unterstrichzeichen (_) und eine maximale Länge von 32 Zeichen.
   • Alle Traces müssen gestartet und beendet werden. Trace, das nicht gestartet, nicht beendet oder vor dem Start beendet wurde, wird nicht in Logs geschrieben.

2. Wenn Sie benutzerdefinierte Code-Traces über die @AddTrace-Notation instrumentiert haben, prüfen Sie die Einrichtung des Performance Monitoring-Gradle-Plug-ins:

   1. Prüfen Sie, ob Sie das Plug-in richtig hinzugefügt haben. Prüfen Sie insbesondere Folgendes:

      • Sie haben das Plug-in (apply plugin: 'com.google.firebase.firebase-perf') in der Datei build.gradle Modul (auf App-Ebene) hinzugefügt.
      • Sie haben die ClassPath-Abhängigkeit für das Plug-in (classpath 'com.google.firebase:perf-plugin:1.4.2') in die Datei build.gradle auf Projektebene aufgenommen.

   2. Achten Sie darauf, dass das Plug-in nicht durch eines der folgenden Flags deaktiviert ist:

      • instrumentationEnabled in der build.gradle-Datei des Moduls (auf Anwendungsebene)
      • firebasePerformanceInstrumentationEnabled in Ihrer gradle.properties-Datei

3. Sehen Sie in den Logeinträgen nach, ob Performance Monitoring erwartete benutzerdefinierte Code-Traces protokolliert.

4. Wenn Performance Monitoring Ereignisse aufzeichnet, nach 24 Stunden aber keine Daten angezeigt werden, wenden Sie sich an den Firebase-Support.

Im Dashboard zur Leistungsüberwachung fehlen Daten zu Netzwerkanfragen

Wenn Daten zu Netzwerkanfragen fehlen, versuchen Sie Folgendes:

1. Für Android-Apps aktiviert das Gradle-Plug-in Performance Monitoring eine Instrumentierung für die automatische Überwachung von HTTP/S-Netzwerkanfragen. Dann machen Sie Folgendes:

   1. Prüfen Sie, ob Sie das Plug-in korrekt hinzugefügt haben. Überprüfen Sie insbesondere Folgendes:

      • Sie haben das Plug-in (apply plugin: 'com.google.firebase.firebase-perf') in der Datei build.gradle Modul (auf App-Ebene) hinzugefügt.
      • Sie haben die Klassenpfad-Abhängigkeit für das Plug-in (classpath 'com.google.firebase:perf-plugin:1.4.2') in die Datei build.gradle auf Projektebene aufgenommen.

   2. Achten Sie darauf, dass das Plug-in nicht über eines der folgenden Flags deaktiviert ist:

      • instrumentationEnabled in der build.gradle-Datei des Moduls (auf Anwendungsebene)
      • firebasePerformanceInstrumentationEnabled in der Datei gradle.properties

2. Prüfen Sie, ob die Netzwerkbibliothek nicht kompatibel ist. Performance Monitoring erfasst automatisch Messwerte für Netzwerkanfragen, die die folgenden Netzwerkbibliotheken verwenden: OkHttp 3.x.x, URLConnection von Java und Apache HttpClient.

   Beachten Sie, dass Sie ein benutzerdefiniertes Monitoring für Netzwerkanfragen hinzufügen können.

3. Beachten Sie Folgendes:

   • Je nach Verhalten Ihres Codes und der von Ihrem Code verwendeten Netzwerkbibliotheken werden in Performance Monitoring möglicherweise nur Netzwerkanfragen erfasst, die abgeschlossen wurden. Dies bedeutet, dass offene HTTP/S-Verbindungen möglicherweise nicht gemeldet werden.

   • Performance Monitoring ist nicht mit DexGuard und Jack kompatibel.

     • DexGuard deaktiviert die Überwachung von HTTP/S-Netzwerkanfragen.
     • Jack wurde eingestellt und sollte in der Regel nicht in Ihrer App verwendet werden.

   • Performance Monitoring meldet keine Netzwerkanfragen mit ungültigen Content-Type-Headern. Netzwerkanfragen ohne die Content-Type-Header werden jedoch weiterhin akzeptiert.

Netzwerkanfragedaten werden nicht wie erwartet zusammengefasst

Weitere Informationen dazu, wie Performance Monitoring Daten zu Netzwerkanfragen nach URL-Mustern aggregiert

Du kannst auch benutzerdefinierte URL-Muster ausprobieren.

FAQ

iOS+ Android Web

Was ist mit den häufigsten Problemen auf der Karte „Leistung“ auf der Projektstartseite passiert?

Wir haben Häufigste Probleme durch Letzte Benachrichtigungen ersetzt. Dies ist eine Folge der Einführung von Benachrichtigungen, die Sie automatisch informieren, wenn die von Ihnen festgelegten Grenzwerte überschritten werden. Probleme wurden verworfen und durch Benachrichtigungen ersetzt.

Mit der Anwendungsauswahl oben auf der Karte „Leistung“ werden die Benachrichtigungseinträge unter Letzte Benachrichtigungen herausgefiltert. Es werden nur die drei letzten Benachrichtigungen für die ausgewählten Apps angezeigt.

Weitere Informationen zu Benachrichtigungen finden Sie unter Benachrichtigungen für Leistungsprobleme einrichten.

Wo ist die Möglichkeit geblieben, Grenzwerte für Probleme in der Konsole festzulegen?

Performance Monitoring unterstützt Benachrichtigungen für Messwerte, die festgelegte Schwellenwerte überschreiten. Um Verwechslungen mit diesen konfigurierbaren Grenzwerten für Leistungsmesswerte zu vermeiden, haben wir die Möglichkeit entfernt, Grenzwerte für Probleme zu konfigurieren.

Was ist mit den Details und Messwerten in der Firebase-Konsole passiert?

Wir haben die Seiten „Details“ und „Messwerte“ durch eine neu gestaltete, zentralisierte Benutzeroberfläche (UI) ersetzt, um die Fehlerbehebung zu erleichtern. Diese neue Benutzeroberfläche für die Fehlerbehebung bietet dieselben grundlegenden Funktionen wie „Details“ und „Messwerte“. Weitere Informationen zur Fehlerbehebung finden Sie unter Weitere Daten für einen bestimmten Trace ansehen.

Warum entspricht die Anzahl der Stichproben nicht meinen Erwartungen?

Performance Monitoring erhebt Leistungsdaten von den Nutzergeräten Ihrer App. Wenn Ihre Anwendung viele Nutzer hat oder wenn sie eine große Menge an Leistungsaktivitäten generiert, kann Performance Monitoring die Datenerfassung auf eine Teilmenge von Geräten beschränken, um die Anzahl der verarbeiteten Ereignisse zu reduzieren. Diese Limits sind so hoch, dass die Messwerte auch bei weniger Ereignissen repräsentativ für die App-Nutzung Ihrer Nutzer sind.

Zur Verwaltung der von uns erhobenen Datenmenge verwendet Performance Monitoring die folgenden Optionen für die Stichprobenerhebung:

• Taktbeschränkung auf dem Gerät: Um zu verhindern, dass ein Gerät plötzlich viele Traces sendet, beschränken wir die Anzahl der Code- und Netzwerkanfrage-Traces, die von einem Gerät gesendet werden, auf 300 Ereignisse alle 10 Minuten. Dieser Ansatz schützt das Gerät vor Instrumenten in Schleife, die große Mengen an Leistungsdaten senden können, und verhindert, dass ein einzelnes Gerät die Leistungsmessungen verfälscht.

• Dynamisches Sampling: Performance Monitoring erfasst täglich eine begrenzte Anzahl von Code-Traces und Netzwerkanfrage-Traces pro App für alle App-Nutzer. Von Geräten wird (mit Firebase Remote Config) eine dynamische Abtastrate abgerufen, um zu bestimmen, ob ein zufälliges Gerät Traces erfassen und senden soll. Ein Gerät, das nicht für die Stichprobenerhebung ausgewählt ist, sendet keine Ereignisse. Die dynamische Stichprobenrate ist anwendungsspezifisch und wird so angepasst, dass das Gesamtvolumen der erfassten Daten unter dem Limit bleibt.

  Projekte, die die BigQuery-Integration aktiviert haben, erhalten ein höheres Limit für die Anzahl der Traces von Netzwerkanfragen.

  Bei Nutzersitzungen werden zusätzliche, detaillierte Daten vom Gerät eines Nutzers gesendet. Das Erfassen und Senden der Daten erfordert mehr Ressourcen. Um die Auswirkungen von Nutzersitzungen zu minimieren, kann Performance Monitoring auch die Anzahl der Sitzungen begrenzen.

• Serverseitige Ratenbegrenzung: Damit Apps das Limit für die Stichprobenerhebung nicht überschreiten, kann Performance Monitoring mithilfe von serverseitigen Stichproben einige Ereignisse löschen, die von Geräten empfangen werden. Diese Art der Begrenzung ändert zwar nicht die Effektivität unserer Messwerte, kann aber zu geringfügigen Musterverschiebungen führen, darunter:

  • Die Anzahl der Traces kann von der Häufigkeit abweichen, mit der ein Code ausgeführt wurde.
  • Im Code eng gekoppelte Traces können jeweils eine unterschiedliche Anzahl von Beispielen haben.

Hinweis: Bestimmte Stichprobenlimits und ihre Anwendung können sich im Laufe der Zeit ändern.

Was ist mit dem Tab Probleme in der Console passiert?

Wir haben den Tab „Probleme“ durch die Einführung von Benachrichtigungen ersetzt, die dich automatisch benachrichtigen, wenn die von dir festgelegten Grenzwerte überschritten werden. Sie müssen nicht mehr manuell in der Firebase-Konsole nachsehen, um den Status eines Schwellenwerts zu ermitteln. Weitere Informationen zu Benachrichtigungen finden Sie unter Benachrichtigungen für Leistungsprobleme einrichten.

Was ist mit den Tabs Auf dem Gerät und Netzwerk in der Konsole passiert? Wie kann ich mir die Spuren ansehen, die auf diesen Seiten vorhanden waren?

Wir haben den Bereich Performance Monitoring der Firebase-Konsole neu gestaltet, damit auf dem Tab Dashboard Ihre wichtigsten Messwerte und alle Traces an einem Ort angezeigt werden. Im Rahmen des Redesigns haben wir die Seiten Auf dem Gerät und Netzwerk entfernt.

Die Traces-Tabelle unten auf dem Tab Dashboard enthält dieselben Informationen wie die Tabs Auf dem Gerät und Netzwerk. Sie bietet jedoch einige zusätzliche Funktionen, z. B. die Möglichkeit, Traces nach der prozentualen Änderung für einen bestimmten Messwert zu sortieren. Klicken Sie in der Trace-Tabelle auf den Trace-Namen, um alle Messwerte und Daten für einen bestimmten Trace anzusehen.

Sehen Sie sich Ihre Traces auf den folgenden Untertabs der Traces-Tabelle an:

• Netzwerkanfrage-Traces (sowohl vordefinierte als auch benutzerdefinierte) – Untertab Netzwerkanfragen
• Traces mit benutzerdefiniertem Code – Untertab Benutzerdefinierte Traces
• App-Start, App im Vordergrund, App im Hintergrund – Untertab Benutzerdefinierte Traces
• Bildschirm-Rendering-Traces – Untertab Bildschirm-Rendering
• Seitenaufbau-Traces – Untertab Seitenaufbau

Weitere Informationen zur Trace-Tabelle und zum Ansehen von Messwerten und Daten finden Sie auf der Übersichtsseite der Console (iOS+ | Android | Web).

Warum entspricht die Anzahl der langsamen und eingefrorenen Frames nicht meinen Erwartungen?

Langsame Rendering-Frames und eingefrorene Frames werden mit einer angenommenen Geräteaktualisierungsrate von 60 Hz berechnet. Wenn die Bildwiederholrate eines Geräts unter 60 Hz liegt, dauert das Rendern jedes Frames länger, da weniger Frames pro Sekunde gerendert werden. Langsamere Renderingzeiten können dazu führen, dass mehr langsame oder eingefrorene Frames gemeldet werden, da mehr Frames langsamer gerendert werden oder einfrieren. Wenn die Bildwiederholrate eines Geräts jedoch über 60 Hz liegt, ist die Renderingzeit für jeden Frame kürzer. Dadurch werden möglicherweise weniger langsame oder eingefrorene Frames gemeldet. Dies ist eine aktuelle Einschränkung im Performance Monitoring SDK.

Warum sehe ich keine Fragmente?

Damit du neben der App-Aktivität auch die Leistung von Fragmenten sehen kannst, muss deine App Performance Monitoring Android SDK 20.1.0 oder höher verwenden. Weitere Informationen finden Sie unter Anwendungsleistungsmonitoring hinzufügen.

Wie kann ich herausfinden, welche Traces mit Fragmenten und Aktivitäten zusammenhängen?

Jeder Fragment- und Aktivitäts-Trace basiert auf seinem Klassennamen, der in Ihrer Anwendung definiert ist. Jede der Bildschirmaufzeichnungen enthält das Präfix st gefolgt vom Namen der Klasse. In der Firebase Console wird das Präfix entfernt. Weitere Informationen zu Leistungsdaten für das Bildschirm-Rendering (Apple- und Android-Apps)

Warum sehe ich weniger Fragmente als bei anderen Traces?

Bei Performance Monitoring wird eine Stichprobenerhebung für alle auf einem Gerät erfassten Ereignisse durchgeführt. So können wir die Mindestanzahl an Ereignissen von Nutzergeräten erfassen, die für die Bereitstellung von Leistungsmesswerten erforderlich sind.

Wie werde ich über ein Problem mit der Rendering-Leistung meiner Anwendung benachrichtigt?

Mit Performance Monitoring können Sie Benachrichtigungen zu wichtigen Messwerten einrichten. Für generierte Bildschirm-Rendering-Traces können Sie Benachrichtigungen einrichten, damit Sie informiert werden, wenn der Prozentsatz der langsamen und eingefrorenen Frames einen von Ihnen festgelegten Grenzwert überschreitet.

Nach der Aktivierung des Gradle-Plug-ins Performance Monitoring sind meine Build-Zeiten lang. Wie kann ich das verbessern?

Performance Monitoring für Android verwendet Bytecode-Instrumentierung, um einige sofort einsatzbereite Funktionen wie die Überwachung von HTTP/S-Netzwerkanfragen bereitzustellen. Im Rahmen der Kompilierung muss der Prozess durch alle Klassen Ihrer Anwendung (einschließlich Abhängigkeiten) iteriert werden, um den Code zu instrumentieren, der für die Messung der Netzwerkanfrageleistung Ihrer Anwendung entscheidend ist.

Hier sind einige der wichtigsten Gründe für eine längere Erstellungszeit:

• Anzahl der Kurse oder Dateien
• Größe der einzelnen Klassen (Codezeilen)
• Ihre Maschinenkonfiguration
• Erster Build im Vergleich zu einem nachfolgenden Build (nachfolgende Builds sind in der Regel schneller als der erste Build)

Zur Optimierung der Build-Zeit können Sie Ihren Code modularisieren.

Ab Version 1.3.3 des Plug-ins Performance Monitoring haben wir uns auf erhebliche Verbesserungen bei der inkrementellen Build-Verarbeitung und dem Caching von Bibliothekseingaben konzentriert. Damit Sie die neuesten Verbesserungen bei der Build-Zeit erhalten, müssen Sie die neueste Version des Plug-ins (Version 1.4.2) verwenden.

Wenn Sie lange Build-Zeiten vermeiden möchten, können Sie das Performance Monitoring-Plug-in für Ihre Debug-Builds lokal deaktivieren. Dieser Ansatz wird jedoch für Produktionsbuilds nicht empfohlen, da dies zu fehlenden Leistungsmessungen für die Netzwerkanfragen in Ihrer App führen kann.

Was kann ich tun, wenn ich Buildfehler aufgrund von nicht kompatiblen Bibliotheken mit dem Performance Monitoring Gradle-Plug-in erhalte?

Performance Monitoring für Android verwendet Bytecode-Instrumentierung, um einige sofort einsatzbereite Funktionen wie das Überwachen von HTTP/S-Netzwerkanfragen bereitzustellen. Im Rahmen der Kompilierung müssen alle Klassen Ihrer App (einschließlich Abhängigkeiten) durchlaufen werden, um den Code zu instrumentieren, der für die Messung der Netzwerkanfrageleistung Ihrer Anwendung entscheidend ist.

Wenn nach der Einbindung des Performance Monitoring-Plug-ins Buildfehler wie JSR/RET are not supported with computeFrames option oder ähnliche Fehler auftreten, kann das daran liegen, dass Sie auch eine Abhängigkeit von einer Bibliothek haben, die nicht mit dem Performance Monitoring-Gradle-Plug-in kompatibel ist.

Sie können dieses Problem umgehen, indem Sie inkompatible Klassen/Bibliotheken von der Instrumentierung ausschließen. Gehen Sie dazu so vor:

1. Aktualisieren Sie das Performance Monitoring-Gradle-Plug-in auf die neueste Version (mindestens v1.4.0).
2. Aktualisieren Sie die Version Ihres Android-Gradle-Plug-ins auf Version 7.2.0 oder höher.
3. Fügen Sie der Datei build.gradle (auf App-Ebene) das folgende Flag hinzu, um die inkompatiblen Klassen/Bibliotheken von der Instrumentierung auszuschließen:

   android {
     // ...
     androidComponents {
       onVariants(selector().all(), {
           instrumentation.excludes.add("example.incompatible.library")
       })
     }
   }

   Weitere Informationen zum Attribut exclude der Instrumentation API des Android-Gradle-Plug-ins finden Sie unter Instrumentierung.

Melden Sie ein GitHub-Problem, wenn Build-Fehler aufgrund inkompatibler Bibliotheken auftreten, damit diese auch von der Instrumentierung im Performance Monitoring-Plug-in ausgeschlossen werden können.

Der Export meiner Performance Monitoring-Daten nach BigQuery dauert länger als erwartet. Geschieht das nicht in Echtzeit?

Wenn Sie die BigQuery-Integration für Firebase Performance Monitoring aktiviert haben, werden Ihre Daten 12 bis 24 Stunden nach Ende des Tages (Pacific Time) nach BigQuery exportiert.

Beispiel: Die Daten für den 19. April stehen in BigQuery am 20. April zwischen 12:00 Uhr und Mitternacht zur Verfügung. Alle Datums- und Uhrzeitangaben beziehen sich auf die Zeitzone Pacific Time.

Datennahe Verarbeitung und Anzeige in Echtzeit

Was bedeutet „nahezu Echtzeit“-Leistungsdaten?

Firebase Performance Monitoring verarbeitet die erfassten Leistungsdaten, sobald sie eintreffen. Die Daten werden dadurch nahezu in Echtzeit in der Firebase-Konsole angezeigt. Die verarbeiteten Daten werden innerhalb weniger Minuten nach der Erfassung in der Console angezeigt. Daher der Begriff „nahezu in Echtzeit“.

Damit Sie Datenverarbeitung nahezu in Echtzeit nutzen können, muss in Ihrer App eine Echtzeit-kompatible SDK-Version verwendet werden.

Wie erhalte ich nahezu in Echtzeit Leistungsdaten für meine App?

Wenn Sie die Echtzeitverarbeitung nutzen möchten, müssen Sie nur darauf achten, dass Ihre App eine Performance Monitoring SDK-Version verwendet, die mit der Echtzeitverarbeitung kompatibel ist.

Das sind die echtzeitkompatiblen SDK-Versionen:

• iOS – Version 7.3.0 oder höher
• tvOS – Version 8.9.0 oder höher
• Android – Version 19.0.10 oder höher (oder Firebase Android BoM Version 26.1.0 oder höher)
• Web – Version 7.14.0 oder höher

Wir empfehlen immer die neueste SDK-Version zu verwenden. Mit jeder der oben aufgeführten Versionen kann Performance Monitoring Ihre Daten jedoch nahezu in Echtzeit verarbeiten.

Welche Versionen des Performance Monitoring SDK gelten als echtzeitkompatibel?

Dies sind die SDK-Versionen, die mit der Datenverarbeitung in Echtzeit kompatibel sind:

• iOS: Version 7.3.0 oder höher
• tvOS – Version 8.9.0 oder höher
• Android – Version 19.0.10 oder höher (oder Firebase Android BoM Version 26.1.0 oder höher)
• Web – Version 7.14.0 oder höher

Wir empfehlen immer, die neueste SDK-Version zu verwenden. Mit jeder oben aufgeführten Version kann Performance Monitoring Ihre Daten jedoch nahezu in Echtzeit verarbeiten.

Was passiert, wenn ich meine App nicht auf eine mit der Echtzeitfunktion kompatible SDK-Version aktualisiere?

Wenn deine App keine echtzeitkompatible SDK-Version verwendet, siehst du trotzdem alle Leistungsdaten deiner App in der Firebase-Konsole. Die Anzeige der Leistungsdaten ist ab dem Zeitpunkt der Erfassung jedoch um etwa 36 Stunden verzögert.

Ich habe auf eine echtzeitkompatible SDK-Version umgestellt, einige meiner Nutzer verwenden aber noch alte Versionen meiner App. Werden ihre Leistungsdaten weiterhin in der Firebase-Konsole angezeigt?

Sehr gut. Unabhängig von der SDK-Version, die eine App-Instanz verwendet, werden die Leistungsdaten aller Nutzer angezeigt.

Wenn Sie sich jedoch aktuelle Daten ansehen (jünger als etwa 36 Stunden), stammen die angezeigten Daten von Nutzern von App-Instanzen, die eine Echtzeit-kompatible SDK-Version verwenden. Die nicht aktuellen Daten enthalten jedoch Leistungsdaten aus allen Versionen Ihrer App.

Firebase-Support kontaktieren

Wenn Sie sich an den Firebase-Support wenden, geben Sie immer Ihre Firebase-App-ID an. Sie finden Ihre Firebase App-ID auf der Karte Meine Apps in den Projekteinstellungen.