Dead-letter queue
Simple Message Queue (formerly MNS) uses a dead-letter queue to store messages that consumers negatively acknowledge or fail to process after retries. This helps you handle abnormal messages and troubleshoot issues.
Dead-letter policy
Dead-letter status
A message enters dead-letter status and moves to the dead-letter queue when it reaches the maximum retry count without being successfully consumed.
Different retry policies allow different numbers of retries. For more information, see Retry policy (NotifyStrategy).
Dead-letter message retention rules
-
A subscription can select a queue as its dead-letter queue to store dead-letter messages.
-
If the subscription type is queue, you cannot select the subscription's own queue as the dead-letter queue.
Create a dead-letter queue
Log on to the SMQ console.
-
In the left navigation pane, choose .
-
On the Subscriptions page, click Create Subscription.
-
In the Create Subscription panel, turn on Enable Dead-letter, select a target queue as the Dead-letter Queue, then click OK.
For configuration rules of other parameters, see Subscription types.