Auf dieser Seite finden Sie Tipps zur Fehlerbehebung bei den ersten Schritten mit Performance Monitoring oder bei der Verwendung von Performance Monitoring-Funktionen und Performance Monitoring-Tools.
Erste Überprüfungen zur Fehlerbehebung
Die folgenden beiden Prüfungen sind allgemeine Best Practices, die jedem empfohlen werden:
bevor Sie mit der Fehlerbehebung fortfahren.
1. Logeinträge auf Leistungsereignisse prüfen
Sehen Sie in den Logeinträgen nach, ob das Performance Monitoring SDK Daten erfasst
Performance-Ereignisse.
So rufen Sie Logeinträge für Leistungsereignisse auf
Aktivieren Sie die Debuggingprotokollierung wie folgt:
Wählen Sie in Xcode (mindestens Version 15.2) Product >
Schema > Schema bearbeiten:
Wählen Sie im Menü auf der linken Seite Ausführen und dann den Tab Argumente aus.
Fügen Sie im Abschnitt Beim Start übergebene Argumente-FIRDebugEnabled hinzu.
Prüfen Sie Ihre Logeinträge auf Fehlermeldungen.
Performance Monitoring kennzeichnet seine Logeinträge mit Firebase/Performance, sodass Sie
können Sie Ihre Logeinträge filtern.
Suchen Sie nach den folgenden Logtypen, die darauf hinweisen, dass Performance Monitoring
Logging von Leistungsereignissen:
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
2. Firebase-Status-Dashboard prüfen
Überprüfen Sie die
Firebase-Status-Dashboard für den Fall
Es gibt einen bekannten Ausfall bei Firebase oder Performance Monitoring.
Einführung in Performance Monitoring
Wenn Sie zum ersten Mal mit Performance Monitoring starten
(iOS+ |
Android |
Web), die folgende Fehlerbehebung
Tipps können Ihnen bei Problemen helfen, bei denen Firebase das SDK erkennt oder
Ihre ersten Leistungsdaten in der Firebase-Konsole anzeigen.
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
Wenn Sie noch lokal entwickeln, können Sie mehr Ereignisse für die Datenerhebung generieren:
Entwickeln Sie Ihre App weiter mit einem Simulator oder Testgerät.
Erzeugen Sie Ereignisse, indem Sie Ihre App mehrmals zwischen Hintergrund und Vordergrund wechseln, mit Ihrer App interagieren, indem Sie zwischen Bildschirmen wechseln, und/oder Netzwerkanfragen auslösen.
Achten Sie darauf, dass Ihre Firebase-Konfiguration
Datei (Google-Service-Info.plist) ist
korrekt zu Ihrer App hinzugefügt und dass 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 Stammverzeichnis Ihres XCode-Projekts und wurde den richtigen Zielen hinzugefügt.
Die in der Konfigurationsdatei aufgeführte Firebase Apple-App-ID (GOOGLE_APP_ID) ist
für Ihre App am besten geeignet ist. Ihre Firebase-App-ID finden Sie auf der Karte Meine Apps.
Ihres settingsProjekts
Einstellungen
Wenn etwas mit der Konfigurationsdatei in Ihrer App nicht stimmt, versuchen Sie Folgendes:
Löschen Sie die Konfigurationsdatei, die sich derzeit in Ihrer App befindet.
Folgen Sie dieser Anleitung, um die App herunterzuladen.
eine neue Konfigurationsdatei
und fügen sie Ihrer Apple-App hinzu.
Wenn das SDK Ereignisse protokolliert und alles korrekt eingerichtet zu sein scheint,
aber die SDK-Erkennungsmeldung oder die verarbeiteten Daten werden immer noch nicht angezeigt.
(nach zwei Stunden) wenden Sie sich an den Firebase-Support.
Die Anwendung protokolliert keine Ereignisse:
Schritte zur Fehlerbehebung
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.
Allgemeine Fehlerbehebung
Wenn du das SDK erfolgreich hinzugefügt hast und Performance Monitoring in deiner App verwendest, wird der
können folgende Tipps zur Fehlerbehebung bei allgemeinen Problemen
Performance Monitoring-Funktionen und -Tools.
Im Dashboard zur Leistungsüberwachung fehlen Bildschirm-Trace-Daten
Wenn Daten für Bildschirm-Rendering-Traces fehlen, versuchen Sie Folgendes:
Schritte zur Fehlerbehebung:
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.
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:
Ü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.
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:
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
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.
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
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.
Datenverarbeitung und ‑darstellung nahezu in Echtzeit
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.
