0Pricing
Redis Caching & Messaging (Pub/Sub, Streams) · Lesson

Implementing Consumer Group Logic

Learn to create groups, read messages using `XREADGROUP`, and acknowledge processing with `XACK`.

Implementing Consumer Group Logic is a free Redis Caching & Messaging (Pub/Sub, Streams) lesson on CoddyKit — lesson 2 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 Redis Caching & Messaging (Pub/Sub, Streams) learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Welcome to Consumer Groups!

In the previous lesson, we learned what Redis Streams are. Now, let's dive into Consumer Groups! They are a powerful feature that lets multiple clients process messages from a stream cooperatively.

Imagine a team of workers processing tasks from a single to-do list. Each worker gets unique tasks, and if one fails, others can pick up pending tasks. That's what Consumer Groups enable!

Set Up Your Group

Before consumers can join, you need to create a Consumer Group for your stream. This is done using the XGROUP CREATE command.

It tells Redis: "Hey, for this stream, make a new group." You also specify an ID, which is typically 0 or $ to start reading from the beginning or end of the stream.

Create Your First Group!

Let's create a group named mygroup for a stream called mystream. The $ means "start reading from the latest entry." The MKSTREAM option is crucial: it creates the stream if it doesn't already exist!

Try it out:

XGROUP CREATE mystream mygroup $ MKSTREAM

Reading with `XREADGROUP`

Once a group is created, consumers can start reading messages using the XREADGROUP command. This command is designed specifically for consumer groups.

It ensures that each message is delivered to only one consumer within the group. If a consumer fails to acknowledge a message, it remains pending and can be claimed later.

Decoding `XREADGROUP`

The XREADGROUP command has several important parameters:

  • GROUP <groupname> <consumername>: Specifies which group and consumer are reading.
  • COUNT <N>: Optional. Limits the number of messages to read.
  • BLOCK <milliseconds>: Optional. Blocks the client if no messages are available.
  • STREAMS <streamname> <ID>: The stream to read from and the ID. Use > to get new messages that haven't been delivered to any other consumer in the group yet.

Let's Read Some Messages!

First, let's add a few messages to our mystream:

XADD mystream * event start task:1
XADD mystream * event process task:1

Consumer Reads New Messages

Now, let's have a consumer named consumer-1 from mygroup read from mystream. The > ID means "new, unread messages."

XREADGROUP GROUP mygroup consumer-1 STREAMS mystream >

Confirming Message Processing

After a consumer successfully processes a message, it's crucial to acknowledge it. This tells Redis that the message has been handled and can be removed from the consumer's Pending Entries List (PEL).

Acknowledgment prevents the same message from being re-delivered to another consumer if the current one crashes or goes offline before completing the task.

How to `XACK`

The command to acknowledge messages is XACK. Its syntax is straightforward:

XACK <streamname> <groupname> <ID> [ID ...]

You provide the stream name, the consumer group name, and one or more message IDs that have been successfully processed.

Put `XACK` into Practice

Let's assume you received message IDs 1678881234567-0 and 1678881234568-0 from the previous read. You would acknowledge them like this (replace with your actual IDs):

XACK mystream mygroup 1678881234567-0 1678881234568-0

Test Your Knowledge

You've learned how to create groups, read messages, and acknowledge them. Which of the following statements about Redis Consumer Groups is TRUE?

Recap: Consumer Group Logic

Great job! You've mastered the fundamentals of implementing Redis Consumer Group logic:

  • We used XGROUP CREATE to set up a new group for a stream.
  • You learned to read messages cooperatively as a consumer with XREADGROUP.
  • We saw how XACK is vital for acknowledging processed messages, managing the Pending Entries List (PEL).

Next, we'll explore how to handle pending messages and consumer failures more robustly!

Frequently asked questions

Is the “Implementing Consumer Group Logic” lesson free?

Yes — the full text of “Implementing Consumer Group Logic” is free to read here on the web, and the Redis Caching & Messaging (Pub/Sub, Streams) 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 Redis Caching & Messaging (Pub/Sub, Streams) course, upgrade to CoddyKit PRO.

What will I learn in “Implementing Consumer Group Logic”?

Learn to create groups, read messages using `XREADGROUP`, and acknowledge processing with `XACK`. You practise Redis Caching & Messaging (Pub/Sub, Streams) 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 Redis Caching & Messaging (Pub/Sub, Streams)?

No prior experience is required. Redis Caching & Messaging (Pub/Sub, Streams) on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Implementing Consumer Group Logic” 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 Redis Caching & Messaging (Pub/Sub, Streams) lesson?

Yes. Every Redis Caching & Messaging (Pub/Sub, Streams) 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

  1. Introduction to Consumer Groups
  2. Implementing Consumer Group Logic
  3. Handling Pending Messages & Failures
  4. Monitoring Consumer Group Lag
← Back to Redis Caching & Messaging (Pub/Sub, Streams)