Mit DebugView können Sie sich die von Ihrer App auf Entwicklungsgeräten protokollierten Rohereignisdaten nahezu in Echtzeit ansehen. Das ist sehr nützlich für die Validierung während der Instrumentierungsphase der Entwicklung und kann Ihnen helfen, Fehler in Ihrer Analytics-Implementierung zu finden und zu bestätigen, dass alle Ereignisse und Nutzereigenschaften korrekt protokolliert werden.
Debug-Modus aktivieren
In der Regel werden die von Ihrer App protokollierten Ereignisse über einen Zeitraum von etwa einer Stunde zusammengefasst und gemeinsam hochgeladen. Dieser Ansatz schont den Akku der Endnutzergeräte und reduziert die Nutzung von Netzwerkdaten. Zur Validierung Ihrer Analytics-Implementierung und zur Anzeige Ihrer Analytics im DebugView-Bericht können Sie jedoch den Debug-Modus auf Ihrem Entwicklungsgerät aktivieren, um Ereignisse mit minimaler Verzögerung hochzuladen.
iOS+
Wenn Sie den Analytics-Debug-Modus auf Ihrem Entwicklungsgerät aktivieren möchten, geben Sie das folgende Befehlszeilenargument in Xcode an:
-FIRDebugEnabled
Der Debug-Modus ist aktiv, bis Sie ihn über das folgende Befehlszeilenargument explizit deaktivieren:
-FIRDebugDisabled
Sie können diese Argumente hinzufügen, indem Sie das Schema Ihres Projekts bearbeiten und unter „Arguments Passed On Launch“ (Beim Start übergebene Argumente) einen neuen Eintrag hinzufügen.
Android
Führen Sie die folgenden Befehle aus, um den Analytics-Debug-Modus auf einem Android-Gerät zu aktivieren:
adb shell setprop debug.firebase.analytics.app PACKAGE_NAME
Der Debug-Modus ist aktiv, bis Sie ihn über den folgenden Befehl explizit deaktivieren:
adb shell setprop debug.firebase.analytics.app .none.
Web
Wenn Sie den Analytics-Debug-Modus im Browser aktivieren möchten, müssen Sie die Chrome-Erweiterung Google Analytics Debugger installieren.
Aktivieren Sie die Erweiterung anschließend und aktualisieren Sie die Seite. Ab diesem Zeitpunkt werden Ereignisse in Ihrer App im Debug-Modus protokolliert.
Sie können sich die in DebugView protokollierten Ereignisse in der Firebase-Konsole ansehen.
error Ereignis ansehen
Sowohl automatisch protokollierte error-Ereignisse (die auf Probleme bei der Protokollierung von Ereignissen oder Nutzereigenschaften hinweisen) als auch andere Ereignisse mit einem firebase_error-Parameter werden im DebugView-Bericht angezeigt.
error-Ereignisse werden direkt im Stream angezeigt. Bei anderen Ereignissen mit einem firebase_error-Parameter wird in DebugView im Hauptereignisstream keine spezielle Fehleranzeige eingeblendet. Sie müssen auf das Ereignis klicken, um den Parameter firebase_error in der Parameterliste zu sehen.
Wenn Sie Fehler bei der Analytics-Implementierung beheben möchten, suchen Sie in den Geräte-Konsolenlogs nach Nachrichten vom Firebase Analytics SDK. Diese enthalten oft Details dazu, warum ein Ereignis oder Parameter abgelehnt wurde.
Berichte zu Ereignisdaten
Achten Sie darauf, dass Sie den Debug-Modus auf Ihren Entwicklungsgeräten aktiviert haben, wie im vorherigen Abschnitt dieses Leitfadens beschrieben.
Rufen Sie in der Firebase-Konsole Analytics > DebugView auf.
Interagieren Sie mit Ihrer App, um zu sehen, wie die Ereignisse Ihrer App im DebugView-Bericht in der Firebase-Konsole protokolliert werden.
Im Sekundenstream (mittlere Spalte) sehen Sie die Ereignisse, die in den letzten 60 Sekunden protokolliert wurden. Der Minutenstream (linke Spalte) enthält die Ereignisse der letzten 30 Minuten. In der rechten Spalte sehen Sie die im Zeitraum von 30 Minuten erfassten wichtigsten Ereignisse und die aktuellen Nutzereigenschaften für das ausgewählte Entwicklungsgerät.
Sekundenstream
Standardmäßig sehen Sie eine Liste der Ereignisse, die in den letzten 60 Sekunden protokolliert wurden. Zu jedem Ereignis wird ein Zeitstempel angezeigt, der dem Protokollierungszeitpunkt auf dem Entwicklungsgerät entspricht. Wenn Sie ein Ereignis anklicken, wird eine Liste der zugeordneten Parameter eingeblendet.
Wenn sich die Werte für Nutzereigenschaften während der App-Nutzung ändern, wird ein Eintrag für diese Änderung angezeigt.
Minutenstream
In diesem Stream sehen Sie mehrere Kreise, von denen jeder einer Minute des letzten 30-Minuten-Zeitraums entspricht. Die Zahl in einem Kreis gibt an, wie viele Ereignisse in dieser Minute erfasst wurden. Wenn Sie auf einen dieser Kreise klicken, wird der Sekundenstream mit Ereignissen gefüllt, die während dieser Minute protokolliert wurden. So können Sie die in den letzten 30 Minuten protokollierten Ereignisse im Detail untersuchen.
"Wichtigste Ereignisse" und "Aktuelle Nutzereigenschaften"
Die Tabelle „Wichtigste Ereignisse“ enthält die bedeutendsten Vorkommnisse, die im letzten 30-Minuten-Zeitraum erfasst wurden. In der Tabelle „Aktuelle Nutzereigenschaften“ sehen Sie den letzten Status der Gruppe von Nutzereigenschaften für das ausgewählte Entwicklungsgerät.
Geräteauswahl
Da der Debug-Modus auf vielen verschiedenen Entwicklungsgeräten aktiviert sein kann, können Sie über die Geräteauswahl das Gerät festlegen, auf das sich der DebugView-Bericht beziehen soll. Mehrere Entwickler sind so in der Lage, sich auf ihre eigenen Instrumentierungs- und Validierungsaufgaben zu konzentrieren, ohne sich gegenseitig zu beeinträchtigen.
