Performance Monitoring – Fehlerbehebung und FAQs

Log-Nachrichten für Leistungsereignisse ansehen

1. Öffnen Sie die Entwicklertools Ihres Browsers, z. B. den Tab „Netzwerk“ in den Chrome-Entwicklertools oder den Netzwerkmonitor für Firefox.

2. Aktualisieren Sie die Web-App im Browser.

3. Prüfen Sie Ihre Logmeldungen auf Fehlermeldungen.

4. Suchen Sie nach einigen Sekunden in den Entwicklertools Ihres Browsers nach einem Netzwerkaufruf an firebaselogging.googleapis.com. Das Vorhandensein dieses Netzwerkaufrufs zeigt, dass der Browser Leistungsdaten an Firebase sendet.

Wenn in Ihrer App keine Leistungsereignisse protokolliert werden, finden Sie hier Tipps zur Fehlerbehebung.

SDK wurde der App hinzugefügt, aber in der Console wird weiterhin angezeigt, dass das SDK hinzugefügt werden muss

Firebase kann erkennen, ob Sie das Performance Monitoring SDK erfolgreich in Ihre App eingebunden haben, wenn Ereignisinformationen (z. B. App-Interaktionen) von Ihrer App empfangen werden. Normalerweise wird innerhalb von 10 Minuten nach dem Start Ihrer App im Performance-Dashboard der Firebase-Konsole die Meldung „SDK erkannt“ angezeigt. Innerhalb von 30 Minuten werden dann die ersten verarbeiteten Daten im Dashboard angezeigt.

Wenn seit dem Hinzufügen der neuesten SDK-Version zu Ihrer App mehr als 10 Minuten vergangen sind und Sie immer noch keine Änderung sehen, prüfen Sie Ihre Logmeldungen, um sicherzustellen, dass Performance Monitoring Ereignisse protokolliert. Führen Sie die entsprechenden Schritte zur Fehlerbehebung aus, um eine verzögerte Meldung zur SDK-Erkennung zu beheben.

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 seit dem Erscheinen der Meldung „SDK detected“ mehr als 24 Stunden vergangen sind und Sie immer noch keine Daten sehen, prüfen Sie das Firebase-Status-Dashboard auf bekannte Ausfälle. Wenn kein Ausfall vorliegt, wenden Sie sich an den Firebase-Support.

Die App protokolliert keine Leistungsereignisse.

Wenn Sie keine Log-Nachrichten für Leistungsereignisse sehen, führen Sie die folgenden Schritte zur Fehlerbehebung aus:

1. Prüfen Sie, ob das Performance Monitoring SDK in Ihrer App richtig initialisiert wurde.

2. Prüfen Sie, ob das Performance Monitoring SDK nicht über das folgende Flag deaktiviert ist:

   • performance.instrumentationEnabled

3. Achten Sie darauf, dass das Browser-Caching deaktiviert ist. Andernfalls werden neue Instrumentierungseinstellungen möglicherweise nicht vom Browser übernommen.

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

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

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

Im Leistungsdashboard fehlen Daten zur Verzögerung bei der ersten Eingabe

In modernen Apps wird _fid nicht mehr verwendet, da Interaction to Next Paint (INP) First Input Delay (FID) ersetzt hat.

So erfassen Sie FID in älteren Browsern:

1. Fügen Sie das alte FID-Polyfill hinzu.

2. Bestätigen Sie, dass der Nutzer innerhalb von 5 Sekunden nach dem Laden mit der Seite interagiert. Performance Monitoring erfasst FID nur in diesem Zeitfenster.

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. Prüfen Sie die Einrichtung von benutzerdefinierten Code-Traces, die über die Trace API instrumentiert wurden, insbesondere Folgendes:

   • Namen für benutzerdefinierte Code-Traces und benutzerdefinierte Messwerte müssen die folgenden Anforderungen erfüllen: keine Leerzeichen am Anfang oder Ende, kein Unterstrich (_) am Anfang und eine maximale Länge von 32 Zeichen.
   • Alle Traces müssen gestartet und beendet werden. Traces, die nicht gestartet, nicht beendet oder vor dem Start beendet wurden, werden nicht protokolliert.

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

2. Achten Sie darauf, dass die Datenerfassung für Performance Monitoring nicht über das folgende Flag deaktiviert ist:

   • performance.dataCollectionEnabled

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

