Skip to content

DEV: (cmds) update TS cmd pages for multiple aggregators support#2949

Open
dwdougherty wants to merge 3 commits intoDOC-6334from
DOC-6408
Open

DEV: (cmds) update TS cmd pages for multiple aggregators support#2949
dwdougherty wants to merge 3 commits intoDOC-6334from
DOC-6408

Conversation

@dwdougherty
Copy link
Copy Markdown
Collaborator

@dwdougherty dwdougherty commented Mar 27, 2026

Redis 8.8 feature


Note

Low Risk
Low risk: documentation-only updates, but they change command signatures and examples, so inaccuracies could mislead users if the syntax is wrong.

Overview
Updates RedisTimeSeries range-query docs (TS.RANGE, TS.REVRANGE, TS.MRANGE, TS.MREVRANGE) to document multiple aggregators via comma-separated AGGREGATION aggregationType[,aggregationType ...], replacing the previous single-aggregator oneof argument.

Refreshes examples and the TimeSeries aggregation guide to show multi-aggregator usage (e.g., min,avg,max), notes that GROUPBY/REDUCE isn’t allowed when multiple aggregators are specified, and regenerates the related railroad-diagram SVGs to match the new syntax.

Written by Cursor Bugbot for commit 0f91ed0. This will update automatically on new commits. Configure here.

@dwdougherty dwdougherty requested review from a team and LiorKogan March 27, 2026 17:03
@dwdougherty dwdougherty self-assigned this Mar 27, 2026
@dwdougherty dwdougherty added dev cmds oss Redis Open Source labels Mar 27, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 27, 2026

DOC-6408

@jit-ci
Copy link
Copy Markdown

jit-ci bot commented Mar 27, 2026

🛡️ Jit Security Scan Results

CRITICAL HIGH MEDIUM

✅ No security findings were detected in this PR


Security scan by Jit

@dwdougherty
Copy link
Copy Markdown
Collaborator Author

Thank you, @kaitlynmichael!

Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

per time series, aggregates samples into time buckets, where:

- `aggregator` takes one of the following aggregation types:
- `aggregationType` takes one or more of the following aggregation types:
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.

Please add a note that whitespace are not allowed. (Like in TS.MRANGE FILTER expression)

Whitespaces are not allowed in an aggregation types expression.

per time series, aggregates samples into time buckets, where:

- `aggregator` takes one of the following aggregation types:
- `aggregationType` takes one or more of the following aggregation types:
Copy link
Copy Markdown
Member

@LiorKogan LiorKogan Mar 29, 2026

Choose a reason for hiding this comment

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

  • aggregationType takes one or more of the following aggregation types:

I think it is wrong to say that, as each aggregator takes one aggregator.

I suggest using aggregators and describe it as one or more comma-separated aggregations (like in TS.MRANGE FILTER filterExpr...)

- `aggregationType` takes one or more of the following aggregation types:

| `aggregator` | Description |
| `aggregationType` | Description |
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.

Please change back to aggregator

token: TWA
type: pure-token
name: aggregator
- name: aggregationType
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.

Suggest renaming to aggregators

the dataset size to 1,440 data points (24 hours x 60 minutes = 1,440 minutes).

The range query commands let you specify an aggregation function and bucket size.
The range query commands let you specify one or more aggregation function and bucket size.
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.

function --> functions

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants