Performance Monitoring – Fehlerbehebung und FAQs

Protokollmeldungen für Leistungsereignisse aufrufen

1. Öffnen Sie die Entwicklertools Ihres Browsers (z. B. den Tab „Netzwerk“ in den Chrome-Entwicklertools oder den Netzwerkmonitor in Firefox).

2. Aktualisieren Sie die Webanwendung im Browser.

3. Prüfen Sie die Protokollmeldungen auf Fehler.

4. Suchen Sie nach einigen Sekunden in den Entwicklertools Ihres Browsers nach einem Netzwerkaufruf an firebaselogging.googleapis.com. Wenn dieser Netzwerkaufruf vorhanden ist, sendet der Browser Leistungsdaten an Firebase.

Wenn in Ihrer App keine Leistungsereignisse protokolliert werden, lesen Sie die Tipps zur Fehlerbehebung.

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 werden dann die ersten verarbeiteten Daten im Dashboard angezeigt.

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.

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

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

Wenn mehr als 24 Stunden vergangen sind, seit die Meldung „SDK erkannt“ angezeigt wurde, und Sie immer noch keine Daten sehen, sehen Sie im Firebase-Status-Dashboard nach, ob es einen bekannten Ausfall gibt. Wenn kein Ausfall vorliegt, wenden Sie sich an den Firebase-Support.

In der App werden keine Leistungsereignisse protokolliert

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

1. Das Performance Monitoring SDK muss in Ihrer App richtig initialisiert sein.

2. Das Performance Monitoring SDK darf nicht über das folgende Flag deaktiviert sein:

   • performance.instrumentationEnabled

3. Das Browser-Caching muss deaktiviert sein. Andernfalls werden im Browser möglicherweise keine neuen Instrumentierungseinstellungen übernommen.

4. Schließen Sie den Tab der Webseite und öffnen Sie ihn dann wieder. Prüfen Sie noch einmal, ob die Protokollierung funktioniert.

   Wenn Sie das Performance Monitoring SDK gerade erst Ihrer App hinzugefügt haben, müssen Sie sie möglicherweise vollständig neu starten, damit das SDK funktioniert.

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

Im Leistungsdashboard fehlen Daten zur ersten Eingabeverzögerung

Wenn Sie keine Daten für den Messwert Eingabeverzögerung sehen, versuchen Sie es mit den folgenden Schritten zur Fehlerbehebung:

1. Der Messwert First Input Delay wird von Performance Monitoring nur erfasst, wenn ein Nutzer innerhalb der ersten 5 Sekunden nach dem Seitenaufbau auf die Webseite klickt.

2. Achten Sie darauf, dass Sie Ihre App so eingerichtet haben, dass dieser Messwert erfasst wird. Der Messwert First Input Delay muss manuell eingerichtet werden. Dazu müssen Sie die polyfill-Bibliothek für diesen Messwert hinzufügen. Eine Anleitung zur Installation finden Sie in der Dokumentation der Bibliothek.

   Das Hinzufügen dieser Polyfill-Bibliothek ist nicht erforderlich, damit Performance Monitoring andere Messwerte für Webanwendungen erfasst.

Im Leistungsdashboard fehlen benutzerdefinierte Trace-Daten

Werden für Sie Leistungsdaten für automatisch erfasste Traces angezeigt, aber nicht für Traces mit benutzerdefiniertem Code? Führen Sie die folgenden Schritte zur Fehlerbehebung aus:

1. Prüfen Sie die Einrichtung benutzerdefinierter Code-Traces, die über die Trace API instrumentiert wurden. Prüfen Sie insbesondere 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. Alle Protokolle, die nicht gestartet, nicht angehalten oder vor dem Start angehalten wurden, werden nicht protokolliert.

   Wenn Sie die Methode record() verwenden, müssen Sie die Aufzeichnung nicht explizit starten oder beenden.

2. Die Datenerhebung für Performance Monitoring darf nicht über das folgende Flag deaktiviert sein:

   • performance.dataCollectionEnabled

     Mit diesem Flag wird die Erfassung von Daten nur für benutzerdefinierte Code-Traces gesteuert (nicht für alle Daten).

3. Prüfen Sie die Logmeldungen, um sicherzustellen, dass Performance Monitoring die erwarteten benutzerdefinierten 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 keine Netzwerkanfragedaten vorhanden sind, beachten Sie Folgendes:

• Performance Monitoring erfasst automatisch Messwerte für Netzwerkanfragen, die von der Browser-API gemeldet werden. Diese Berichte enthalten keine fehlgeschlagenen Netzwerkanfragen.

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

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.

Was ist mit den wichtigsten 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 werden eingestellt und durch Benachrichtigungen ersetzt.

Mit der App-Auswahl oben auf der Karte „Leistung“ können Sie die Benachrichtigungseinträge unter Letzte Benachrichtigungen filtern. 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, zentrale Benutzeroberfläche ersetzt, damit Sie Probleme noch besser beheben können. 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 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 so hoch, dass die Messwerte auch bei weniger Ereignissen repräsentativ für die App-Nutzung Ihrer Nutzer sind.

Um das Volumen der erhobenen Daten zu verwalten, verwendet Performance Monitoring die folgenden Stichprobenerhebungsoptionen:

