Warren
Act on dead letters

Park, discard and purge

CommunityTeamPro

Not every dead letter should go back. Some are poison (they fail every time), some are obsolete, some belong to a test. Warren has three ways to deal with them, all for operators and admins, all in the audit log.

Park

Park (m) moves messages to <queue>.parking: out of the way of replays and replay rules, but not lost.

Parking two messages with a note for the audit log and the messages themselves
Parking two messages with a note for the audit log and the messages themselves
  • The messages keep every header, x-death included, so a later replay from the parking queue still goes to the original route.
  • Each one gets x-warren-parked-from, x-warren-parked-at, x-warren-parked-by and the optional note as x-warren-park-reason.
  • Warren creates the parking queue as a plain durable queue the first time (this needs configure permission; otherwise create it once yourself) and uses an existing one as it is.

Parking queues are tagged PARKED in the queue list. Open one, fix the cause, and replay from there.

Discard

Discard (d) removes messages from the queue. It needs a reason of at least three characters, which goes into the audit log next to each message's id, fingerprint and a preview of its payload.

Discarding the first 20 messages after a dry run, with the reason
Discarding the first 20 messages after a dry run, with the reason

Purge

All messages in the queue in the discard dialog purges: the broker empties the queue in one step, whatever its size. The audit log keeps who, why and how many, no message contents. Messages consumers hold unacknowledged stay, and streams cannot be purged.

Warren counts the queue first and stops if more messages arrived before you confirm, see Dry run.

Undo: a copy for seven days

Before Warren acknowledges a discarded message it stores a full copy of it: body, properties and headers, x-death included. On the action's page in the audit log, Restore puts the messages back into the source queue as they were, each with x-warren-restored-from naming the discard. A restore works once and is an audited action of its own.

A purge keeps the same copy for a queue of up to 10,000 messages: Warren then takes the messages one by one instead of asking the broker to empty the queue. A larger queue is purged in one step, without a copy, and the dialog says so.

VariableDefaultWhat it does
WARREN_DISCARD_BACKUP_RETENTION7dhow long copies are kept; 0 keeps none
WARREN_DISCARD_BACKUP_MAX_BYTES100 MiBmost message bytes one action keeps; messages beyond it are removed without a copy, and the action page says how many have one

The copies live in Warren's database, so they hold the payloads: protect it like the broker.

Bulk actions and approvals

"The first N" and "every match" are frozen by a dry run before they can be confirmed. In Pro, discards and purges can wait for a second operator: see Four-eyes approval.