3. Prüfen Sie Ihre Log-Nachrichten, um sicherzustellen, dass Performance Monitoring die erwarteten benutzerdefinierten Code-Traces protokolliert.

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

Im Leistungsdashboard fehlen Daten zu Netzwerkanfragen

Wenn Daten zu Netzwerkanfragen fehlen, 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 offene HTTP/S-Verbindungen möglicherweise nicht gemeldet werden.

Netzwerkanfragedaten werden nicht wie erwartet zusammengefasst

Weitere Informationen zum Aggregieren von Daten zu Netzwerkanfragen in Performance Monitoring anhand von URL-Mustern

Sie können auch benutzerdefinierte URL-Muster ausprobieren.

Was ist mit den wichtigsten Problemen auf der Karte „Leistung“ auf der Projektstartseite passiert?

Wir haben Top-Probleme durch Letzte Benachrichtigungen ersetzt. Damit reagieren wir auf die Einführung von Benachrichtigungen, die Sie automatisch informieren, wenn die von Ihnen festgelegten Grenzwerte überschritten werden. Probleme wurden eingestellt und durch Benachrichtigungen ersetzt.

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

Weitere Informationen zu Benachrichtigungen

Was ist mit der Möglichkeit passiert, Grenzwerte für Probleme in der Konsole festzulegen?

Performance Monitoring unterstützt Benachrichtigungen für Messwerte, die definierte Schwellenwerte überschreiten. Um Verwirrung 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 Informationen unter „Details“ und „Messwerte“ in der Firebase-Konsole passiert?

Wir haben die Seiten „Details“ und „Messwerte“ durch eine neu gestaltete, zentrale Benutzeroberfläche ersetzt, um die Fehlersuche zu vereinfachen. Diese neue Benutzeroberfläche zur Fehlerbehebung bietet dieselben Hauptfunktionen wie die bisherigen Bereiche „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 eine große Menge an Leistungsaktivitäten generiert, kann Performance Monitoring die Datenerhebung auf eine Teilmenge von Geräten beschränken, um die Anzahl der verarbeiteten Ereignisse zu reduzieren. Diese Grenzwerte sind hoch genug, sodass die Messwerte auch bei weniger Ereignissen repräsentativ für die App-Nutzung durch Ihre Nutzer sind.

Um die Menge der von uns erhobenen Daten zu verwalten, verwendet Performance Monitoring die folgenden Stichprobenoptionen:

• Ratenbegrenzung auf dem Gerät: Damit ein Gerät nicht plötzlich eine große Anzahl von Traces sendet, begrenzen 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 wiederholten Instrumentierungen, 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- und Netzwerkanfrage-Traces pro App für alle App-Nutzer. Auf Geräten wird eine dynamische Samplingrate 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, sendet keine Ereignisse. Die dynamische Stichprobenrate ist app-spezifisch und wird so angepasst, dass das Gesamtvolumen der erhobenen 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 einschränken.

• Serverseitige Ratenbegrenzung: Damit Apps das Stichprobenlimit nicht überschreiten, kann Performance Monitoring serverseitige Stichproben verwenden, um einige von Geräten empfangene Ereignisse zu verwerfen. Diese Art der Einschränkung ändert zwar nicht die Effektivität unserer Messwerte, kann aber zu geringfügigen Musteränderungen führen, z. B.:

  • Die Anzahl der Traces kann sich von der Anzahl der Ausführungen eines Codeabschnitts unterscheiden.
  • Traces, die im Code eng miteinander verbunden sind, können jeweils eine unterschiedliche Anzahl von Stichproben haben.

Was ist mit dem Tab Probleme in der Console passiert?

Wir haben den Tab „Probleme“ durch Benachrichtigungen ersetzt. Sie werden automatisch benachrichtigt, wenn die von Ihnen festgelegten Grenzwerte überschritten werden. Sie müssen die Firebase-Konsole nicht mehr manuell aufrufen, 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 Console passiert? Wie kann ich die Traces auf diesen Seiten ansehen?

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

Die Tabelle „Traces“ unten auf dem Tab Dashboard enthält dieselben Informationen wie die Tabs On device und Network, bietet aber einige zusätzliche Funktionen, z. B. die Möglichkeit, Traces 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 Tracetabelle auf den Tracenamen.

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

