Dead-letter queue

Updated at:

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

  1. Log on to the SMQ console.

  2. In the left navigation pane, choose Topic Model > Subscriptions.

  3. On the Subscriptions page, click Create Subscription.

  4. 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.