SignalFx Developers Guide

percentile()

Calculates the nth percentile of metric timeseries in the input stream.

Syntax

Aggregation

percentile(pct [,by=grp])

Table 1. Parameter definitions
Parameter Type Description

pct

Double,
0.0 < pct100.0

Required: The percentile to calculate

grp

string or list of strings

Optional: Properties to group the output by

Transformation

percentile(pct [,over=duration])

Table 2. Parameter definitions
Parameter Type Description

pct

Double, 0.0 < pct100.0

Required: The number to calculate, between 0.0 (exclusive) and 100.0 (inclusive)

duration

Duration (number and duration units)
Durations are specified as a number followed by a single character:

  • s: seconds

  • m: minutes

  • h: hours

  • d: days

The default is None.

Optional: Duration over which to get the specified percentile

Both forms return a reference to the input stream object.

Examples

1
2
3
4
5
6
7
8
#Aggregation - 75th percentile by env
data('cpu.utilization').percentile(75, by='env')

#Aggregation - 90th percentile by env and datacenter
data('cpu.utilization').percentile(90, by=['env', 'datacenter'])

#Transformation - cpu.utilization 99th percentile over the past 45 minutes
data('cpu.utilization').percentile(99, over='45m')

© Copyright 2019 SignalFx.

Third-party license information