Ereignisse zur Fehlerbehebung

Mit DebugView können Sie die Rohdaten der Ereignisse, die von Ihrer App auf Entwicklungsgeräten protokolliert werden, nahezu in Echtzeit einsehen. Das ist für Validierungszwecke während der Instrumentierungsphase der Entwicklung sehr nützlich. So können Sie Fehler in Ihrer Analytics Implementierung finden und bestätigen, dass alle Ereignisse und Nutzereigenschaften korrekt protokolliert werden.

Fehlerbehebungsmodus aktivieren

Im Allgemeinen werden die von Ihrer App protokollierten Ereignisse über einen Zeitraum von etwa einer Stunde zusammengefasst und gemeinsam hochgeladen. So wird der Akku der Geräte von Endnutzern geschont und die Nutzung von Netzwerkdaten reduziert. Wenn Sie jedoch Ihre Implementierung validieren und Ihre Analytics Daten im DebugView-Bericht ansehen möchten, können Sie den Fehlerbehebungsmodus auf Ihrem Entwicklungsgerät aktivieren, um Ereignisse mit minimaler Verzögerung hochzuladen.Analytics

iOS+

Wenn Sie den Analytics Fehlerbehebungsmodus auf Ihrem Entwicklungsgerät aktivieren möchten, geben Sie das folgende Befehlszeilenargument in Xcode an:

-FIRDebugEnabled

Der Fehlerbehebungsmodus ist aktiv, bis Sie ihn ausdrücklich beenden, indem Sie das folgende Befehlszeilenargument angeben:

-FIRDebugDisabled

Sie können diese Argumente hinzufügen, indem Sie das Schema Ihres Projekts bearbeiten und einen neuen Eintrag zu „Arguments Passed On Launch“ hinzufügen.

Android

Wenn Sie den Fehlerbehebungsmodus für Analytics auf einem Android-Gerät aktivieren möchten, führen Sie die folgenden Befehle aus:

adb shell setprop debug.firebase.analytics.app PACKAGE_NAME

Der Fehlerbehebungsmodus ist aktiv, bis Sie ihn ausdrücklich beenden, indem Sie den folgenden Befehl ausführen:

adb shell setprop debug.firebase.analytics.app .none.

Web

Wenn Sie den Fehlerbehebungsmodus für Analytics im Browser aktivieren möchten, müssen Sie die Google Analytics Debugger Chrome-Erweiterung installieren.

Aktivieren Sie die Erweiterung anschließend und aktualisieren Sie die Seite. Ab diesem Zeitpunkt werden Ereignisse in Ihrer App im Fehlerbehebungsmodus protokolliert.

Sie können die in DebugView protokollierten Ereignisse in der Firebase Konsole ansehen.

Analytics

Bericht zu Ereignisdaten

Nachdem Sie den Fehlerbehebungsmodus auf Ihren Entwicklungsgeräten aktiviert haben, können Sie zu DebugView wechseln. Wählen Sie dazu in der oberen Navigationsleiste von Google Analytics den Pfeil neben StreamView und dann DebugView aus.

Rufen Sie DebugView auf, indem Sie in der oberen Navigationsleiste neben StreamView auf den Pfeil klicken.Google Analytics und wählen Sie DebugView aus.">

Starten Sie dann einfach Ihre App. Die Ereignisse der App werden jetzt im DebugView-Bericht erfasst.

DebugView-Bericht

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 derzeit ausgewählte Entwicklungsgerät.

Sekundenstream

Standardmäßig sehen Sie eine Liste von Ereignissen, 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 auf ein Ereignis klicken, wird eine Liste der Parameter eingeblendet, die mit diesem Ereignis verknüpft waren.

Beispielliste mit Ereignisparametern

Wenn sich die Werte für Nutzereigenschaften während der App-Nutzung ändern, sehen Sie einen Eintrag für diese Änderung.

Eine Beispiel-Nutzereigenschaft.

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 sämtliche Ereignisse, die in den letzten 30 Minuten erfasst wurden, detailliert untersuchen.

Beispiel für den Minutenstream

„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 derzeit ausgewählte Entwicklungsgerät.

Beispiel für die Tabelle mit den wichtigsten Ereignissen.

Geräteauswahl

Der Fehlerbehebungsmodus kann auf vielen verschiedenen Entwicklungsgeräten aktiviert sein. Über die Geräteauswahl können Sie 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.

Beispiel für die Geräteauswahl