Skip to content

Commit 59da11b

Browse files
authored
Support window functions in time-series aggregations (#138139)
This change adds window function support for time-series aggregation functions including `rate`, `avg_over_time`, and `last_over_time`. Additional time-series aggregation functions will be supported in a follow-up to keep this PR focused. **Examples:** ```js TS k8s | WHERE TRANGE("2024-05-10T00:05:00.000Z", "2024-05-10T00:10:00.000Z") | STATS rate_bytes_in=avg(rate(network.total_bytes_in, 5minute)) BY cluster, time_bucket = bucket(@timestamp, 1minute) ``` Window 5-minute over 1-minute buckets. ```js TS k8s | STATS events = sum(avg_over_time(events_received, 10minute)) BY pod, time_bucket = tbucket(5minute) | SORT time_bucket, pod | LIMIT 10 ``` Window 10-minute over 5-minute buckets. **Limitation**: ES|QL currently supports only windows that are multiples of the bucket size.
1 parent 860ad79 commit 59da11b

File tree

42 files changed

+887
-78
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+887
-78
lines changed

docs/changelog/138139.yaml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
pr: 138139
2+
summary: Support window function in time-series aggregations
3+
area: ES|QL
4+
type: enhancement
5+
issues: []

docs/reference/query-languages/esql/_snippets/functions/parameters/avg_over_time.md

Lines changed: 3 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/reference/query-languages/esql/_snippets/functions/parameters/last_over_time.md

Lines changed: 4 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/reference/query-languages/esql/_snippets/functions/parameters/rate.md

Lines changed: 4 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/reference/query-languages/esql/_snippets/functions/types/avg_over_time.md

Lines changed: 6 additions & 6 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/reference/query-languages/esql/_snippets/functions/types/last_over_time.md

Lines changed: 8 additions & 8 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/reference/query-languages/esql/_snippets/functions/types/rate.md

Lines changed: 5 additions & 5 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/reference/query-languages/esql/images/functions/avg_over_time.svg

Lines changed: 1 addition & 1 deletion
Loading

docs/reference/query-languages/esql/images/functions/last_over_time.svg

Lines changed: 1 addition & 1 deletion
Loading

docs/reference/query-languages/esql/images/functions/rate.svg

Lines changed: 1 addition & 1 deletion
Loading

0 commit comments

Comments
 (0)