XINFO-CONSUMERS(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

💖 XINFO-CONSUMERS 💖

okay bestie, this is the xinfo-consumers page from the Valkey Command Manual, and it's lowkey one of the most useful little stream commands ever. let's get into it 🫶

✨ SYNOPSIS ✨

XINFO CONSUMERS key group

🌸 DESCRIPTION 🌸

so basically, this command hands you back the list of all the consumers chillin' inside the <groupname> consumer group, on the stream that lives at <key>. the way that it just… tells you who's in the group?? iconic. 💅

here's everything it spills for each consumer in the group:

  • name — the consumer's name, obvs 💖
  • pending — how many entries are sitting in the PEL, aka the pending messages for this consumer. these are messages that got delivered but have not been acknowledged yet. not them being left on read 😭
  • idle — the number of milliseconds since the consumer's last attempted interaction. examples of that: XREADGROUP, XCLAIM, XAUTOCLAIM. so like, even if they tried and got nothing, it still counts ✨
  • inactive — the number of milliseconds since the consumer's last successful interaction. examples: an XREADGROUP that actually read some entries into the PEL, or an XCLAIM/XAUTOCLAIM that actually claimed some entries. so this one is the "they actually did the thing" timer 🌸
ngl the idle vs inactive glow-up is real — see HISTORY below, it got a whole meaning change. 👑

🎀 REPLY 🎀

valkey-protocol(7) Array reply: a list of consumers and their attributes. simple as that, bestie 🦋

⭐ COMPLEXITY ⭐

O(1)

yes. constant. she's fast. periodt. 💅

💜 ACL CATEGORIES 💜

@read @slow @stream

🌈 HISTORY 🌈

  • Available since: 5.0.0
  • Changed in 7.2.0: Added the inactive field, and changed the meaning of idle. (yes the glow-up was real, they redefined the whole vibe of idle 😭)

🔥 EXAMPLES 🔥

> XINFO CONSUMERS mystream mygroup
1) 1) name
   2) "Alice"
   3) pending
   4) (integer) 1
   5) idle
   6) (integer) 9104628
   7) inactive
   8) (integer) 18104698
2) 1) name
   2) "Bob"
   3) pending
   4) (integer) 1
   5) idle
   6) (integer) 83841983
   7) inactive
   8) (integer) 993841998

look at Alice and Bob, both with 1 pending, both absolutely not acknowledging their messages. relatable tbh 🙈

🧚 SEE ALSO 🧚

okay that's the whole page, you ate that fr fr 👑💖 this was XINFO-CONSUMERS(3valkey) from the Valkey Command Manual, version 9.0.0, dated 2025-10-21. go check on your consumers, bestie, somebody's PEL is probably a mess 🌸✨🦋

📦 where this page comes from