Redis如何查热点Key？hotkeys扫描访问频率

Redis 的 `redis-cli --hotkeys` 是一种轻量级热 Key 发现工具，依赖 LFU 内存策略（需配置为 `allkeys-lfu` 或 `volatile-lfu`）进行概率采样，仅返回当前活跃窗口内相对访问频率最高的最多 32 个 key，其 frequency 值是归一化、非实时、带时间衰减的估算结果，并非精确计数；它不能替代监控，也不适用于低流量或写多读少场景，真正定位热 Key 必须结合 `object freq` 查看 LFU 计数、`monitor` 实时抓取命令流，并辅以 `object idletime` 判断持续性——理解它的机制与局限，才能避免误判，让热 Key 分析从“碰运气”变成可验证、可复盘的有效运维手段。

Redis 4.0.3+ 版本中，redis-cli --hotkeys 是最轻量、最直接的热 Key 发现方式，但它不是“查所有 key 的访问次数”，而是基于 LFU 内部采样机制返回当前统计周期内**访问频次相对最高的若干个 key**。能否用好它，关键在配置和理解它的局限性。

必须开启 LFU 回收策略才能启用 --hotkeys

redis-cli --hotkeys 不是独立功能，它依赖 Redis 实例已启用 LFU 相关内存管理逻辑。如果 maxmemory-policy 没设为 allkeys-lfu 或 volatile-lfu，执行该命令会报错或返回空结果。

• 检查当前策略：redis-cli config get maxmemory-policy
• 临时启用（需有 config 权限）：redis-cli config set maxmemory-policy allkeys-lfu
• 注意：仅设置策略还不够，实例必须实际触发过 LFU 计数更新——即至少有部分 key 被访问过，且 LRU_BITS 字段已被用于 LFU 模式

--hotkeys 的输出不是实时精确计数，而是概率采样结果

它背后调用的是 Redis 内置的 LFU Counter 采样器，每分钟对 counter 值衰减一半，并用对数概率方式递增（LFULogIncr 函数）。这意味着：

• 输出的 “frequency” 列是归一化后的相对值，不能直接当 QPS 看
• 默认只返回最多 32 个 key（由 LFU_HOTKEYS_MAX 定义），高频但排不进前 32 的会被忽略
• 刚启动或低流量实例可能长时间无输出——因为 LFU counter 需要一定访问积累才“激活”
• 若业务写入密集但读取稀疏，--hotkeys 可能完全不反映真实热点（它只统计读/写命令触发的访问，但更偏重 GET 类操作）

配合 redis-cli monitor 和 object freq 才能交叉验证

--hotkeys 给的是“候选名单”，真正确认是否为热 key，得靠组合验证：

• 对疑似 key 执行：redis-cli object freq —— 返回当前 LFU counter 值（0–255），数值越接近 255 越热
• 短时抓包验证：redis-cli monitor | grep -E "(GET|HGET|SMEMBERS) "，看单位时间命中密度
• 避免误判：某些 key 可能因批量脚本一次性扫出高 counter，但业务上并不持续——需结合 object idletime 看最近空闲时长

LFU 的 counter 是带时间衰减的，哪怕一个 key 昨天很热，今天零访问，一两天后它的 counter 就会掉到很低。所以 --hotkeys 结果永远只能反映“最近活跃窗口”内的相对热度，而不是绝对意义上的长期热点。别把它当监控指标直接上告警，更适合做人工巡检或问题复盘的起点。

今天关于《Redis如何查热点Key？hotkeys扫描访问频率》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！