Redis Cluster Slot Distribution

Paste CLUSTER NODES output to see the slot share per primary, the deviation from an even split, and any unassigned ranges. Useful before and after a rebalance.

Paste below, or drop a file anywhere on this panel

Or drop a file anywhere on this panel. Nothing is uploaded: the analysis runs in this tab.

The answer appears here

Paste on the left and press Show. Nothing leaves this tab.

Examples

Real input you can load into the tool above. Each one shows a different thing going wrong, because that is what the tool is for.

An uneven split

One primary holding most of the slots, and how far from even that is

a1b2c3d 10.0.0.1:6379@16379 myself,master - 0 0 1 connected 0-15000
e4f5a6b 10.0.0.2:6379@16379 master - 0 0 2 connected 15001-16383

An even split

What a rebalanced cluster looks like, which is still not proof of even load

a1b2c3d 10.0.0.1:6379@16379 myself,master - 0 0 1 connected 0-8191
e4f5a6b 10.0.0.2:6379@16379 master - 0 0 2 connected 8192-16383

Common mistakes

These are the ones that fail silently. The config is accepted, nothing raises an error, and the consequence arrives later.

  1. Rebalancing slots to fix uneven memory

    Slots are not keys and not bytes. One slot can hold one small string or a hash with millions of fields, so two nodes with identical slot counts can differ by an order of magnitude.

    Instead:Compare used_memory per node from INFO first, then decide whether slot movement is the right lever.

  2. Adding a node and expecting it to take traffic

    A new primary joins with zero slots and stays idle until slots are moved to it. It is not a load balancer pool.

    Instead:Run redis-cli --cluster rebalance after adding, during a quiet period.

An even slot split is not an even load

Slots are the unit of assignment, not the unit of work. Evening them out is necessary and nowhere near sufficient, which is why a rebalanced cluster can still have one node at capacity.

Keys are not spread evenly across slots

CRC16 distributes random key names well, and real key names are not random. A hash tag concentrates every key sharing that tag into one slot by design, so a tag used by a large tenant puts all of that tenant's data on one node. No amount of rebalancing moves it, because moving the slot moves all of it together.

Slot count is not data size either

One slot can hold a single small string or a hash with millions of fields. Two nodes with an identical slot count can differ by an order of magnitude in memory, and the slot count will keep looking correct throughout.

Rebalancing moves data

redis-cli --cluster rebalance migrates keys slot by slot while the cluster serves traffic. It is safe and it is not free: it costs network, CPU and a stream of ASK redirects during the move. Doing it during peak traffic to fix a problem that appeared during peak traffic tends to make the peak worse first.

Adding a node does nothing on its own

A new primary joins with zero slots and stays idle until slots are moved to it. This surprises people who expect joining a cluster to be like joining a load balancer pool.

What this cannot see

It counts slots. It cannot see how many keys are in each, how much memory each node uses, or where the traffic goes. The slot count is the only part of the picture visible from CLUSTER NODES, and it is the least informative part of it. Compare with used_memory per node from INFO before deciding anything.

More redis tools

Redis Hash Slot Calculator Which of the 16,384 slots does this key land in? Redis Hash Tag Tester Will these keys survive a multi-key command? Redis RESP Protocol Decoder Read what the server actually sent Redis RESP2 vs RESP3 Reply Decoder What the same reply looks like on each protocol Redis Command to RESP Exactly what your client puts on the socket Redis Glob Pattern Tester Redis globs are not shell globs Redis Connection URL Parser The path is the database number Redis Memory Unit Converter 1g and 1gb are not the same number Redis TTL Converter -1 and -2 are not durations Redis Stream ID Parser The first half is a millisecond timestamp redis.conf Validator Will Redis start with this file? Redis Production Config Linter The settings that cause incidents redis.conf to CONFIG SET Which of these can you change without a restart? Redis ACL Rule Decoder What does this user actually get? Redis ACL Validator Find the rule that does nothing Redis INFO Analyzer The numbers INFO does not print Redis SLOWLOG Analyzer What blocked everyone else Redis CLUSTER NODES Parser Read the topology, and find the gap Redis Keyspace Notification Flags Why your events never arrive Redis Memory Calculator The encoding decides, not the data Redis Key Count to Memory The fixed cost per key Redis Encoding Threshold Calculator One field more, several times the memory Redis Bitmap Memory Calculator Sized by the highest bit, not the set ones Redis HyperLogLog Calculator 12 KB whether you count a thousand or a billion Redis Cluster Sizing Only 60% of each node is usable Redis RDB and AOF Size Calculator The fork needs memory, not disk Redis Replication Bandwidth Calculator How long the backlog actually covers Redis Connection Pool Calculator More connections is not more throughput Redis Pipeline Calculator It removes round trips, not work Redis Cache Hit Rate Calculator 99% to 90% is ten times the backend load Redis Eviction Policy Simulator volatile- with no TTLs is noeviction Redis Cost Estimator Your rates, so nothing goes stale Redis Config File Generator A redis.conf with the reasons in it Redis ACL Generator A user that can do exactly one job Redis Maxmemory Config Generator The limit, and the headroom it needs Redis Persistence Config Generator How much you can afford to lose Redis Lua Script Generator Atomic, and short enough to stay that way Redis TLS Config Generator Encrypted, and the old port actually closed Redis Sentinel Config Generator Failover that can actually be authorised Redis Cluster Config Generator Three primaries, and the bus port open Redis Docker Compose Generator Local Redis that is not on the internet Redis Client Config Generator Timeouts on both sides, and a sane pool Redis MEMORY STATS Analyzer Which number actually matters Redis Bigkeys Output Analyzer Elements are not bytes Redis CLIENT LIST Analyzer Find the connection hurting you Redis LATENCY Report Analyzer An empty report may mean nothing was recorded Redis Keyspace Prefix Analyzer Which key family is growing Redis SET Command Builder A plain SET clears the TTL Redis ZRANGE Query Builder REV reverses the argument order Redis SCAN Iteration Planner COUNT is a hint, not a page size Redis Key Name Validator Legal is not the same as workable Redis Cluster Compatibility Checker Works now, breaks when you shard

Elsewhere on the site