Overview - Upstash Documentation

Bucket aggregations group matching documents into buckets. Use bucket aggregations when you want segmented analytics (for example by category, price tier, or time window).

Available Operators

Operator	What it groups by
`$terms`	Distinct field values
`$range`	Explicit `from` / `to` ranges
`$histogram`	Fixed numeric intervals
`$dateHistogram`	Fixed date/time intervals
`$facet`	Hierarchical FACET paths

Behavior Notes

Bucket operators can contain nested $aggs.
$terms, $range, $histogram, and $dateHistogram support nested $aggs.
$facet does not support nested $aggs and cannot be used as a sub-aggregation.