首页/数据/Redis 进阶速查/redis-cli --latency-history 长观测
性能与排障129 条

redis-cli --latency-history 长观测

redis-cli --latency-history 按时间窗滚动输出延迟的 min/avg/max 序列(默认窗口约 15 秒),适合长时间观察波动。

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

长观测怎么用

redis-cli --latency-history 按时间窗滚动输出延迟的 min、avg、max 序列,默认窗口约 15 秒,适合长时间挂在排查机上观察抖动规律。相比单次测量只给一个数字,它给出的是时间线,能看出延迟是否周期性出现、是否与某个定时任务同期。窗口间隔可以用 -i 参数调整。

基本信息

命令redis-cli --latency-history
默认窗口约 15 秒滚动输出一次
输出内容每个窗口的 min、avg、max
窗口调整用 -i 指定间隔秒数
适用场景长时间观察抖动,与业务窗口对照

典型使用场景

  • 周期性抖动:把时间标记与定时任务、批处理窗口对齐
  • 变更验证:调整前后各跑一段,比较同一窗口的 max 变化
  • 客户端侧基线:在业务机上跑,数字包含网络与客户端开销
  • 多机对比:不同客户端机器同时观测,区分本机问题与实例问题
  • 压测配合:压测窗口开着它,看延迟随时间的变化
  • 空闲对照:业务低峰期也保留观测,才能区分常态抖动与故障抖动

不同窗口的用法

不同窗口的用法
redis-cli --latency-history -i 15      # 默认窗口,长时间观察
redis-cli --latency-history -i 5       # 缩小窗口,看更细的波动
redis-cli --latency-history -i 60      # 放大窗口,看整体趋势
redis-cli --latency                    # 单值视图,min/avg/max 持续刷新
redis-cli -h 10.0.0.12 -p 6379 --latency-history -i 15   # 从业务机观测目标实例

读数要点

列含义用法
min窗口内最快一次往返反映网络与客户端的最优状态
avg窗口内平均往返整体趋势以此为准
max窗口内最慢一次往返与 avg 差距大说明存在抖动
时间标记窗口结束时间与业务事件时间轴对齐
把它挂在排查机上跑一段时间,抖动规律比单点数字更有信息;窗口开得太小会把噪声当规律,太大又会平滑掉有价值的尖峰。
多台机器同时高频观测会互相干扰结论:观测点越多,各自本机负载差异越明显,报告里要写明观测位置与并发情况。

易错点

  • 观测窗口过短:周期性问题恰好被错过,或把噪声当成规律
  • 多台机器同时高频观测:观测行为本身干扰结论,数据互相污染
  • 只看单次运行结果:抖动需要时间序列,单点数字说明不了稳定性
  • 不记录观测位置:客户端侧数字包含网络与客户端开销,来源不同结论也不同

数据来源与参考

  • Redis 官方文档:redis-cli 延迟选项
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