Skip to content

DEV: add info. about sub-keyspace notifications#3014

Open
dwdougherty wants to merge 2 commits intoDOC-6334from
DOC-6432
Open

DEV: add info. about sub-keyspace notifications#3014
dwdougherty wants to merge 2 commits intoDOC-6334from
DOC-6432

Conversation

@dwdougherty
Copy link
Copy Markdown
Collaborator

@dwdougherty dwdougherty commented Apr 10, 2026

Redis 8.8 feature


Note

Low Risk
Low risk documentation-only change that adds a new page describing Pub/Sub subkey notification channels and configuration; no product code is modified.

Overview
Adds new documentation page develop/pubsub/subkeyspace-notifications.md describing Redis 8.8 subkey notifications (per-field/path/element events) as an extension to keyspace notifications.

Covers the four new Pub/Sub channel formats and payload encodings, configuration via new notify-keyspace-events flags (S, T, I, V), supported hash commands/events, and a short redis-cli example for observing notifications.

Reviewed by Cursor Bugbot for commit 4bf47b2. Bugbot is set up for automated code reviews on this repo. Configure here.

@dwdougherty dwdougherty requested review from a team and LiorKogan April 10, 2026 15:35
@dwdougherty dwdougherty self-assigned this Apr 10, 2026
@dwdougherty dwdougherty added dev oss Redis Open Source labels Apr 10, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 10, 2026

DOC-6432

@github-actions
Copy link
Copy Markdown
Contributor

@jit-ci
Copy link
Copy Markdown

jit-ci bot commented Apr 10, 2026

🛡️ Jit Security Scan Results

CRITICAL HIGH MEDIUM

✅ No security findings were detected in this PR


Security scan by Jit

Copy link
Copy Markdown
Contributor

@andy-stark-redis andy-stark-redis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Language LGTM

@dwdougherty dwdougherty requested a review from LiorKogan April 10, 2026 21:32

| Command | Event | Subkeys included |
|---|---|---|
| [`HSET`]({{< relref "/commands/hset" >}}) / [`HMSET`]({{< relref "/commands/hmset" >}}) | `hset` | All subkeys being set |
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In all rows of this table:
subkey --> field
Because all these rows are specific Hash events.

The title should remain "subkeys".


$ redis-cli config set notify-keyspace-events STIV

### Supported commands
Copy link
Copy Markdown
Member

@LiorKogan LiorKogan Apr 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Supported commands" is probably not a good title.
Maybe "Commands emitting subkey notifications"?

S Subkeyspace events, published with __subkeyspace@<db>__ prefix.
T Subkeyevent events, published with __subkeyevent@<db>__ prefix.
I Subkeyspaceitem events, published with __subkeyspaceitem@<db>__ prefix.
V Subkeyspaceevent events, published with __subkeyspaceevent@<db>__ prefix.
Copy link
Copy Markdown
Member

@LiorKogan LiorKogan Apr 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Based on Debing's reply on Slack, we should add h as well.

IIUC, specifying h wouldn't change much, as this is the only key type supported now.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dev oss Redis Open Source

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants