Help Center

What is live events mode?

Live events mode is a real-time stream of events arriving in your analytics project. It shows each event as it is received, including the event name, user, timestamp, and all attached properties. It is one of the most useful tools for debugging your tracking implementation and monitoring activity as it happens.

Accessing the live events stream

1. Open your analytics project in Userorbit.
2. Click Live Events in the project navigation menu.
3. The stream begins immediately, showing events as they arrive.

Each event in the stream displays:

• The event name — for example, page_viewed or button_clicked.
• The user — the identified user or anonymous ID associated with the event.
• The timestamp — when the event was received.
• A preview of properties — the first few key-value pairs attached to the event.

Filtering events in real-time

When your product has high event volume, the raw stream can be overwhelming. Use filters to focus on what you need:

• Filter by event name — Type an event name in the filter bar to show only matching events. This is useful when you are testing a specific tracking call.
• Filter by user — Enter a user ID or email to see only events from a particular user. This helps when debugging a specific user's experience.
• Filter by property — Narrow the stream to events with a specific property value, such as page = /checkout.

Filters can be combined. For example, you can filter for button_clicked events from a specific user to see exactly what they interacted with.

Inspecting event details

Click on any event in the stream to expand its full details. The detail view shows:

• All event properties with their types and values.
• The full user context, including identified properties.
• Technical metadata like the SDK version and device information.

This expanded view is invaluable for verifying that your tracking implementation sends the correct data.

Using live events for debugging

Live events mode is your primary debugging tool when setting up or modifying event tracking. Here is a typical debugging workflow:

1. Open Live Events and set a filter for the event you are working on.
2. Trigger the action in your application.
3. Confirm the event appears in the stream.
4. Click on the event to verify all properties are present and correctly formatted.
5. If the event does not appear, check your SDK initialization and the browser's network tab for errors.

Monitoring production activity

Beyond debugging, live events mode is useful for monitoring production activity in real time. Use cases include:

• Launch monitoring — Watch events flow in after deploying a new feature to confirm it is being used.
• Incident detection — If you notice a sudden drop in events or a spike in error events, you can investigate immediately.
• Demo and walkthroughs — Show stakeholders real user activity as it happens to demonstrate product engagement.

Performance considerations

Live events mode streams data to your browser in real time. For high-volume projects, the stream may update very quickly. The filter controls help manage this, but if you are only interested in aggregate numbers rather than individual events, dashboards are a more appropriate tool.