登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  数据库 >  Redis

Redis LATENCY RESET 为什么会清空延迟事件记录

来源:17golang原创

时间:2026-11-19 11:42:56 126浏览 收藏

我在排查 Redis 延迟时,常会先把一段旧的延迟记录清掉,再观察新的尖峰是否还会出现。LATENCY RESET 做的正是这件事:它重置延迟监控框架中的事件时间序列,不会直接修复造成延迟的命令、网络或磁盘问题。

官方地址:https://redis.io/docs/latest/commands/latency-reset/

要点速览
  • 不带事件名时清理全部事件,并重置最大事件时间记录。
  • 带一个或多个事件名时,只清理指定事件的时间序列。
  • 返回整数表示被重置的事件时间序列数量,不代表延迟已经恢复。

先分清 LATENCY RESET 清理的是什么

Redis 记录的是延迟尖峰事件的时间序列。LATENCY RESET 清理这些观测数据;它不删除业务键,也不重启 Redis,更不会改变触发延迟的配置。命令时间复杂度是 O(1),权限类别包含 @admin、@slow 和 @dangerous,所以生产环境应把它当成有影响的运维动作。

Redis LATENCY RESET 全量清理与按事件清理的时间序列范围说明图
图1:LATENCY RESET 的清理范围说明图,区分全部事件与指定事件,不是终端截图。

不带参数和带事件名是两种范围

不带参数时,命令会丢弃当前记录的延迟尖峰事件,并重置最大事件时间寄存器;带事件名时只处理列出的事件。事件名可以重复传入多个,具体名称应来自 Redis 延迟监控框架支持的事件集合。

# 全量清理延迟事件,适合开始一轮全新的观测窗口
redis-cli LATENCY RESET

# 只清理 command 事件,保留其他事件的观测记录
redis-cli LATENCY RESET command

# 同时清理多个指定事件,事件名之间用空格分隔
redis-cli LATENCY RESET command fork

我更倾向于在排障记录里写清楚清理范围:如果只是想重新观察命令延迟,就不要顺手把 fork、eviction-cycle 等其他事件一起清掉。

返回值只说明清理数量

命令返回一个整数,表示被重置的事件时间序列数量。这个数字适合做操作记录,但不能解读成“当前延迟为零”或“根因已经消失”。重置之后,下一次新的延迟尖峰才会重新写入观测窗口。

# 只记录返回数量,不把它误当成延迟修复结果
redis-cli LATENCY RESET command

# 若需要继续分析趋势,应在新的观测窗口里重新读取事件历史
redis-cli LATENCY HISTORY command
命令职责不能替代什么
LATENCY RESET清理全部或指定事件记录不能修复延迟根因
LATENCY HISTORY读取某事件的历史序列不能清理记录
LATENCY DOCTOR读取延迟诊断建议不能把旧记录变成新数据
Redis LATENCY RESET 与 LATENCY HISTORY、LATENCY DOCTOR 的观测职责边界结构图
图2:清理、历史读取与诊断建议的职责边界结构图,不代表真实运行结果。

什么时候不应该直接全量重置

如果你还没有记录现有尖峰的事件名、时间和相关指标,直接执行无参数重置会让旧观测窗口消失。更稳妥的顺序是先读取需要保留的历史,再决定按事件清理;如果目标只是判断新一轮是否出现尖峰,也要把重置时刻写进排障日志,避免把前后两个窗口混在一起。

另外,LATENCY RESET 不提供“撤销”操作。已经丢弃的时间序列不能靠再次执行同一命令恢复,只能等待新的事件重新采样。

常见问题

LATENCY RESET 会让 Redis 变快吗?

不会。它只清理延迟监控数据,业务命令、网络和持久化造成的延迟仍可能继续出现。

为什么按事件名重置后返回数量可能是零?

可能是该事件当前没有已记录的时间序列,或事件名不对应当前可用的延迟事件。应先结合官方事件名称和历史查询判断。

全量重置后还能看到旧的延迟历史吗?

不能。全量调用会丢弃当前延迟尖峰记录;之后读取到的是新的观测窗口。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>