{"componentChunkName":"component---src-templates-markdown-template-jsx","path":"/guides/data-platform/live-stream/","result":{"data":{"pageMetadata":{"title":"Live Stream","path":"/guides/data-platform/live-stream/","sourceCode":null,"metadataParent":{"title":"Data Platform","path":"/guides/data-platform/","sourceCode":null,"hasVersionPicker":null,"metadataChildren":[{"title":"Trends","path":"/guides/data-platform/trends/","order":1,"label":null},{"title":"Setup","path":"/guides/data-platform/setup/","order":2,"label":null},{"title":"Live Stream","path":"/guides/data-platform/live-stream/","order":3,"label":null},{"title":"Data Catalog","path":"/guides/data-platform/catalog/","order":4,"label":null},{"title":"Rules","path":"/guides/data-platform/rules/","order":5,"label":null},{"title":"Plans","path":"/guides/data-platform/data-planning/","order":6,"label":null},{"title":"Filters","path":"/guides/data-platform/data-filter/","order":7,"label":null},{"title":"Event Forwarding","path":"/guides/data-platform/event-forwarding/","order":8,"label":null},{"title":"Event Match Quality","path":"/guides/data-platform/event-match-quality/","order":9,"label":null},{"title":"Data Retention","path":"/guides/data-platform/data-retention/","order":10,"label":null},{"title":"Tiered Events","path":"/guides/data-platform/tiered-events/","order":11,"label":null},{"title":"Blocked Data Backfill Guide","path":"/guides/data-platform/blocked-data-backfill-guide/","order":12,"label":null}],"metadataParent":{"title":"Guides","path":"/guides/","metadataChildren":[{"title":"Platform Overview","path":"/guides/platform-overview/","order":0.5,"label":null},{"title":"Getting Started","path":"/guides/getting-started/","order":1,"label":null},{"title":"mParticle Agent","path":"/guides/mparticle-agent/","order":1.5,"label":null},{"title":"Oversight","path":"/guides/oversight/","order":2,"label":null},{"title":"Data Platform","path":"/guides/data-platform/","order":3,"label":null},{"title":"Data Warehouse","path":"/guides/data-warehouse/","order":4,"label":null},{"title":"Customer 360","path":"/guides/customer-360/","order":5,"label":null},{"title":"Analytics","path":"/guides/analytics/","order":6,"label":null},{"title":"Audiences","path":"/guides/audiences/","order":7,"label":null},{"title":"Settings","path":"/guides/settings/","order":8,"label":null},{"title":"Troubleshooting mParticle","path":"/guides/troubleshooting/","order":10,"label":null},{"title":"Default Service Limits","path":"/guides/default-service-limits/","order":11,"label":null},{"title":"Glossary","path":"/guides/glossary/","order":12,"label":null}],"metadataParent":null}}},"markdownRemark":{"html":"<p>The Live Stream provides a real time view of all data flowing in and out of mParticle.</p>\n<p>To find Live Stream, navigate to <strong>Data Platform > Live Stream</strong> using the left navigation.</p>\n<p><img src=\"/images/guides/platform-guide/live-stream/live-stream-overview.png\"></p>\n<p>You can use Live Stream 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.</p>\n<h2 id=\"filters\" style=\"position:relative;\"><a href=\"#filters\" aria-label=\"filters permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Filters</h2>\n<p>You can filter the data shown in the Live Stream in several ways. </p>\n<ul>\n<li><strong>Inputs</strong> - Select an individual Platform or Feed to show only data from that input</li>\n<li><strong>Outputs</strong> - Select an individual output event configuration in your workspace. If you set this filter, you must also set <strong>Message Direction</strong> to either <code class=\"language-text\">Outbound</code> or <code class=\"language-text\">Both In and Out</code>. </li>\n<li><strong>Message Direction</strong> - Select <code class=\"language-text\">Inbound</code>, <code class=\"language-text\">Outbound</code>, or <code class=\"language-text\">Both In and Out</code>. 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.</li>\n<li><strong>Device</strong> - 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: <code class=\"language-text\">(IOS) 09984094-08b5-4547-afc8-df1d07e5658d</code>.\n</li>\n</ul>\n<p>Live Stream shows only Development 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 for the following per platform:</p>\n<ul>\n<li><strong>iOS</strong>: IDFA (<code class=\"language-text\">ios_advertising_id</code> in the Events API)</li>\n<li><strong>Android</strong>: GAID (<code class=\"language-text\">android_advertising_id</code>)</li>\n<li><strong>Web</strong> and other platforms: Device Application Stamp (<code class=\"language-text\">mp_deviceid</code>)</li>\n</ul>\n<p>To save a specific device:</p>\n<ol>\n<li>Click <strong>Add/Edit Device</strong> to display the Device list.</li>\n<li>Click <strong>+</strong> next to the device you want to add, or click <strong>Add New Device</strong> to display the Add Device form.</li>\n<li>Enter/Modify the Device ID, Device Name, Device Type and click <strong>Add Device</strong>.</li>\n<li>Click <strong>Save</strong>.</li>\n</ol>\n<p>Once you save a device, it remains in the drop down list.</p>\n<p>Usually, the Live Stream shows only Development 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).</p>\n<h2 id=\"pausing-and-resuming\" style=\"position:relative;\"><a href=\"#pausing-and-resuming\" aria-label=\"pausing and resuming permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Pausing and Resuming</h2>\n<p>To pause the event view, click <strong>Pause</strong> 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 <strong>Resume</strong>.</p>\n<h2 id=\"examining-a-specific-event\" style=\"position:relative;\"><a href=\"#examining-a-specific-event\" aria-label=\"examining a specific event permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Examining a Specific Event</h2>\n<p>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.  </p>\n<p>The Event Details panel contains additional event information arranged by category. </p>\n<p>If you select a <code class=\"language-text\">Batch</code> message, the Event Details panel will display general batch details, user attributes, user identities and location information.</p>\n<p>If you select an <code class=\"language-text\">event</code> message, the Event details panel will display general event details, app version, event attributes, device information, platform information and location information</p>\n<p>Click <strong>View Event</strong> in the event details panel for a JSON representation of the data.</p>\n<p><img src=\"/images/live-stream-event-json.png\" alt=\"medium\"></p>\n<h2 id=\"clear-entries\" style=\"position:relative;\"><a href=\"#clear-entries\" aria-label=\"clear entries permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Clear Entries</h2>\n<p>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 <strong>Clear Entries</strong>. The Live Stream and event details clear immediately, but the filters retain their values. </p>","frontmatter":{"title":"Live Stream","order":3,"seoTitle":null,"seoDescription":null},"parent":{"__typename":"File","modifiedTime":"October 12, 2026"}}},"pageContext":{"slug":"/guides/data-platform/live-stream/"}},"staticQueryHashes":["2950460867"]}