Search
Clear search
Close search
Google apps
Main menu

DebugView

Use DebugView to validate your analytics configuration during development.

To conserve network data and battery life on mobile devices, Analytics deployments poll usage data periodically – typically hourly. However, during development cycles you probably want to see how events are being logged in real time, so that you can observe results and make adjustments if needed without having to wait. DebugView enables you to monitor your app's events in real time.

Getting started

To use DebugView, you must first enable Debug mode on your device.

Android

To enable Analytics Debug mode on an emulated Android device, execute the following command lines:

adb shell setprop debug.firebase.analytics.app <package_name>

This behavior persists until you explicitly disable Debug mode by executing the following command line :

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

iOS

To enable Analytics Debug mode on your development device, specify the following command line argument in Xcode :

-FIRDebugEnabled

This behavior persists until you explicitly disable Debug mode by specifying the following command line argument:

--FIRDebugDisabled

Note: Before using DebugView, you should ensure that your device time is accurate. A skewed device clock will result in delayed or missing events in your Analytics reports.

Reporting

Once you have enabled Debug mode on your development devices, navigate to DebugView and start using your app to see your app’s events being logged in the DebugView report.

The Seconds stream (the middle column) shows the events which have been logged in the last 60 seconds. The Minutes stream (the left column) shows a series of archives of events over the last 30 minutes. The right column shows the Top Events logged in the 30-minute period, as well as the Current User Properties for the currently selected development device.

Seconds stream

By default, you will see a list of events logged in the last 60 seconds. Each event displays a timestamp that corresponds to the time of its logging on the development device. You can click on an event to see a list of the parameters that were associated with that event. As user property values change during the course of app usage, you will see events appear in the stream with the newest ones appearing at the top.

Minutes stream

This stream shows a series of circles which each correspond to a minute of time over the last 30 minutes. The number in the circle indicates the count of events received in that minute. Clicking on one of these circles will populate the Seconds stream with events which were logged during that minute of time. This effectively allows you to examine the events logged over the last 30 minutes in fine-grained detail.

Top events and Current User Properties

The Top Events table shows the top events which were logged during the 30-minute period. And the Current User Properties table shows the latest state of the set of User Properties for the currently selected development device.

Device selector

Since many different development devices can have Debug mode enabled, you can use the Device selector to choose the specific device on which the DebugView report will focus. This allows multiple developers to focus on their own instrumentation and validation efforts without impacting one another. The device selector menu is found in the upper left side of the UI, labeled DEBUG DEVICE.

Was this article helpful?
How can we improve it?