Redis 与缓存 / 系统课时

查看客户端连接

查看客户端连接

本课解决 Redis 连接异常难以定位的问题。你将使用 CLIENT LIST 查看连接来源、账号、空闲时间、阻塞标志和缓冲区状态,并据此识别连接泄漏、阻塞客户端和慢消费连接。

学习目标

  • 掌握 CLIENT LIST 的使用方法
  • 理解常用客户端字段与标志
  • 按风险从连接清单中定位异常客户端

查看当前连接

CLIENT LIST 返回当前客户端会话,每行代表一条连接。生产环境建议使用只读监控账号,并优先查看普通客户端,避免把复制和 Pub/Sub 连接与业务连接混在一起。

bash
redis-cli --user monitor-user --askpass CLIENT LIST TYPE normal

预期输出示例(省略交互式密码提示,动态值以实际实例为准):

text
id=<ID> addr=10.0.2.21:<CLIENT_PORT> laddr=10.0.2.15:6379 name=order-service age=<SECONDS> idle=<SECONDS> flags=N db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-free=<BYTES> obl=0 oll=0 omem=0 events=r cmd=get user=order-app resp=2

Redis 版本不同,字段可能增加或调整。分析时应保留原始行,不要只截取 addr 和 cmd,否则容易遗漏用户、缓冲区和阻塞标志。

读懂关键字段

addr 是客户端来源地址,laddr 是 Redis 接收连接的本地地址。name 来自客户端设置的连接名称,建议应用在连接池初始化时设置,便于区分服务和实例。

age 表示连接存活时间,idle 表示距离最近一次命令的秒数。大量长时间空闲连接不一定是泄漏,也可能是连接池保留;应与每个应用实例的池大小和最小空闲连接配置对比。

user 显示当前 ACL 用户,cmd 是最近执行的命令。阻塞客户端通常通过 flags 中的 b 识别,cmd 可能显示 blpop、xread 等阻塞命令,而不是固定值 blocked。

关注缓冲区和阻塞状态

qbuf 是查询缓冲区当前大小,omem 是输出缓冲区内存。两者持续偏大可能表示客户端发送过快、读取过慢或网络拥塞,需要结合 CLIENT INFO、应用日志和网络指标继续判断。

flags=b 的连接可能是正常的阻塞队列消费者,也可能因为超时和消费逻辑异常长期占用。不能看到阻塞标志就直接断开,应先确认命令、客户端名称和业务用途。

Pub/Sub、复制和监控连接有不同类型与标志。若需要分别查看,可使用 CLIENT LIST TYPE pubsub、CLIENT LIST TYPE replica 等方式;支持的类型名称应以当前 Redis 版本为准。

定位连接泄漏

连接泄漏通常表现为 connected_clients 持续增长,且来源地址、用户或客户端名称集中在同一服务。排查时应把 CLIENT LIST 与 INFO clients、应用实例数和连接池上限一起对照。

发现可疑连接后,先记录 id、addr、name、user、age、idle、flags 和 omem,再回到对应应用检查连接是否归还、超时设置是否合理,以及发布过程中是否遗留旧实例。

只有在确认连接无效并评估影响后,才应由授权运维账号使用 CLIENT KILL ID <ID> 断开。不要按来源地址批量清理,避免误伤同一主机上的正常连接。

提升后续可观测性

应用应为连接设置稳定名称,并为不同服务使用独立 ACL 用户。这样出现连接数异常时,可以直接按 name 和 user 归属,而不必只依赖容易变化的客户端端口。

日常监控还应记录总连接数、拒绝连接数、阻塞客户端数和输出缓冲区异常。CLIENT LIST 更适合现场定位,不应替代持续监控与趋势告警。

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

目录与阅读设置

阅读设置

17

记录一个想法

查看客户端连接

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

登录哪都通