$percentiles - Upstash Documentation

$percentiles returns percentile cut points for a field. A percentile tells you the value below which a percentage of observations fall.

50th percentile: median-like center point
95th percentile: tail latency/price threshold
99th percentile: extreme tail threshold

Compatibility

Field Type	Supported
TEXT	No
U64/I64/F64	Yes
DATE	Yes
BOOL	No
KEYWORD	No
FACET	No

Field must be FAST.

Arguments

Argument	Type	Required	Description
`field`	`string`	Yes	Field to aggregate.
`percents`	`number[]`	No	Percent points to calculate (for example `[50, 95, 99]`).
`keyed`	`boolean`	No	If `true` (default), returns a map. If `false`, returns an array of `{ key, value }`.
`missing`	`number`	No	Fallback value for missing fields.

If percents is omitted, defaults to [1.0, 5.0, 25.0, 50.0, 75.0, 95.0, 99.0].

TypeScript
Python
Redis CLI

await index.aggregate({
  aggregations: {
    latency_pct: {
      $percentiles: { field: "latencyMs", percents: [50, 95, 99], keyed: true },
    },
  },
});

index.aggregate(
    aggregations={
        "latency_pct": {
            "$percentiles": {
                "field": "latencyMs",
                "percents": [50, 95, 99],
                "keyed": True,
            }
        }
    }
)

SEARCH.AGGREGATE logs '{}' '{"latency_pct": {"$percentiles": {"field": "latencyMs", "percents": [50, 95, 99], "keyed": true}}}'

Output

keyed: true (default):

{
  "values": {
    "50.0": 40,
    "95.0": 76,
    "99.0": 79.2
  }
}

keyed: false:

{
  "values": [
    { "key": 50, "value": 40 },
    { "key": 95, "value": 76 },
    { "key": 99, "value": 79.2 }
  ]
}

​Compatibility

​Arguments

​Output

Compatibility

Arguments

Output