• Traces von Netzwerkanfragen (sowohl standardmäßig als auch benutzerdefiniert) – Untertab Netzwerkanfragen
• Traces für benutzerdefinierten Code – Untertab Benutzerdefinierte Traces
• Traces für App-Start, App im Vordergrund und App im Hintergrund – Untertab Benutzerdefinierte Traces
• Bildschirm-Rendering-Traces – Untertab Bildschirm-Rendering
• Seitenaufbau-Traces – Untertab Seitenaufbau

Weitere Informationen zur Tabelle „Traces“ und zum Ansehen von Messwerten und Daten finden Sie auf der Übersichtsseite der Konsole (iOS+ | Android | Web).

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

Langsam gerenderte Frames und eingefrorene Frames werden mit einer angenommenen Aktualisierungsrate des Geräts von 60 Hz berechnet. Wenn die Aktualisierungsrate eines Geräts niedriger als 60 Hz ist, dauert das Rendern jedes Frames länger, da weniger Frames pro Sekunde gerendert werden. Längere 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 Aktualisierungsrate eines Geräts jedoch höher als 60 Hz ist, wird jeder Frame schneller gerendert. Dadurch werden möglicherweise weniger langsame oder eingefrorene Frames gemeldet. Dies ist eine aktuelle Einschränkung im Performance Monitoring SDK.

Wie füge ich meiner Web-App das kleinere, namensraumbezogene Performance Monitoring JS SDK (das „Standalone“-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:

• eine Bibliothek mit Namespace verwenden
• Reduzierung der SDK-Paketgröße
• die Initialisierung des SDKs bis nach dem Laden Ihrer Seite verzögern

So binden 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 Skript 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/12.19.0/firebase-performance.js'
• firebaseConfig ist das Firebase-Konfigurationsobjekt Ihrer App.

Im obigen Skript wird das eigenständige SDK asynchron geladen und Firebase nach dem Auslösen des onload-Ereignisses des Fensters initialisiert. Diese Taktik verringert die Auswirkungen, die das SDK auf Messwerte für den Seitenaufbau haben kann, da der Browser seine Lademesswerte bereits gemeldet hat, wenn Sie das SDK initialisieren.

(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);

Wie viele benutzerdefinierte URL-Muster kann ich erstellen?

Sie können insgesamt bis zu 400 benutzerdefinierte URL-Muster pro App und bis zu 100 benutzerdefinierte URL-Muster pro Domain für diese App erstellen.

Was bedeutet „nahezu in Echtzeit“ bei Leistungsdaten?

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

Damit Sie die Datenverarbeitung nahezu in Echtzeit nutzen können, muss Ihre App eine mit Echtzeit kompatible SDK-Version verwenden.

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

Damit Sie die Datenverarbeitung nahezu in Echtzeit nutzen können, muss Ihre App lediglich eine Performance Monitoring-SDK-Version verwenden, die mit der Echtzeitdatenverarbeitung kompatibel ist.

Dies sind die mit Echtzeit kompatiblen SDK-Versionen:

• iOS: Version 7.3.0 oder höher
• tvOS: v8.9.0 oder höher
• Android: v19.0.10 oder höher (oder Firebase Android BoM v26.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 sind echtzeitkompatibel?

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

• iOS: Version 7.3.0 oder höher
• tvOS: v8.9.0 oder höher
• Android: v19.0.10 oder höher (oder Firebase Android BoM v26.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 Echtzeit kompatible SDK-Version aktualisiere?

Wenn Ihre App keine mit Echtzeit kompatible SDK-Version verwendet, sehen Sie trotzdem alle Leistungsdaten Ihrer App in der Firebase Console. Die Anzeige der Leistungsdaten verzögert sich jedoch um etwa 36 Stunden ab dem Zeitpunkt der Erhebung.

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

Sehr gut. Unabhängig davon, welche SDK-Version in einer App-Instanz verwendet wird, sehen Sie Leistungsdaten von allen Ihren Nutzern.

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

Warum werden Leistungsdaten nicht in Echtzeit angezeigt?

Damit Sie Leistungsdaten in Echtzeit aufrufen können, muss in Ihrer App eine Performance Monitoring-SDK-Version verwendet werden, die mit der Echtzeitdatenverarbeitung kompatibel ist.

• iOS: Version 7.3.0 oder höher
• tvOS: v8.9.0 oder höher
• Android: v19.0.10 oder höher (oder Firebase Android BoM v26.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.