diff --git a/site/dlx.xml b/site/dlx.xml index 2ddb3a40a8..f46cd0ef12 100644 --- a/site/dlx.xml +++ b/site/dlx.xml @@ -184,8 +184,9 @@ args.put("x-dead-letter-routing-key", "some-routing-key");
The dead-lettering process adds an array to the header of
each dead-lettered message named x-death.
- This array contains an entry for each time the message was
- dead-lettered. Each such entry is a table that consists
+ This array contains an entry for each dead lettering event,
+ identified by a pair of {queue, reason}.
+ Each such entry is a table that consists
of several fields:
queue - the name of the queue the
@@ -196,11 +197,13 @@ args.put("x-dead-letter-routing-key", "some-routing-key");
exchange - the exchange the message was
published to (note that this will be a dead letter
exchange if the message is dead lettered multiple
- times), androuting-keys - the routing keys
(including CC keys but excluding
BCC ones) the message was published
- with.count - how many times this message was
+ dead-lettered in this queue for this reason, andoriginal-expiration (if the message was
dead-letterered due to per-message TTL) - the
@@ -209,6 +212,10 @@ args.put("x-dead-letter-routing-key", "some-routing-key");
message on dead-lettering in order to prevent it from
expiring again in any queues it is routed to.x-death already contains an entry with
+ the same queue and dead lettering reason, its count field will be
+ incremented.
The reason is a name describing why the