首页/数据/Redis 进阶速查/CLIENT INFO 单连接详情
性能与排障129 条

CLIENT INFO 单连接详情

CLIENT INFO 返回当前连接的详细信息,客户端在报错时带上它,服务端排查时能看到该连接的完整状态。

Redis 进阶速查数据更新于 2026-10-13

单连接详情怎么读

CLIENT INFO 返回当前连接的详细信息,字段与 CLIENT LIST 中的单个条目一致,包含连接地址、空闲时长、协议版本、输入输出缓冲用量等。它的实用之处在于:客户端报错时把这个输出一起带上,服务端排查的人不必反复询问连接处于什么状态,很多线索在字段里直接可见。

基本信息

命令CLIENT INFO
观测口径只返回执行该命令的连接自身
字段构成与 CLIENT LIST 的单个条目一致
关键字段连接地址、空闲时长、协议、输入输出缓冲
适用场景客户端报错时附带输出,缩短排查往返

典型使用场景

  • 故障上报:把输出附在工单里,服务端能直接看到连接状态
  • 缓冲排查:输出缓冲用量异常说明客户端读取偏慢
  • 协议确认:核对该连接实际使用的协议版本
  • 属性核对:确认标记类命令(如免驱逐)是否已经生效
  • 多连接定位:先确认自身状态,再用列表或 ID 查其他连接
  • 复现辅助:把输出与实际操作时间一起记录,便于事后比对字段变化

配套查询

配套查询
redis-cli CLIENT INFO                      # 当前交互连接的详情
redis-cli CLIENT LIST | head -5            # 多个连接的概览
redis-cli CLIENT LIST ID <id>              # 按连接 ID 查指定连接
redis-cli INFO clients | grep -E 'client_recent_max_(in|out)put_buffer'
redis-cli --latency                       # 怀疑延迟时配合确认

关键字段读法

字段含义异常信号
addr 与 laddr对端与本端地址来源分布异常时核对网络路径
idle连接空闲时长长时间空闲的连接可能已被中间设备回收
resp协议版本与客户端预期不符要查 SDK 配置
输出缓冲待发送的数据量持续偏高说明客户端读取慢
客户端 SDK 报错日志里附上这段输出,能省下多轮来回沟通;字段本身就把连接状态讲清楚了,不必靠猜测复现。
它只能看到当前这一条连接:定位其他连接要用 CLIENT LIST 或按 ID 查询,忽略这点容易得出「服务端只有一条连接」的错误印象。

易错点

  • 只能看当前连接:定位其他连接要用列表或按 ID 查询
  • 忽略缓冲字段:异常连接的特征往往就藏在输入输出缓冲用量里
  • 不看协议字段:RESP2 与 RESP3 的行为差异会让结论对不上
  • 报错时不附输出:来回沟通多轮,排查成本成倍上升

数据来源与参考

  • Redis 官方文档:CLIENT INFO 说明
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