*Redis LATENCY RESET 命令

LATENCY RESET 用于重置一个或多个被监控事件的延迟历史数据和最大延迟记录。


*语法

LATENCY RESET [event ...]

*参数说明

参数 类型 必填 说明
event String 要重置的事件名称;省略时重置所有已监控事件

*返回值

  • Integer:成功重置的事件数量
  • 0:指定的事件不存在或无可重置的数据

*时间复杂度

O(1)

*

*示例

*重置所有事件

> LATENCY RESET
(integer) 3

*重置指定事件

> LATENCY RESET command
(integer) 1

*重置多个事件

> LATENCY RESET command fork aof-write
(integer) 3

*常见错误

错误 原因 解决
ERR No such latency event 指定的事件不存在 先用 LATENCY LATEST 确认有效事件名
ERR wrong number of arguments 参数异常 检查是否有非法字符

*最佳实践

  • 在性能测试或基准测试开始前执行,排除历史数据干扰
  • 排查完一次延迟毛刺后重置,便于观察下一次峰值
  • 可放入运维脚本中定期执行(如每日凌晨),保持监控基线清晰
  • 注意不要过度频繁重置,以免丢失有价值的长期趋势数据

*FAQ

Q1: 不指定事件名会重置什么? A: 不带任何参数时,LATENCY RESET 会重置所有当前被监控的事件。

Q2: 重置后 LATENCY HISTORY 会怎样? A: 对应事件的历史采样数组会被清空,LATENCY LATEST 中该事件的最大延迟也会归零或消失。

Q3: 可以重置尚未发生的事件吗? A: 指定不存在的事件会返回错误;建议先查询 LATENCY LATEST 确认有效事件列表后再操作。