Performance Monitoring – Fehlerbehebung und FAQs

So rufen Sie Logeinträge für Leistungsereignisse auf

1. Aktivieren Sie die Debuggingprotokollierung wie folgt:

   1. Wählen Sie in Xcode (mindestens Version 15.2) Product > Schema > Schema bearbeiten:
   2. Wählen Sie im Menü auf der linken Seite Ausführen und dann den Tab Argumente aus.
   3. Fügen Sie im Abschnitt Beim Start übergebene Argumente -FIRDebugEnabled hinzu.

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

3. Performance Monitoring kennzeichnet seine Logeinträge mit Firebase/Performance, sodass Sie können Sie Ihre Logeinträge filtern.

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

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 sie Ereignisinformationen (z. B. App-Interaktionen) von Ihrer App erhält. Normalerweise wird innerhalb von 10 Minuten nach dem Start der App die Leistung Dashboard der Firebase-Konsole zeigt „SDK erkannt“ an . Innerhalb von 30 Minuten werden dann die ersten verarbeiteten Daten im Dashboard angezeigt.

Wenn seit dem Hinzufügen der neuesten SDK-Version zu mehr als 10 Minuten und Sie immer noch keine Änderung sehen, prüfen Sie Ihr Protokoll Nachrichten, um sicherzustellen, dass Performance Monitoring das Protokoll Ereignisse. Führen Sie die unten beschriebenen Schritte zur Fehlerbehebung aus, Probleme mit einer verspäteten SDK-Erkennungsmeldung beheben

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

Performance Monitoring verarbeitet Daten zu Leistungsereignissen, bevor sie im Dashboard zur Leistungsüberwachung

Wenn mehr als 24 Stunden vergangen sind, seit das SDK erkannt wird, Nachricht angezeigt, und immer noch keine Daten angezeigt werden, überprüfen Sie Firebase-Status-Dashboard für den Fall, bekannten Ausfall. Gibt es keinen Ausfall, wenden Sie sich an den Firebase-Support.

Anwendung protokolliert nicht Leistungsereignisse

Wenn Sie keine Protokollmeldungen zur Leistungssteigerung sehen führen Sie die folgenden Schritte zur Fehlerbehebung aus:

1. Achten Sie darauf, dass das Performance Monitoring SDK nicht deaktiviert über eine der folgenden Flags in Ihrer Info.plist-Datei:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Achten Sie darauf, dass Performance Monitoring zur Laufzeit nicht deaktiviert ist (Swift | Obj-C).

3. Wenn Sie in Ihrer App keine deaktivierten Funktionen 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, versuchen Sie Folgendes: Schritte zur Fehlerbehebung:

1. Stellen Sie sicher, dass Sie die neueste Version des Apple Platform SDK verwenden. (Version 11.2.0) Bildschirm-Rendering-Traces sind nur verfügbar Version 5.0.0 oder höher installiert ist.

2. Performance Monitoring erstellt keine Bildschirmrendering-Spuren für Containeransichtscontroller wie UINavigationController und UITabBarController. Wenn Daten nur für diese Bildschirme fehlen, ist das ein normales Verhalten.

Das Dashboard zur Leistungsüberwachung ist benutzerdefinierte Trace-Daten fehlen

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. Überprüfen Sie die Einrichtung von benutzerdefinierten Code-Traces, die über die Trace API insbesondere die folgenden:

   • 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. Alle Protokolle, die nicht gestartet, nicht angehalten oder vor dem Start angehalten wurden, werden nicht protokolliert.

2. Prüfen Sie in Ihren Logeinträgen, Performance Monitoring protokolliert erwartete benutzerdefinierte Code-Traces.

3. Wenn Performance Monitoring Ereignisse protokolliert, aber nach 24 Stunden keine Daten angezeigt werden, gilt Folgendes: wenden Sie sich an den Firebase-Support.

Dashboard zur Leistungsüberwachung Daten zu Netzwerkanfragen fehlen

Wenn Daten zu Netzwerkanfragen fehlen, versuchen Sie Folgendes:

1. Prüfen Sie, ob die Netzwerkbibliothek nicht kompatibel ist. Performance Monitoring erfasst automatisch Messwerte für Netzwerkanfragen, für die die folgenden Netzwerkbibliotheken verwendet werden:

   • Für Swift: URLSession und URLConnection
   • Für Objective-C: NSURLSession und NSURLConnection

   Beachten Sie, dass Sie benutzerdefiniertes Monitoring für das Netzwerk -Anfragen.

