When routing events to a destination via RudderStack, there can be instances when the events do not show up in your destination. In such cases, knowing the reason for failure is helpful.
This guide walks you through the steps to debug your destination live events using RudderStack's Live Events feature.
Why are events sent to the destination failing?
Routing events to a destination via RudderStack can fail for various reasons. Some of the common ones include:
- Incorrect destination configuration.
- Bad event structure, that is, event is not in a destination-specific format.
- Rate limiting enforced by the destination.
- Destination downtime.
You can use RudderStack's Live Events feature to view the events sent to your destination in real-time, and debug any delivery failure.
Viewing destination live events
To view the events sent to your destination in real-time, follow these steps:
- Set up your destination in RudderStack.
- Click the LIve Events button to view the events sent from your source, as shown:

The resulting window highlights the following information:
- Name of the event.
- Error message of the event in case of any event failure. Upon clicking See full error, you get the specific details like the error response and the time of the first attempt made to send the event.

- Clicking the event also lets you view the payload sent to the destination.

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

On clicking the See full error option, you can see the following error response:

From the error response, it is clear that an identify
event was sent to the destination. According to the Facebook Custom Audience documentation, only track
events are supported. As a result, when RudderStack tries sending the identify
event, the destination gives an error. RudderStack retries sending this event several times before marking it as aborted.
This way, you can use the Live Events feature to better understand the responses received from the destination in case of any delivery failures and resolve them faster.
Contact us
For more information on the topics covered on this page, email us or start a conversation in our Slack community.