Redis 与缓存 / 系统课时
观察消费组进度
观察消费组进度
本课解决一个实际问题:消息流已经运行后,如何判断消费组有哪些消费者、还有多少待处理消息,以及消费进度是否正在前进。掌握几条观测命令后,就能把“感觉消费正常”变成可验证的状态判断。
学习目标
- 能使用
XINFO GROUPS和XINFO CONSUMERS查看消费组及消费者状态 - 能使用
XPENDING判断待处理消息数量、范围和消费者分布 - 能结合
last-delivered-id、pending 等指标定位消费停滞
查看消费组整体进度
消费组的整体状态首先看 XINFO GROUPS。它能看到组名、消费者数量、pending 数量以及组最近投递到哪里等信息。下面创建一个最小实验,并让消费者读取部分消息但暂不确认。
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预期结果
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 可以把组级状态拆到单个消费者。排查“是整个消费组变慢,还是某一个消费者积压”时,这一步尤其重要。
redis-cli XINFO CONSUMERS orders order-workers预期结果
1) 1) "name"
2) "worker-1"
3) "pending"
4) "<PENDING_COUNT>"
5) "idle"
6) "<IDLE_MS>"其中 pending 用来判断该消费者当前负责、但还没有确认的消息量;idle 表示自该消费者最近一次相关活动以来经过的时间。具体输出字段可能因 Redis 版本不同而不同,因此生产环境脚本应按字段名解析,而不是假设固定位置。
观察多个消费者时,可以把它们分成两类:一个消费者 pending 明显更高,通常优先检查该实例的处理速度、异常和确认逻辑;所有消费者 pending 都高,则更应检查下游处理能力、批量大小或整体消费吞吐。
查看待处理消息明细
组级和消费者级信息仍然不够时,用 XPENDING 查看 pending 范围。它可以先给出汇总,再进一步列出具体消息及所属消费者。
redis-cli XPENDING orders order-workers
redis-cli XPENDING orders order-workers - + 10预期结果
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。只有把这些信号放在一起看,才能区分正常处理中的短暂积压、消费者故障和确认链路异常。