Single Active Consumer
Learn how the Single Active Consumer feature guarantees ordered processing by routing all messages to one consumer at a time, with automatic failover to standbys.
Single Active Consumer is a free RabbitMQ Messaging & Async Systems lesson on CoddyKit — lesson 4 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the RabbitMQ Messaging & Async Systems learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
Ordering vs Parallelism
Competing consumers boost throughput but break strict ordering: messages spread across workers can finish out of order.
Some workflows need both a hot standby and guaranteed sequence.
What Is Single Active Consumer?
Single Active Consumer (SAC) ensures only one consumer receives messages from a queue at a time, even if many consumers subscribe.
Others wait in line as standbys.
Enabling SAC
Set the x-single-active-consumer argument to true when declaring the queue.
channel.queue_declare(
queue='ordered-tasks',
durable=True,
arguments={'x-single-active-consumer': True}
)Automatic Failover
If the active consumer disconnects or its channel closes, RabbitMQ promotes the next registered consumer to active automatically.
This gives high availability without losing ordering.
Registration Order
Consumers become active in the order they registered. The first to subscribe becomes active; the rest queue up as standbys.
SAC vs Exclusive Consumer
- Exclusive: only one consumer is even allowed; others get an error
- SAC: many can subscribe, but only one is active; others stand by for failover
Subscribing as a Standby
Standby consumers subscribe normally. They simply receive no messages until promoted.
channel.basic_consume(queue='ordered-tasks', on_message_callback=handle)Guaranteed Order
Because only one consumer processes at a time, messages are handled in FIFO order as long as the consumer acks sequentially and prefetch keeps the pipeline tidy.
Throughput Trade-off
SAC sacrifices parallelism: throughput is bound to a single consumer. Use it only when ordering matters more than raw speed.
Inspecting the Active Consumer
The management UI and CLI mark which consumer is active. This helps verify failover behaved as expected during incidents.
Good Use Cases
- Sequential state machines
- Per-entity event streams that must stay ordered
- Workflows needing a warm standby worker
Quick Check
Check your understanding of SAC.
Recap
Single Active Consumer routes all messages to one consumer at a time, preserving FIFO ordering while keeping standbys ready for instant failover.
Enable it with x-single-active-consumer, and accept the throughput trade-off when order matters most.
Frequently asked questions
Is the “Single Active Consumer” lesson free?
Yes — the full text of “Single Active Consumer” is free to read here on the web, and the RabbitMQ Messaging & Async Systems course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the RabbitMQ Messaging & Async Systems course, upgrade to CoddyKit PRO.
What will I learn in “Single Active Consumer”?
Learn how the Single Active Consumer feature guarantees ordered processing by routing all messages to one consumer at a time, with automatic failover to standbys. You practise RabbitMQ Messaging & Async Systems with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start RabbitMQ Messaging & Async Systems?
No prior experience is required. RabbitMQ Messaging & Async Systems on CoddyKit is structured for beginners through advanced learners; this is — lesson 4 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Single Active Consumer” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this RabbitMQ Messaging & Async Systems lesson?
Yes. Every RabbitMQ Messaging & Async Systems lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Competing Consumers Pattern
- Prefetch Count (QoS)
- Exclusive Consumers & Consumer Priority
- Single Active Consumer