2. Beachten Sie Folgendes:

   • Je nach Verhalten des Codes und der Netzwerkbibliotheken, die von Ihrem Code hinzugefügt, meldet Performance Monitoring möglicherweise nur Netzwerkanfragen, abgeschlossen. Das bedeutet, dass HTTP/S-Verbindungen, die offen bleiben, möglicherweise nicht gemeldet werden.

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

Netzwerkanfragedaten werden nicht wie erwartet aggregiert

Weitere Informationen dazu, wie Performance Monitoring Netzwerkanfragen zusammenfasst unter URL-Mustern.

Sie können auch eine benutzerdefinierte URL Muster.

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

Wir haben die Kategorie Häufige Probleme durch aktuelle Warnungen ersetzt. Einführung von Alerts, mit der Sie automatisch informiert werden, von Ihnen festgelegte Grenzwerte überschritten werden. Probleme wurden verworfen und durch Benachrichtigungen ersetzt.

Mit der App-Auswahl oben auf der Karte „Leistung“ wird die Benachrichtigung gefiltert unter Aktuelle Meldungen ein. Nur die drei letzten Benachrichtigungen für die Die ausgewählten Apps werden angezeigt.

Weitere Informationen zu Benachrichtigungen finden Sie unter Benachrichtigungen bei Leistungsproblemen einrichten

Was ist mit der Möglichkeit zum Festlegen von Schwellenwerten für Probleme in der Konsole passiert?

Performance Monitoring unterstützt Benachrichtigungen für Messwerte, die über Grenzwerten definiert. Um Verwechslungen mit diesen konfigurierbaren Grenzwerten für können Sie keine Grenzwerte für Probleme zu lösen.

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

Die Seiten „Details“ und „Messwerte“ wurden durch eine neu gestaltete, zentralisierte Benutzeroberfläche (UI) verwenden, um die Fehlerbehebung zu verbessern. Diese neue Die Benutzeroberfläche zur Fehlerbehebung bietet dieselben Hauptfunktionen wie die Details und Messwerte werden angeboten. 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 deiner App. Wenn Ihre Anwendung viele Nutzer hat oder die App eine große Menge an Leistungsaktivitäten generiert, kann Performance Monitoring die Datenerhebung auf eine Teilmenge der Geräte beschränken, um die Anzahl der verarbeiteten Ereignisse zu reduzieren. Diese Limits sind hoch genug, Auch mit weniger Ereignissen sind die Messwerte repräsentativ für die User Experience der App.

Zur Verwaltung der von uns erhobenen Datenmenge verwendet Performance Monitoring Folgendes: 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 Schleifeninstrumentierungen, die große Mengen an Leistungsdaten senden können, und verhindert, dass ein einzelnes Gerät die Leistungsmessungen verfälscht.

• Dynamische Stichproben: Mit Performance Monitoring wird ein Limit von etwa 100 Millionen erfasst. Ereignisse für Code-Traces und 100 Millionen für Netzwerkanfrage-Traces pro App pro Tag für alle App-Nutzer. Auf den Geräten wird eine dynamische Stichprobenrate abgerufen (mit Firebase Remote Config), um zu ermitteln, ob ein zufälliges Gerät Traces erfassen und senden soll. Ein Gerät, das nicht für die Stichprobenerhebung ausgewählt ist, Ereignisse zu senden. Die dynamische Stichprobenrate ist app-spezifisch und damit das Gesamtvolumen der erfassten Daten unter dem Grenzwert bleibt.

  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 der Sitzungen kann auch Performance Monitoring die Anzahl der Sitzungen einschränken.

• Serverseitige Ratenbegrenzung: Damit wird sichergestellt, dass Apps die Stichprobengröße nicht überschreiten. Limit setzen, verwendet Performance Monitoring möglicherweise serverseitige Stichproben, um einige Ereignisse zu 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 sich von der Häufigkeit unterscheiden, mit der ein Stück Code ausgeführt wurde.
  • Im Code eng gekoppelte Traces können jeweils eine unterschiedliche Anzahl von Proben.

Was ist mit dem Tab Probleme in der Console passiert?

Den Tab „Probleme“ haben wir durch die Einführung von Benachrichtigungen ersetzt. benachrichtigt Sie automatisch, wenn die von Ihnen festgelegten Grenzwerte überschritten werden. Du nein nicht mehr manuell in der Firebase-Konsole nachprüfen müssen, um den Status einen Grenzwert haben. 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 Abschnitt „Performance Monitoring“ der Firebase-Konsole neu gestaltet, Auf dem Tab Dashboard werden Ihre wichtigsten Messwerte und alle Traces an einem Ort angezeigt. Als Im Rahmen der Neugestaltung haben wir auch die Seiten Auf dem Gerät und Netzwerk entfernt.

