redis-cli --hotkeys 是基于 lfu 采样的轻量热 key 发现工具，需启用 allkeys-lfu/volatile-lfu 策略，返回最多 32 个相对高频 key，frequency 为归一化值，非实时精确计数，须结合 object freq、monitor 等交叉验证。

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 函数）。这意味着：

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

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

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

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

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

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