Redis Troubleshooting Toolkit
Diagnose OOM and eviction, MISCONF persistence, replication and Sentinel failover, Cluster slot errors, and latency spikes with prompts and Redis runbooks.
Top Redis errors
Start with the most common production issues and troubleshooting paths.
ASK <slot> <host:port>
Fix ASK redirects in Redis Cluster: understand slot migration, ASKING, MOVED vs ASK, client cluster-map refresh, and stuck resh…
BUSY Redis is busy running a script
Fix 'BUSY Redis is busy running a script' errors: lua-time-limit, SCRIPT KILL vs SHUTDOWN NOSAVE, looping Lua, and writing non-…
BUSYGROUP Consumer Group name already exists
Fix BUSYGROUP Consumer Group name already exists in Redis Streams: understand XGROUP CREATE on restart, MKSTREAM, idempotent gr…
CLUSTERDOWN Hash slot not served
Fix CLUSTERDOWN Hash slot not served in Redis Cluster: diagnose unassigned slots, failed masters with no replica, cluster-requi…
Could not connect to Redis ... Connection refused
Fix Could not connect to Redis Connection refused: diagnose a stopped redis-server, wrong host/port, bind and protected-mode co…
Connection reset by peer
Fix Redis 'Connection reset by peer' and broken pipe errors: diagnose client output buffer limits, idle timeouts, TCP keepalive…
CROSSSLOT Keys in request don
Fix CROSSSLOT Keys in request don't hash to the same slot in Redis Cluster: understand slot hashing, hash tags, multi-key comma…
EXECABORT Transaction discarded because of previous errors
Fix EXECABORT errors in Redis MULTI/EXEC: diagnose queued syntax errors, unknown commands, wrong arity, and how it differs from…
Best Redis prompts
Use these prompts to turn symptoms, logs, and config into a structured troubleshooting plan.
Redis ACL and Security Hardening
Harden Redis with ACL users and rules, command renaming, protected-mode, and bind, applying least privilege and closing default-access holes.
Redis Backup and Migration Plan
Plan Redis backups with BGSAVE/RDB, move keys with DUMP/RESTORE and MIGRATE, and sequence safe version upgrades and data migrations.
Redis Caching Strategy Design
Design a Redis caching layer — cache-aside, write-through, write-behind patterns, TTLs, and stampede protection for read-heavy services.
Redis Cluster Sharding Design
Design Redis Cluster sharding — 16384 hash slots, resharding, hash tags, and multi-key operation constraints across shards.
Free Redis tool
Validate, troubleshoot, or analyze your configuration before production changes.
AI Incident Response Assistant
Paste a Redis error, INFO output, or SLOWLOG, get a structured triage plan.
Start triageRedis runbook
Use a repeatable checklist for production troubleshooting.
A first-response checklist for a Redis instance under memory, latency, or replication pressure.
- 1 Check INFO (memory, persistence, replication, clients, stats)
- 2 Review maxmemory and eviction (used_memory vs maxmemory, evicted_keys)
- 3 Inspect SLOWLOG GET and LATENCY DOCTOR for spikes
- 4 Check persistence health (last RDB save, AOF status, disk space)
- 5 Validate replication/cluster (master_link_status, CLUSTER INFO)