The Live Stream is a real time view of data coming in and out of mParticle. It allows you to review inbound data from mParticle instrumented apps - to ensure correct SDK and/or server-to-server implementation - and outbound events to services - to test that your integrations are correctly set up. If there are any errors in forwarding event data to a specific integration, an error icon will appear next to the integration message type displaying the reason.
You can filter the data shown in the Live Stream in several ways.
Inputs - Select an individual Platform or Feed to show only data from that input
Outputs - Select an individual output event configuration in your workspace. If you set this filter, you must also set Message Direction to either
Both In and Out.
Message Direction - Select
Both In and Out. Inbound messages are data arriving in mParticle from instrumented apps or from partner feeds. Outbound messages are data sent by mParticle to an output service.
Device - Often, during testing, you will want to monitor a specific test device. The Device drop-down allows you to choose a device to monitor from all devices that are currently sending messages to all workspaces in the account, as well as all devices that have been saved. Observed devices will be identified by the device’s Platform and 32 character UUID, for example:
To save a specific device:
Once you save a device, it remains in the drop down list.
Usually, the Live Stream shows only Dev data, but if you filter for a specific device, the Live Stream will also show events from the Production environment. When attempting to match a device to a Device ID, mParticle will look first for an Advertising Identifier (IDFA for iOS, GAID for Android), if an Advertising Identifier is not present, mParticle will attempt to match against a persistent device ID (IDFV for iOS, Android ID for Android).
To pause the event view, click Pause or click on a particular event. When the event view is paused, the Pause button changes to a Resume button. The stream remains paused as you select additional events. It will resume by clicking Resume.
To view the details of a specific event, select the event from the Live Stream list. The Live Stream pauses, the selected event expands to display additional message details, and the Event Details panel is shown.
The Event Details panel contains additional event information arranged by category.
If you select a
Batch message, the Event Details panel will display general batch details, user attributes, user identities and location information.
If you select an
event message, the Event details panel will display general event details, app version, event attributes, device information, platform information and location information
Click View Event in the event details panel for a JSON representation of the data.
When initiating a new session on the test device, you may want to clear the Live Stream from the last test session. To do this, simply click Clear Entries. The Live Stream and event details clear immediately, but the filters retain their values.