Rate

Per second

FunctionDescriptionExample
per_second()Graph the rate at which the metric is changing per second.per_second(<METRIC_NAME>{*})

Per minute

FunctionDescriptionExample
per_minute()Graph the rate at which the metric is changing per minute.per_minute(<METRIC_NAME>{*})

Per hour

FunctionDescriptionExample
per_hour()Graph the rate at which the metric is changing per hour.per_hour(<METRIC_NAME>{*})

Time difference

FunctionDescriptionExample
dt()Graph the time difference in seconds between submitted points.dt(<METRIC_NAME>{*})

The dt() function returns only one timeseries regardless of how many groups are involved. Within that one timeseries, it considers the time difference of all the submitted points across the various groups.

Value difference

FunctionDescriptionExample
diff()Graph the delta of the metric.diff(<METRIC_NAME>{*})

Calculates the difference between each interval on a per interval basis. For example, a metric submits data points with a 15 second interval, the diff() modifier would show it over 15 second rate. Note: The calculation is done after applying time aggregation and before space aggregation takes place.

Monotonic difference

FunctionDescriptionExample
monotonic_diff()Graph the delta of the metric like diff() but only if the delta is positive.monotonic_diff(<METRIC_NAME>{*})

Derivative

FunctionDescriptionExample
derivative()Graph the derivative (diff/dt) of the metric.derivative(<METRIC_NAME>{*})

Throughput

FunctionDescriptionExample
throughput()Converts a timeseries into a rate per second, by dividing each value by the number of seconds in the time bucket to produce the per-second value.throughput(<METRIC_NAME>{*})

Other functions


Further Reading

Additional helpful documentation, links, and articles: