Calculates percentiles over numbers. It works on non-negative input values.

Returns one event with a field for each of the percentiles specified in the percentiles parameter. Fields are named like by appending _ to the values specified in the percentiles parameter. For example the event could contain the fields _50, _75 and _99.

ParameterTypeRequiredDefaultDescription
accuracynumberfalse0.001Relative accuracy as a decimal.
  Minimum0 
  Maximum1 
asstringfalse Prefix of output fields.
fieldstringtrue Specifies the field for which to calculate percentiles. The field must contain numbers. [a]
percentiles[number]false[50, 75, 99]Specifies which percentiles to calculate.

[a] If an argument name is not given, field is the default argument.

percentile() Examples

Calculate 50 75 99 and 99.9 percentiles for events with the field responsetime.

logscale
percentile(field=responsetime, percentiles=[50, 75, 99, 99.9])

In a timechart, calculate percentiles for both of the fields r1 and r2.

logscale
timechart(function=[percentile(field=r1,as=r1),percentile(field=r2,as=r2)])