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 | 集群槽位范围 | 非集群模式使用会报错 |

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

常见误区是只执行 START 后等待结果。若没有设置 DURATION,就要明确谁负责 STOP;如果实例或客户端不支持该命令,应先核对 Redis 版本和连接节点,而不是把“unknown command”归因于业务流量。
常见问题
HOTKEYS START 能直接告诉我该扩容吗?
不能。它提供热点键的 CPU 或网络观察线索,扩容、拆分键和本地缓存仍要结合请求模型、容量和一致性要求决定。
SAMPLE 越小是不是越准确?
不一定。更密集的采样提高覆盖机会,也提高观察开销;应该按窗口长度和实例余量做灰度调整。
为什么 SLOTS 在单机上失败?
SLOTS 是集群范围筛选参数。单机没有槽位路由边界,去掉 SLOTS,直接选择 CPU 或 NET 指标即可。
-
117 收藏
-
426 收藏
-
171 收藏
-
113 收藏
-
195 收藏
-
484 收藏
-
492 收藏
-
254 收藏
-
406 收藏
-
122 收藏
-
476 收藏
-
181 收藏
-
324 收藏
-
400 收藏
-
285 收藏
-
365 收藏
-
147 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习