Configure Azure Service Bus MaxDeliveryCount and inspect the dead-letter sub-queue for a queue or subscription

domain: learn.microsoft.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Set the MaxDeliveryCount property on the queue or subscription (default is 10; valid range is 1 to 2147483647) at creation or via an update operation
  2. Understand that each time a peek-locked message is explicitly abandoned or its lock expires without completion, the message's delivery count increments
  3. Once delivery count exceeds MaxDeliveryCount, Service Bus automatically moves the message to the entity's dead-letter sub-queue with a dead-letter reason of MaxDeliveryCountExceeded
  4. Access the dead-letter sub-queue directly using the path syntax <queue-path>/$deadletterqueue for queues, or <topic-path>/Subscriptions/<subscription-name>/$deadletterqueue for subscriptions
  5. Inspect dead-lettered messages using a client/tool such as Service Bus Explorer, the Azure CLI, or an SDK receiver pointed at the DLQ sub-queue path, and read the DeadLetterReason/DeadLetterErrorDescription properties
  6. Build a reprocessing or alerting pipeline that periodically drains and inspects the DLQ rather than letting it grow unbounded

Known gotchas

Related routes

Configure RabbitMQ quorum queue x-delivery-limit to automatically dead-letter poison messages after N delivery attempts
rabbitmq.com · 6 steps · unrated
Configure Azure Service Bus duplicate detection window and diagnose prefetch pitfalls
azure-service-bus · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans