Seconds instead of milliseconds
An ID a thousand times too small, which sorts before every real entry
1700000000-0
Redis Stream ID Parser
Paste stream IDs to see the time each one refers to and what its sequence number means. The special forms are explained too, because choosing the wrong one is the most common streams bug.
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 Parse. Nothing leaves this tab.
Formatted
Results
Nothing else to flag.
No formatting problems, and nothing the rules object to. Worth remembering what that covers: this reads the file you pasted, not the account or cluster it will be applied to.
No finding matches that filter.
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.
The special forms
Why passing 0 to XREADGROUP re-reads the pending list forever
1700000000000-0 $ > * -
Common mistakes
These are the ones that fail silently. The config is accepted, nothing raises an error, and the consequence arrives later.
Building an ID from a seconds timestamp
The first half is milliseconds. A seconds value is a thousand times too small, so it sorts before every real entry and XRANGE from it returns the whole stream.
Instead:Multiply by 1000, or let the server generate the ID with `*`.
Passing 0 to XREADGROUP expecting new messages
Any ID other than `>` returns that consumer's PENDING entries, so the consumer re-reads its own unacknowledged messages forever and never sees anything new.
Instead:Use `>` for new messages. Use 0 deliberately, and only to recover the pending list.
Generating IDs client-side to control ordering
Every ID has to beat the stream's current top or XADD is rejected, and coordinating that across producers is not worth doing.
Instead:XADD with `*` and let the server handle both the clock and the sequence.
An ID is a time and a tiebreak, and the special forms are not IDs at all
Stream IDs are ms-seq, where ms is a Unix millisecond timestamp taken from the server clock and seq disambiguates entries added within the same millisecond. IDs strictly increase, which is what makes range queries and consumer groups work.
The classic bug: seconds instead of milliseconds
An ID built from a seconds timestamp is a thousand times too small, so it sorts before every genuine entry in the stream. XRANGE from that ID quietly returns the entire stream rather than the recent slice you wanted, and XADD with it fails because it is smaller than the current top. The symptom is a consumer that reprocesses everything.
> and $ are not interchangeable
In XREADGROUP, > means entries never delivered to any consumer in this group. Any other ID, including 0, means that consumer's PENDING entries instead, so passing 0 makes a consumer re-read its own unacknowledged messages forever without ever seeing new ones. In XREAD, $ means only entries added after this call, and it is not valid for XREADGROUP.
A bare millisecond means different things at each end
In XRANGE, a start of 1700000000000 means sequence 0 of that millisecond, while an end of the same number means the maximum sequence. That asymmetry is deliberate and makes a bare timestamp behave as the whole millisecond. Redis 6.2 added exclusive ranges written with a leading parenthesis.
Let the server generate IDs
XADD with * takes the server's clock and guarantees the ID increases, including handling the case where the clock has not advanced since the last entry by bumping the sequence. A client-generated ID has to beat the current top or the write is rejected, and coordinating that across producers is not worth doing.
What this cannot see
It reads IDs and does not know your stream, so it cannot say whether an ID exists in it, whether it has been trimmed away by MAXLEN, or whether it is still pending for some consumer. The timestamp comes from whichever server generated it, so a clock skew between servers is invisible here.
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.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 Cluster Slot Distribution Who owns how much, and what is missing 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