Redis Keyspace Notification Flags

Enter a notify-keyspace-events value to see exactly which events it publishes and on which channels. Both the bare flag string and the whole config line are accepted.

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 Decode. 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.

Publishes nothing

Event classes selected with no channel to publish them on, which is silent

A

The usual value

What KEA actually covers, and the two event types it leaves out

notify-keyspace-events "KEA"

Expiry events only

A narrow selection, with the warning that expired events are not a timer

Ex

Common mistakes

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

  1. Setting `notify-keyspace-events A` and waiting for events

    A selects event classes but no channel, so nothing is ever published. The configuration is valid and accepted, and the result is total silence with nothing to debug.

    Instead:Add K or E, or both. `KEA` is the usual value.

  2. Expecting A to include everything

    A expands to g$lshzxetd and deliberately excludes `n` for new-key and `m` for key-miss events, because both are very high volume.

    Instead:Add `m` or `n` explicitly, after checking what volume that means for your workload.

  3. Using expired events as a scheduler

    The event fires when the key is actually removed, lazily on access or via a sampling cycle, not when the TTL passes. A key nobody touches can wait a long time.

    Instead:A sorted set keyed by expiry that you poll gives you control over the precision.

  4. Relying on notifications not to be missed

    They are ordinary pub/sub. A message published while no subscriber is connected is discarded, with no buffer, no replay and no acknowledgement.

    Instead:Use a stream with a consumer group, which has both acknowledgement and replay.

Two flags choose the channel, the rest choose the events

The value is a string of single-character flags with no separator, and it fails silently in two specific ways that produce no error and no events.

Without K or E, nothing is published

K selects __keyspace@<db>__:<key> channels, where the channel names the key and the message is the event. E selects __keyevent@<db>__:<event> channels, where the channel names the event and the message is the key. Setting event classes without either produces total silence, and notify-keyspace-events A is the most common way to do it.

A is not all

A expands to g$lshzxetd, deliberately excluding n for new-key events and m for key-miss events, both because they are very high volume. Anyone who set A expecting key-miss events receives none and has nothing to debug, because the configuration is valid and accepted.

Expired events are late, sometimes very late

The expired event fires when the key is actually removed, not when its TTL passes. Removal happens either lazily on the next access or via a sampling cycle running ten times a second over a subset of keys with TTLs. A key nobody touches can wait a noticeable time for its event, so this is not a scheduler.

Delivery is fire and forget

These are ordinary pub/sub messages. A message published while no subscriber is connected is discarded, with no buffer, no replay and no acknowledgement. Any disconnection is silent data loss for the consumer, which makes notifications unsuitable for anything that must not be missed. A stream with a consumer group has acknowledgement and replay.

What this cannot see

It decodes the flag string. It cannot tell you whether a subscriber exists, whether it keeps up, or what volume your workload would produce. Enabling A on a write-heavy instance can publish more messages than the workload itself, and the cost falls on the same single thread serving commands.

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 Cluster Slot Distribution Who owns how much, and what is missing 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