Reference to the mvalues() function.

Summary

mvalues(<timeWindow>, <tsExpression>[,metrics|sources|sourceTags|pointTags|<pointTagKey>])

Returns the number of unique values over the specified time window.

Parameters

ParameterDescription
timeWindow Amount of time in the moving time window. You can specify a time measurement based on the clock or calendar (1s, 1m, 1h, 1d, 1w), the window length (1vw) of the chart, or the bucket size (1bw) of the chart. Default is minutes if the unit is not specified.
tsExpression Expression that describes the time series for which you want to see the number of unique values.
metrics|sources|sourceTags|pointTags|<pointTagKey> Optional 'group by' parameter for organizing the time series into subgroups and then returning a count for each subgroup. Use one or more parameters to group by metric names, source names, source tag names, point tag names, values for a particular point tag key, or any combination of these items. Specify point tag keys by name.

Description

The mvalues() function counts the number of the unique values over a shifting time window. For example, mvalues(5m, ts(~sample.db.bytes.sent), env) returns the number of unique bytes sent to and from the database, grouped by environment over a 5-minute time window.

Example

The following query returns the number of product versions over time.

ts(build.version)

To narrow down the search and see the current number of product versions running across your environment, apply the mvalues () function.

mvalues(5m, ts(build.version))

You can see the result in the top right corner of the chart, under Value.

You can also see the current number of product versions running across your environment for points that are tagged with primary and are grouped by sourcetags.

mvalues(5m, ts(build.version, tag="*-primary"), sourcetags)

See Also

Using Moving and Tumbling Windows to Highlight Trends