Manage the dead letter queue in the Unity Dashboard
View, filter, replay, and discard failed events in the dead letter queue using the Unity Dashboard.
Read time 3 minutesLast updated 5 months ago
The Unity Dashboard is a simple way to monitor and manage the dead letter queue (DLQ). This page covers how to view failed events, filter and search the list, and replay or remove events in bulk or individually.
Prerequisites
- Access to the Unity Dashboard with the appropriate project and environment permissions.
- The Triggers DLQ Viewer role to view events, or the Triggers DLQ Manager role to also replay and discard events. Refer to Dead letter queue – Access control.
View dead letter queue events
To view the dead letter queue for an environment:
- In the Unity Dashboard, select Triggers (or Products > Triggers).
- Select the environment (for example production) from the environment dropdown.
- Open the Dead letter queue section or tab.
A table of failed events for the selected project and environment appears.
Table columns
The table includes the following columns:
Column | Description |
|---|---|
| Event ID | Unique identifier for the event. Use the copy icon to copy the ID so you can filter or group related events. When you replay an event and it fails again, a new entry joins the queue with the same event ID, so you can filter or group by that ID. |
| Trigger | The trigger that fired (for example "signed-in Authentication"). |
| Source | Origin: Webhook (failed HTTP delivery) or Triggers (failed trigger processing). |
| Status | Current state of the event. See DLQ event status and resolution for status values. |
| Time created | When the event was added to the dead letter queue. For retention, refer to Limits. |
| Logs | View logs opens the trigger's logs. Replay and Remove appear in the same row in separate controls (not under the Logs column). |
To debug failures, use View logs to open the trigger's logs, then replay or remove events as needed. You cannot open a per-event detail page from the table.
Filter and search
You can narrow the list using:
- Time period: Use the dropdown (for example "Last 14 days") to limit events by age. Retention is described in Limits.
- Status: Filter by status.
- Filter by event ID: Type an event ID to find or group events (for example after a replay that failed again).
Use the refresh icon to reload the list.
Replay or remove events
You can replay or remove events as follows:
- Replay all: Queues all currently listed pending events for replay. The system retries delivery asynchronously.
- Remove all: Marks all currently listed pending events as discarded (removed from the queue without reprocessing).
- Per event: Use Replay (curved arrow) to queue that event for replay, or Remove (trash icon) to discard that event.
After replay, if delivery fails again, a new entry may be created with the same event ID so you can group related attempts.