CLUSTER SLOT-STATS
CLUSTER SLOT-STATS <SLOTSRANGE start-slot end-slot | ORDERBY metric [LIMIT limit] [ASC | DESC]>
- Available since:
- Redis Open Source 8.2.0
- Time complexity:
- O(N) where N is the total number of slots based on arguments. O(N*log(N)) with ORDERBY subcommand.
Use this command to get an array of slot usage statistics for the slots assigned to the current shard. If you're working with a Redis cluster, this data helps you understand overall slot usage, spot hot or cold slots, plan slot migrations to balance load, or refine your application logic to better distribute keys.
Options
CLUSTER SLOT-STATS
has two mutually exclusive options:
-
ORDERBY
: Sorts the slot statistics by the specified metric. Use ASC or DESC to sort in ascending or descending order. If multiple slots have the same value, the command uses the slot number as a tiebreaker, sorted in ascending order. -
SLOTSRANGE
: Limits the results to a specific, inclusive range of slots. Results are always sorted by slot number in ascending order.
The command reports on the following statistics:
KEY-COUNT
: Number of keys stored in the slot.CPU-USEC
: CPU time (in microseconds) spent handling the slot.NETWORK-BYTES-IN
: Total inbound network traffic (in bytes) received by the slot.NETWORK-BYTES-OUT
: Total outbound network traffic (in bytes) sent from the slot.
Return information
One of the following:
- Array reply: a nested list of slot usage statistics.
- Simple error otherwise.