Redis Key Explorer
Search, inspect, and safely manage non-BullMQ Redis keys in the selected connection.
Route Scope
Redis explorer route:
/$orgSlug/c/$connectionId/redis-keys
Search Behavior
Key search endpoint:
GET /api/c/:connectionId/redis-keys/search
Features:
- pattern search (
*by default) - cursor-based pagination (SCAN)
- optional
excludeBull=true - key type, TTL, and best-effort memory usage
pageSize is a scan target, not a strict result limit; Redis SCAN can return more keys in a batch.
Continue with the returned cursor until it is "0". total, when available, is the database's
key count, not the number matching the search pattern. TTL -1 means no expiration, and -2
means the key no longer exists.
Key Value Inspection
Value endpoint:
GET /api/c/:connectionId/redis-keys/value/:key
Type-aware parsing:
- string (attempt JSON parse)
- hash
- list
- set
- zset
- stream
Lists and sorted sets support offset and limit. Hash inspection reads the whole hash; set
and stream inspection is bounded but does not provide a resumable cursor. Large collections
may therefore show only a sample.
Deletion Safety Rule
Delete endpoint:
DELETE /api/c/:connectionId/redis-keys/:key
Durabull blocks deletion of keys starting with bull: or bullmq:. The excludeBull=true
search filter uses the same prefixes. Custom BullMQ prefixes are not covered by this guard;
manage those keys through queue and job operations too.
Reason:
- Bull queue internals should be managed via queue/job operations, not raw key deletion.
Good Practices
- Use key explorer for app-level cache/session/config keys.
- Keep BullMQ internal cleanup within queue/job workflows.
- Prefer pattern filtering to reduce broad scans in large keyspaces.