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

Redis HOTKEYS START 怎样按 CPU 和网络流量采样热点键

来源:17golang原创

时间:2026-11-19 11:07:32 163浏览 收藏

Redis 的热点键排查,关键不是把采样参数全部打开,而是先决定要观察 CPU、网络,还是两者的占比。HOTKEYS START 负责建立一次热点键跟踪会话:METRICS 选择指标,COUNT 限制返回数量,DURATION 控制窗口,SAMPLE 控制采样比例;只有集群场景才考虑 SLOTS。

官方文档:https://redis.io/docs/latest/commands/hotkeys-start/

要点速览
  • CPU 和 NET 至少选一个,COUNT 决定 Top-K 规模。
  • SAMPLE 越大,采样开销通常越低,但可能漏掉短时热点。
  • GET 读取结果,STOP 停止跟踪并保留数据,RESET 才负责释放资源。

HOTKEYS START 的参数要先分清

这条命令从 Redis 8.6 开始提供热点键跟踪。最小配置要写明指标,例如同时观察 CPU 和网络流量:

# 同时记录 CPU 与网络维度,最多保留 10 个热点键,窗口为 30 秒
redis-cli HOTKEYS START METRICS 2 CPU NET COUNT 10 DURATION 30

# 读取当前跟踪会话的排名与元数据
redis-cli HOTKEYS GET

METRICS 2 CPU NET 表示收集两个指标,不是“采样两次”。COUNT 10 是结果规模;DURATION 30 是自动停止窗口,省得排查脚本忘记收尾。生产环境建议先用短窗口和较小 COUNT,确认结果确实能回答问题后再延长。

参数作用常见边界
METRICS选择 CPU、NET至少指定一个指标
COUNT热点键数量越大结果越宽,不代表更准确
DURATION跟踪持续秒数不填时需手动 STOP
SAMPLE采样比例比例越稀疏,越可能漏短热点
SLOTS集群槽位范围非集群模式使用会报错
Redis HOTKEYS START 的 METRICS、CPU、NET、COUNT、DURATION、SAMPLE 与 SLOTS 参数关系说明图
图1:HOTKEYS START 参数关系说明图,展示采样配置的职责边界,不是终端截图。

CPU、NET 与 SAMPLE 怎么取舍

如果现象是命令执行变慢、脚本消耗 CPU,优先观察 CPU;如果客户端带宽、网络字节或大结果返回异常,优先观察 NET。两者都选适合初次摸底,但结果需要结合业务请求类型解释,不能直接把排名当成根因。

SAMPLE 是性能与覆盖面的取舍。高采样比例会减少跟踪成本,却可能错过持续时间很短的尖峰;低比例更容易捕捉样本,但会给实例带来更多观察开销。排障时可以先用中等比例跑短窗口,只有排名不稳定或怀疑短时峰值时,才逐步增加采样密度。

在 Redis Cluster 中,SLOTS 用于限定要跟踪的槽位:

# 集群中只观察两个槽位;单机实例不要带 SLOTS
redis-cli -c HOTKEYS START METRICS 1 CPU COUNT 10 SAMPLE 4 SLOTS 2 100 200

这能把观察范围收窄到目标分片,但它不是跨节点聚合器。想比较多个分片,应分别建立可辨认的采样记录,再把结果放在同一时间窗口解释。

一次采样要配合 GET、STOP、RESET

把 HOTKEYS 看成一个有状态的跟踪会话更容易操作:HOTKEYS GET 读取当前结果,HOTKEYS STOP 停止跟踪但保留已收集的数据,HOTKEYS RESET 释放跟踪资源并清理结果。不要把 STOP 当成 RESET,否则后续还需要结果时就失去了查看机会。

# 读取排名,用于记录 CPU Top-K 与 NET Top-K
redis-cli HOTKEYS GET
# 停止继续采样,但保留本次结果
redis-cli HOTKEYS STOP
# 确认无需保留后释放跟踪资源
redis-cli HOTKEYS RESET
Redis HOTKEYS 跟踪会话与 HOTKEYS GET、STOP、RESET 结果管理关系说明图
图2:HOTKEYS 会话关系结构图,展示 GET、STOP、RESET 的职责,不是运行结果截图。

常见误区是只执行 START 后等待结果。若没有设置 DURATION,就要明确谁负责 STOP;如果实例或客户端不支持该命令,应先核对 Redis 版本和连接节点,而不是把“unknown command”归因于业务流量。

常见问题

HOTKEYS START 能直接告诉我该扩容吗?

不能。它提供热点键的 CPU 或网络观察线索,扩容、拆分键和本地缓存仍要结合请求模型、容量和一致性要求决定。

SAMPLE 越小是不是越准确?

不一定。更密集的采样提高覆盖机会,也提高观察开销;应该按窗口长度和实例余量做灰度调整。

为什么 SLOTS 在单机上失败?

SLOTS 是集群范围筛选参数。单机没有槽位路由边界,去掉 SLOTS,直接选择 CPU 或 NET 指标即可。

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