Components
Three elements define a metric: 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 that segment the metric into distinct categories. Only fields with discrete values can be used as a dimension.
For example, a metric with the status dimension generates a separate time series for each value of that field (approved, declined, pending). Without that dimension, the metric records a single global count.
A metric accepts 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 the events in each time interval. Each metric needs at least one aggregation. 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 accepts its own name and its own filters. The aggregation filters apply only to it, independently of the metric 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. Use these filters to limit the scope from the configuration onwards, without repeating the same filter in each aggregation.
The platform applies the metric filters and the aggregation filters at the moment it aggregates the data. For that reason, these filters do not accept references to lists. A change applies to the next aggregations and does not reprocess history already consolidated.