LATENCY HISTOGRAM

返回子集或所有命令的延迟累积分布。

语法

LATENCY HISTOGRAM [command [command ...]]

引入版本：7.0.0

复杂度摘要：O(N)

LATENCY HISTOGRAM 以直方图格式返回命令延迟的累积分布。

默认情况下，返回所有可用的延迟直方图。您可以通过提供特定的命令名称来过滤回复。

每个直方图由以下字段组成：

• 命令名称
• 该命令的总调用量
• 时间桶图：
• 每个桶代表一个延迟范围
• 每个桶覆盖前一个桶范围的两倍
• 回复中排除空桶
• 跟踪的延迟在 1 纳秒到大约 1 秒之间
• 超过 1 秒的所有内容都被视为 +Inf
• 最多有 log2(1,000,000,000) = 30 个桶

此命令需要启用扩展延迟监控功能，这是默认设置。如果需要启用它，请调用CONFIG SET latency-tracking yes。

要删除延迟直方图数据，请使用 CONFIG RESETSTAT 命令。

可选参数

command [command ...]

用于返回延迟直方图的一个或多个命令名称。如果省略，则返回所有命令的直方图。

示例

127.0.0.1:6379> LATENCY HISTOGRAM set
1# "set" =>
   1# "calls" => (integer) 100000
   2# "histogram_usec" =>
      1# (integer) 1 => (integer) 99583
      2# (integer) 2 => (integer) 99852
      3# (integer) 4 => (integer) 99914
      4# (integer) 8 => (integer) 99940
      5# (integer) 16 => (integer) 99968
      6# (integer) 33 => (integer) 100000

Redis Software 与 Redis Cloud 兼容性

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

返回值

RESP2

数组回复：一个映射，其中每个键是命令名称，每个值是包含总调用的映射，以及直方图时间桶的内部映射。

RESP3

地图回复：一个映射，其中每个键是命令名称，每个值是包含总调用的映射，以及直方图时间桶的内部映射。

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