Retries and dead letters
When an endpoint fails, Kestrel retries with backoff, then parks the event in a dead-letter queue, so nothing is lost and one bad endpoint never holds up the rest.
How retries work
Events now move to the dead-letter queue after three failed attempts. Before v2.4 they were retried for up to 24 hours.
A delivery fails when the endpoint answers with anything other than a 2xx, takes longer than 15 seconds, or can't be reached. Each retry waits longer than the last, with jitter so a recovering endpoint isn't hit by every event at once.
An endpoint that answers 410 Gone is disabled straight away and its pending events are dead-lettered.
The dead-letter queue
Dead-lettered events keep their payload, every attempt and the last error for 7 days. List them per endpoint to see what went wrong.
Replaying events
- Fix the endpoint, or wait until your customer confirms it's back.
- Open Deliveries, filter by Dead-lettered, and select the events to send again.
- Choose Replay. Each event is delivered once more and counted as a new attempt.
A replayed event may land after newer events for the same object. Compare the event's created timestamp before overwriting state.