Redis 与缓存 / 系统课时

观察消费组进度

观察消费组进度

本课解决一个实际问题:消息流已经运行后,如何判断消费组有哪些消费者、还有多少待处理消息,以及消费进度是否正在前进。掌握几条观测命令后,就能把“感觉消费正常”变成可验证的状态判断。

学习目标

  • 能使用 XINFO GROUPS 和 XINFO CONSUMERS 查看消费组及消费者状态
  • 能使用 XPENDING 判断待处理消息数量、范围和消费者分布
  • 能结合 last-delivered-id、pending 等指标定位消费停滞

查看消费组整体进度

消费组的整体状态首先看 XINFO GROUPS。它能看到组名、消费者数量、pending 数量以及组最近投递到哪里等信息。下面创建一个最小实验,并让消费者读取部分消息但暂不确认。

bash
redis-cli XGROUP CREATE orders order-workers '$' MKSTREAM
redis-cli XADD orders '*' order_id 101 status created
redis-cli XADD orders '*' order_id 102 status created
redis-cli XADD orders '*' order_id 103 status created
redis-cli XREADGROUP GROUP order-workers worker-1 COUNT 2 STREAMS orders '>'
redis-cli XINFO GROUPS orders

预期结果

text
1) 1) "order-workers"
2) 1) "worker-1"
3) ...
4) "<PENDING_COUNT>"
5) ...
6) "<LAST_DELIVERED_ID>"

输出字段会随 Redis 版本不同而增加,例如较新的版本可能还会出现 entries-read、lag 等信息。因此排障时应关注字段语义,而不要依赖固定的字段序号。pending 表示已经投递给消费组成员、但尚未被确认的消息数量;last-delivered-id 表示消费组最近一次投递记录的位置。

查看消费者分布

继续使用 XINFO CONSUMERS 可以把组级状态拆到单个消费者。排查“是整个消费组变慢,还是某一个消费者积压”时,这一步尤其重要。

bash
redis-cli XINFO CONSUMERS orders order-workers

预期结果

text
1) 1) "name"
   2) "worker-1"
   3) "pending"
   4) "<PENDING_COUNT>"
   5) "idle"
   6) "<IDLE_MS>"

其中 pending 用来判断该消费者当前负责、但还没有确认的消息量;idle 表示自该消费者最近一次相关活动以来经过的时间。具体输出字段可能因 Redis 版本不同而不同,因此生产环境脚本应按字段名解析,而不是假设固定位置。

观察多个消费者时,可以把它们分成两类:一个消费者 pending 明显更高,通常优先检查该实例的处理速度、异常和确认逻辑;所有消费者 pending 都高,则更应检查下游处理能力、批量大小或整体消费吞吐。

查看待处理消息明细

组级和消费者级信息仍然不够时,用 XPENDING 查看 pending 范围。它可以先给出汇总,再进一步列出具体消息及所属消费者。

bash
redis-cli XPENDING orders order-workers
redis-cli XPENDING orders order-workers - + 10

预期结果

text
1) "<PENDING_COUNT>"
2) "<MIN_ID>"
3) "<MAX_ID>"
4) 1) 1) "worker-1"
      2) "<CONSUMER_PENDING_COUNT>"

1) 1) "<MESSAGE_ID_1>"
   2) "worker-1"
   3) "<IDLE_MS>"
   4) "1"

第一条命令适合快速判断是否存在未确认消息以及它们覆盖的大致 ID 范围。第二条命令列出具体 pending 项,可以继续关注消费者、空闲时间以及投递次数等信息。

建立一套运行状态判断方法

实际排查可以按“组 → 消费者 → 消息”逐层缩小范围。先用 XINFO GROUPS 判断组是否存在 pending 和进度变化,再用 XINFO CONSUMERS 判断是否集中在某个消费者,最后用 XPENDING 找出具体消息及其空闲时间。

判断结果时,至少同时关注三个信号:消费进度是否继续前进、pending 是否持续增长、消费者是否长期处于高 idle。只有把这些信号放在一起看,才能区分正常处理中的短暂积压、消费者故障和确认链路异常。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

观察消费组进度

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通