Live Events

Use the Live Events feature to view your source and destination events in real-time.

RudderStack’s Live Events feature gives you a real-time view of the events flowing from your sources to the connected destinations. You can use this feature for better observability into your events and debug errors in case of any event failures at the destination level.

You can use this utility to view the following three types of events:

Live events typeDescription
Source live eventsView source events collected by RudderStack in real-time.
Destination live eventsView events sent to the destination in real-time.
Transformation live eventsView transformed events in real-time.

Source live events

This feature provides you with the real-time visibility into the source events collected by RudderStack. You get information like:

  • Name of the event
  • Type of the event collected from the source
  • Date and Time of the collected event
info
This feature is helpful when you want to verify if your source is correctly configured.

View source live events

  1. Go to the source for which you want to view the live events.
  2. Click the Live events button.
Live Events
  1. Once you send the event data from the source to RudderStack, you will be able to see it in the Live events window.
info

Note that:

  • It may take a couple of seconds before your events start showing up.
  • You can view live events sent up to the past five minutes.
Source live events details

Destination live events

When routing events to a destination, there can be instances when the events do not show up in the destination. In such cases, knowing the reason for failure is helpful.

The destination live events feature gives you real-time visibility into your destination’s responses. You get information like:

  • Name of the event
  • Error message of the event in case of event failure. It gives the specific details related to an error including the error response and the date and time of the attempt made to send the event.
  • The Payload sent to the destination can be seen by clicking on an event.

View destination live events

warning
You can view live events for cloud mode destinations only, that is, destinations that support sending events via cloud mode.
  1. Go to the destination for which you want to view the live events.
  2. Click the Live events button.
  3. Once you send the events from your source to the destination, you will see them in this window.
info

Note that:

  • Live events are shown for all destinations. However, the event payload is not shown for some destination types like the object storage platforms and data warehouses.
  • It may take a couple of seconds before your events start showing up.
  • You can view live events sent up to the past five minutes.
  • You can use this view to filter events by source if your destination is connected to multiple sources.
Payload to the destination

Use case

Suppose that you send some events to Facebook Custom Audience but they are not delivered. On checking the Live Events tab for the Facebook Custom Audience destination, you see the following error:

Custom Audience destination error

Clicking on See full error option displays the following error response:

Custom Audience full destination error

As seen above, an identify event is sent to Facebook Custom Audience. The Custom Audience documentation states that RudderStack supports sending only audiencelist calls.

Therefore, you get an error when RudderStack tries sending the identify event to Custom Audience. RudderStack tries sending this event several times before marking it as aborted.

Transformations live events

You can also view the live events in case a transformation is connected to a destination. RudderStack lets you view the events before and after a transformation is applied:

Transformation live events

RudderStack also notifies you about any dropped events or errors during the transformation along with the details:

Transformation live events error message

FAQ

Why are the events sent to the destination failing?

Routing events to a destination can fail for various reasons. Often, it is due to the incorrect configuration of a destination in the RudderStack dashboard. Some other possible reasons are:

  • Incorrect/bad event payload structure
  • Rate-limiting by the destination
  • Network error
  • Destination downtime

The Destination Live Events feature gives you better visibility into how your events are sent to the destination. If there are any delivery failures, the utility also gives you insights into the reasons for the failure.

Are live events supported for device mode destinations?

RudderStack does not support the live events functionality for device mode destinations, that is, destinations configured to receive events in device mode.

You can view live events for cloud mode destinations only.


Questions? Contact us by email or on Slack