LATENCY HISTOGRAM · Valkey

LATENCY HISTOGRAM

Returns the cumulative distribution of latencies of a subset or all commands.

Usage

LATENCY HISTOGRAM COMMAND [COMMAND…]

Description

LATENCY HISTOGRAM returns a cumulative distribution of commands’ latencies in histogram format.

By default, all available latency histograms are returned. You can filter the reply by providing specific command names.

Each histogram consists of the following fields:

This command requires the extended latency monitoring feature to be enabled, which is the default. If you need to enable it, call CONFIG SET latency-tracking yes.

To delete the latency histograms’ data use the CONFIG RESETSTAT command.

Reply RESP2

Array reply: a map where each key is a command name, and each value is a map with the total calls, and an inner map of the histogram time buckets.

Reply RESP3

Map reply: a map where each key is a command name, and each value is a map with the total calls, and an inner map of the histogram time buckets.

Complexity

O(N) where N is the number of commands with latency information being retrieved.

ACL Categories

@admin @dangerous @slow

Examples

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

History

See also

ACL, ACL CAT, ACL DELUSER, ACL DRYRUN, ACL GENPASS, ACL GETUSER, ACL HELP, ACL LIST, ACL LOAD, ACL LOG, ACL SAVE, ACL SETUSER, ACL USERS, ACL WHOAMI, BGREWRITEAOF, BGSAVE, COMMAND, COMMAND COUNT, COMMAND DOCS, COMMAND GETKEYS, COMMAND GETKEYSANDFLAGS, COMMAND HELP, COMMAND INFO, COMMAND LIST, CONFIG, CONFIG GET, CONFIG HELP, CONFIG RESETSTAT, CONFIG REWRITE, CONFIG SET, DBSIZE, DEBUG, FAILOVER, FLUSHALL, FLUSHDB, INFO, LASTSAVE, LATENCY, LATENCY DOCTOR, LATENCY GRAPH, LATENCY HELP, LATENCY HISTORY, LATENCY LATEST, LATENCY RESET, LOLWUT, MEMORY, MEMORY DOCTOR, MEMORY HELP, MEMORY MALLOC-STATS, MEMORY PURGE, MEMORY STATS, MEMORY USAGE, MODULE, MODULE HELP, MODULE LIST, MODULE LOAD, MODULE LOADEX, MODULE UNLOAD, MONITOR, PSYNC, REPLCONF, REPLICAOF, RESTORE-ASKING, ROLE, SAVE, SHUTDOWN, SLOWLOG, SLOWLOG GET, SLOWLOG HELP, SLOWLOG LEN, SLOWLOG RESET, SWAPDB, SYNC, TIME.