Components

A metric is defined by three elements: the dimensions that segment it, the aggregations that calculate its values, and the filters that restrict the events considered.

Dimensions

Dimensions are fields of the event type used to segment the metric into distinct categories. Only fields with discrete values can be used.

For example, a metric with the status dimension generates a separate time series for each possible value of that field (approved, declined, pending), instead of a single global count.

A metric can have up to 10 dimensions. The combination of dimensions is defined at creation and cannot be changed afterwards.

A metric without any dimension represents a single time series, with no subdivisions.

Aggregations

An aggregation is the calculation applied to events in each time interval. Each metric must have at least one aggregation, and it is possible to configure several to compare different perspectives on the same chart.

Available aggregation functions:

Function Description
Count Number of events in the interval
Sum Sum of values of a numeric field
Minimum Lowest value of a numeric field
Maximum Highest value of a numeric field
Average Average of values of a numeric field
Percentage Proportion between two sets of events

Each aggregation can have its own name and its own filters, applied only to it, independently of the metric’s filters.

Aggregations over fields that represent a duration are displayed already converted to a readable unit (for example, 3.5s), both in the table and in the chart.

Metric filters

Filters applied at the metric level restrict the events considered by all aggregations. They are useful for limiting scope from the configuration onwards, without needing to repeat the filter in each aggregation.

The metric filters and the aggregation filters are applied at the moment the data is aggregated, and for that reason they do not accept references to lists. Changes apply to the next aggregations and do not reprocess history already consolidated.