Upstash Redis Slow or Timing Out

How to fix it

// try these in order, the most common fix is first

1. FIX 1Co-locate the database

   Copy steps
   1. 01Check the database region in the Console
   2. 02Create a new database in your compute region (Vercel function region, Fly primary region) and migrate
   3. 03For global apps, add read regions close to users (note: writes bill per region)
   Did this fix it? Yes No

2. FIX 2Cut round trips

   Copy steps
   1. 01Use redis.pipeline() or auto-pipelining in @upstash/redis
   2. 02Replace many GETs with MGET
   3. 03Use Lua scripts for multi-step logic
   Did this fix it? Yes No

3. FIX 3Measure

   Copy steps
   1. 01From the app host run redis-cli --tls -u $REDIS_URL --latency-history
   2. 02Compare against a second database to rule out a bad instance
   Did this fix it? Yes No

4. FIX 4Check for incidents and throttling

   Copy steps
   1. 01Open status.upstash.com for your region
   2. 02Look at the Console's throughput chart for hits on the commands/sec cap; move to a larger fixed plan if so
   Did this fix it? Yes No

5. FIX 5Avoid blocking commands

   Copy steps
   1. 01Replace KEYS with SCAN
   2. 02Avoid huge HGETALL/SMEMBERS on big keys
   Did this fix it? Yes No

Symptoms

Commands that should take a few ms take 100-500ms+, 'could not send HTTP request to instance: connection error: timed out' on Fly.io, rate limiter returns success with reason 'timeout', intermittent 504s.

Why it happens

• C-01Database region far from the app's region
• C-02One HTTP round trip per command instead of pipelines
• C-03Throttling after hitting the commands-per-second limit (10K or 16K/sec)
• C-04Regional incidents (us-east-1, eu-west-1, Fly iad have had latency incidents)
• C-05Blocking commands like KEYS on large datasets

// this guide also covers

• upstash redis slow
• upstash high latency
• upstash redis timeout
• upstash redis timed out fly.io

The same problem in other apps

All not loading, error messages & connection guides →

• Redis Cloud Connection Timeout (Redis Cloud)
• Pinecone 429 Too Many Requests Error (Pinecone)

Other Upstash errors

• Upstash ERR Max Requests Limit Exceeded
• Upstash ERR Max Request Size Exceeded
• Upstash Redis ECONNRESET Error
• Upstash WRONGPASS Invalid or Missing Auth Token
• Upstash ERR Max Concurrent Connections Exceeded
• Upstash Free Database Archived or Deleted
• QStash Signature Verification Failed (Invalid Signature)
• Upstash Ratelimit Not Working