SignalFx Developers Guide

min()

Find the minimum value of the metric timeseries in the input stream.

Syntax

Aggregation

min([by=grp])

Table 1. Parameter definitions
Parameter Type Description

grp

string or list of strings. Default is None.

Optional: Properties to group the output by

Transformation

min(over=duration [,cycle=type][,cycle_start=index][,shift_cycles=shift][,partial_values=partials_flag])

Table 2. Parameter definitions
Parameter Type Description

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 minimum of the input stream.

type

One of the following:

  • "quarter"

  • "month"

  • "week"

  • "day"

  • "hour"

The default is None.

Clock or calendar duration over which to get the minimum of the input stream.1

shift

Number. Default is 0

Optional: Shifts the cycle window a number of cycles back from the current time and day. For example, cycle="hour" and shift_cycles=1 shifts the window to the previous hour.+ NOTE: If you specify shift_cycles=shift, partial_values must be False (the default).1

partials_flag

Boolean

Optional: If True, SignalFlow emits partial results during the time period of cycle; otherwise, SignalFlow only emits a result at the end of the cycle. Default is False.
NOTE: If you specify partial_values=True, you can’t use shift_cycles.1

1 To learn more about calendar window transformations, see Calendar window transformations.

All forms return a reference to the input stream object.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
#Aggregation - min by env
data('cpu.utilization').min(by='env')

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

#Transformation - 30 minute min
data('cpu.utilization').min(over='30m')

#Transformation - Min over last day, starting at 6:00 AM
#Emit values during the period
data('cpu.utilization').min(cycle="day", cycle_start="06h", partial_values=True)

© Copyright 2019 SignalFx.

Third-party license information