Die Tabelle mit den Aufzeichnungen unten auf dem Tab Dashboard enthält dieselben Informationen wie die Tabs Auf dem Gerät und Netzwerk, aber mit einigen zusätzlichen Funktionen, z. B. die Möglichkeit, die Aufzeichnungen nach der prozentualen Änderung für einen bestimmten Messwert zu sortieren. Wenn Sie alle Messwerte und Daten für einen bestimmten Trace aufrufen möchten, klicken Sie in der Trace-Tabelle auf den Namen des Traces.

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

• Netzwerkanfrage-Traces (sowohl vorkonfiguriert als auch benutzerdefiniert) – Untertab Netzwerkanfragen
• Benutzerdefinierte Code-Traces: Untertab Benutzerdefinierte Traces
• Traces für App-Start, im Vordergrund und im Hintergrund – Unter-Tab Benutzerdefinierte Traces
• Bildschirm-Rendering-Traces – Untertab Bildschirm-Rendering
• Seitenaufbau-Traces – Untertab Seitenaufbau

Weitere Informationen zur Tabelle mit den Traces sowie zu den Messwerten und Daten finden Sie auf der Übersichtsseite der Console (iOS und höher | Android | Web).

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

Frames mit langsamem Rendering und eingefrorene Frames werden mit einer angenommenen Geräteaktualisierungsrate von 60 Hz berechnet. Wenn die Aktualisierungsrate des Geräts unter 60 Hz liegt, wird jeder Frame langsamere Renderingzeit, da weniger Frames pro Sekunde gerendert werden. Langsamere Rendering-Zeiten 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. Das ist eine aktuelle Einschränkung des Performance Monitoring SDK.

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 werden 12 bis 24 Stunden nach Ende des Tages (Pacific Time) Uhrzeit).

So sind beispielsweise die Daten für den 19. April ab dem 20. April in BigQuery verfügbar. zwischen 12:00 Uhr und Mitternacht. Alle Datums- und Uhrzeitangaben beziehen sich auf die Zeitzone Pacific Time.

Was bedeutet „nahezu in Echtzeit“? die Leistung Ihrer Performance-Daten?

Firebase Performance Monitoring verarbeitet die erhobenen Leistungsdaten, sobald sie eingehen. werden die Daten 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 die Datenverarbeitung in nahezu Echtzeit nutzen können, muss in Ihrer App eine mit Echtzeit kompatible SDK-Version verwendet werden.

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

Um die Datenverarbeitung nahezu in Echtzeit zu nutzen, müssen Sie nur sicherstellen, dass deine App eine Performance Monitoring SDK-Version verwendet, die mit Echtzeit kompatibel ist Datenverarbeitung.

Dies sind die in Echtzeit kompatiblen 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. Die oben aufgeführte Version ermöglicht es Performance Monitoring, Ihre Daten nahezu in realer Umgebung zu 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. Die oben aufgeführte Version ermöglicht es Performance Monitoring, Ihre Daten nahezu in realer Umgebung zu verarbeiten. .

Was passiert, wenn ich meine App nicht aktualisiere, um eine Echtzeit-kompatible SDK-Version zu verwenden?

Wenn Ihre App keine Echtzeit-kompatible SDK-Version verwendet, sehen Sie in der Firebase-Konsole weiterhin alle Leistungsdaten Ihrer App. Das Display der Leistungsdaten werden ab dem Zeitpunkt der .

Ich habe auf eine SDK-Version aktualisiert, die in Echtzeit kompatibel ist, aber einige meiner Nutzer Ich nutze immer noch die alten Versionen meiner App. Kann ich ihre Leistung weiterhin sehen? Daten in der Firebase-Konsole?

Ja! Unabhängig von der SDK-Version, die eine App-Instanz verwendet, Leistungsdaten aller Ihrer Nutzer.

Wenn Sie sich jedoch aktuelle Daten ansehen, die weniger als 36 Stunden alt sind, stammen die angezeigten Daten von Nutzern von App-Instanzen mithilfe eines Echtzeit- kompatible SDK-Version. Die nicht aktuellen Daten enthalten jedoch Leistungsdaten aus allen Versionen Ihrer App.