Skip to main content

AWS Dead Letter Queue (DLQ) Implementation Guide


In AWS, a Dead Letter Queue (DLQ) is used to handle messages that fail to be processed multiple times in services like Amazon Simple Queue Service (SQS) and Amazon Simple Notification Service (SNS). DLQs are crucial for debugging message failures and ensuring that messages are not lost.

Use Case

Imagine an e-commerce application that uses SQS for order processing. Sometimes, messages might fail due to various reasons such as format errors or processing issues. A DLQ is set up to capture these failed messages for analysis and manual processing.

Step by Step Guide with Code Samples

Step 1: Prerequisites

  • AWS Account and AWS CLI configured.
  • Python environment with boto3 installed.

Step 2: Create an SQS Queue and a DLQ

First, create a standard SQS queue and a separate DLQ.

import boto3
import json

# Initialize the SQS client
sqs = boto3.client('sqs')

# Create a Dead Letter Queue
dlq = sqs.create_queue(QueueName='MyDLQ')
dlq_url = dlq['QueueUrl']
dlq_arn = sqs.get_queue_attributes(QueueUrl=dlq_url, AttributeNames=['QueueArn'])['Attributes']['QueueArn']

# Create a Main Queue with a Redrive Policy pointing to the DLQ
redrive_policy = {
"maxReceiveCount": "5", # Number of attempts before sending to DLQ
"deadLetterTargetArn": dlq_arn

main_queue = sqs.create_queue(
'RedrivePolicy': json.dumps(redrive_policy)
main_queue_url = main_queue['QueueUrl']

Step 3: Sending Messages to the Main Queue

# Send a message to the main queue
response = sqs.send_message(QueueUrl=main_queue_url, MessageBody='Order details here')

Step 4: Processing Messages

In your message processing application, messages are received and processed. If a message fails to process multiple times, it is sent to the DLQ.

def process_message(message):
# Processing logic here
# If processing fails, raise an exception

def receive_and_process_messages():
while True:
messages = sqs.receive_message(QueueUrl=main_queue_url, MaxNumberOfMessages=10)
if 'Messages' in messages:
for message in messages['Messages']:
sqs.delete_message(QueueUrl=main_queue_url, ReceiptHandle=message['ReceiptHandle'])
except Exception as e:
# Log the error. The message will be retried and eventually go to DLQ if it continues to fail
print(f"Error processing message: {e}")


Step 5: Handling Messages in the DLQ

Regularly check the DLQ and handle the messages that have failed to process.

def handle_dlq_messages():
while True:
messages = sqs.receive_message(QueueUrl=dlq_url, MaxNumberOfMessages=10)
if 'Messages' in messages:
for message in messages['Messages']:
# Handle the failed message (log, alert, manual process, etc.)
print(f"Failed Message: {message['Body']}")
# Delete the message after handling
sqs.delete_message(QueueUrl=dlq_url, ReceiptHandle=message['ReceiptHandle'])



DLQs in AWS are essential for robust and resilient message processing. They provide a way to isolate and handle message failures, ensuring that no message is lost and that the main queue is not clogged with problematic messages. The above guide demonstrates the basic implementation of DLQs in an AWS environment using SQS.