• 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 Stichprobenerhebung: Performance Monitoring erfasst täglich eine begrenzte Anzahl von Code- und Netzwerkanfrage-Traces pro App 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. Von Geräten, die nicht für die Stichprobenerhebung ausgewählt wurden, werden keine Ereignisse gesendet. Die dynamische Stichprobenrate ist app-spezifisch und wird so angepasst, dass das Gesamtvolumen der erfassten Daten unter dem Limit 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 von Nutzersitzungen zu minimieren, kann Performance Monitoring auch die Anzahl der Sitzungen begrenzen.

• Serverseitige Ratenbegrenzung: Damit Apps das Stichprobenlimit nicht überschreiten, kann Performance Monitoring serverseitige Stichprobenerhebung verwenden, um einige von Geräten empfangene Ereignisse zu verwerfen. 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.
  • Traces, die im Code eng miteinander verbunden sind, können jeweils eine unterschiedliche Anzahl von Samples haben.

Was ist mit dem Tab Probleme in der Console passiert?

Der Tab „Probleme“ wurde durch den Tab „Benachrichtigungen“ ersetzt. Sie werden dort automatisch benachrichtigt, wenn die von Ihnen festgelegten Grenzwerte überschritten werden. Sie müssen den Status eines Schwellenwerts nicht mehr manuell in der Firebase-Konsole prüfen. 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 Console 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, sodass 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 Tabelle mit den Aufzeichnungen unten auf dem Tab Dashboard enthält dieselben Informationen wie die Tabs Auf dem Gerät und Netzwerk, bietet aber einige zusätzliche 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.

Sie können sich Ihre Traces in den folgenden Untertabs der Traces-Tabelle ansehen:

• 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 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 Bildwiederholrate eines Geräts unter 60 Hz liegt, dauert das Rendern jedes Frames länger, da weniger Frames pro Sekunde gerendert werden. Längere 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. Das ist eine aktuelle Einschränkung des Performance Monitoring SDK.

Wie füge ich meiner Web-App das kleinere, benannte Performance Monitoring JS SDK (das „eigenständige“ SDK) hinzu?

Wenn Performance Monitoring das einzige Firebase-Produkt in Ihrer App ist, können Sie das eigenständige Performance Monitoring SDK (und das empfohlene Header-Script unten) verwenden, wenn Sie Folgendes möchten:

• mit einer benannten Bibliothek
• Größe des SDK-Pakets reduzieren
• die Initialisierung des SDKs bis nach dem Laden der Seite verzögern

So fügen Sie das eigenständige Performance Monitoring SDK in Ihre App ein und verzögern die Initialisierung bis nach dem Laden der Seite:

1. Fügen Sie der Kopfzeile Ihrer Indexdatei das folgende Script hinzu.
2. Fügen Sie das Firebase-Projektkonfigurationsobjekt Ihrer App hinzu.

(function(sa,fbc){function load(f,c){var a=document.createElement('script');
a.async=1;a.src=f;var s=document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(a,s);}load(sa);
window.addEventListener('load',function(){firebase.initializeApp(fbc).performance()});
})(performance_standalone, firebaseConfig);

Dabei gilt:

• performance_standalone ist 'https://www.gstatic.com/firebasejs/11.0.2/firebase-performance.js'.
• firebaseConfig ist das Firebase-Konfigurationsobjekt Ihrer App.

Im obigen Script wird das eigenständige SDK asynchron geladen und Firebase nach dem Auslösen des onload-Ereignisses des Fensters initialisiert. Dadurch wird die Auswirkung des SDKs auf die Messwerte für das Laden der Seite reduziert, da der Browser seine Lademesswerte bereits gemeldet hat, als Sie das SDK initialisiert haben.

(function(sdkSource, firebaseConfigObject) {
   function load(f, c) {
       // Creates a script tag to load the standalone SDK
       var sdkScript = document.createElement('script');

       // Sets it to an async script so that it doesn't interfere with page load
       sdkScript.async = 1;

       // Sets the source of the script
       sdkScript.src = f;

       // Inserts the script into the head of the page
       var s = document.getElementsByTagName('script')[0];
       s.parentNode.insertBefore(sdkScript, s);
   }

   // Calls the load method
   load(sdkSource);

   // Initializes the SDK only when the onload method is called
   window.addEventListener('load', function() {
       firebase.initializeApp(firebaseConfigObject).performance();
   });
})(performance_standalone, firebaseConfig);

Was bedeutet „nahezu in Echtzeit“ bei Leistungsdaten?

Firebase Performance Monitoring verarbeitet die erfassten Leistungsdaten in Echtzeit, sodass sie in der Firebase-Konsole nahezu in Echtzeit angezeigt werden. 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 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?

Folgende SDK-Versionen sind mit der Echtzeitdatenverarbeitung kompatibel:

• 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.

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

Wenn Ihre App keine Echtzeit-kompatible SDK-Version verwendet, sehen Sie in der Firebase-Konsole weiterhin alle Leistungsdaten Ihrer App. Die Leistungsdaten werden jedoch erst etwa 36 Stunden nach der Erhebung angezeigt.

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 davon, welche SDK-Version eine App-Instanz verwendet, sehen Sie Leistungsdaten aller Ihrer Nutzer.

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.