HOTKEYS START

开始热键跟踪。

语法

HOTKEYS START METRICS count [CPU] [NET] [COUNT k] [DURATION seconds] [SAMPLE ratio] [SLOTS count slot [slot ...]]

引入版本：8.6.0

复杂度摘要：O(1)

开始使用指定指标进行热键跟踪。

此命令启动热键跟踪会话。您必须使用所需的 METRICS 参数指定要跟踪的指标。如果跟踪会话已在进行中，则会返回错误。

跟踪会话将继续，直到使用 HOTKEYS STOP 手动停止或在指定的持续时间后自动停止。

必需参数

METRICS count [CPU] [NET]

必填。 指定要跟踪哪些指标以及要跟踪的热键数量。

• count - 要收集的指标数量（必需）。
• CPU - 按 CPU 时间百分比跟踪热键（可选）。
• NET - 按网络字节百分比跟踪热键（可选）。

必须至少指定CPU 或NET 之一。

可选参数

COUNT

指定前 K 个热键跟踪的 K 值。

DURATION

热键跟踪应运行的持续时间（以秒为单位）。此时间段过后，跟踪将自动停止。如果未指定，跟踪将继续，直到使用 HOTKEYS STOP 手动停止。

SAMPLE

概率跟踪的采样率。每个键均以 1/ratio 的概率进行采样。较高的值会降低性能影响，但可能会错过一些热键。较低的值提供更准确的结果，但性能成本更高。

SLOTS

指定在集群环境中跟踪哪些哈希槽。进行计数，然后跟随多个插槽编号。只会跟踪哈希到指定槽的键。对于跟踪 Redis 集群中特定分片上的热键很有用。不在集群模式下使用 SLOTS 将导致错误。

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
✅ 标准 ✅ 主动-主动	✅ 标准 ✅ 主动-主动

返回值

RESP2

以下之一：

• 简单字符串回复：跟踪成功启动时回复OK。
• 错误回复：当提供无效参数时。

RESP3

以下之一：

• 简单字符串回复：跟踪成功启动时回复OK。
• 错误回复：当提供无效参数时。

资料来源：Redis 官方 HOTKEYS START 文档；中文内容参考 Redis 文档许可。