Metrics

A metric is an aggregation of events over time, configured on an event type. It transforms the volume of raw occurrences into queryable time series, with support for filters, dimensions, and different calculation functions.

With metrics, you can answer questions such as: how many transactions were processed per hour? What is the total approved amount per currency? What is the success rate of authentications?

20k 15k 10k 5k 0k transactions · count 01 08 15 22 04 11 18 Jan Feb

Transaction count over time. The drop detected at the end may trigger a monitor.

Metric components

Dimensions

Dimensions are fields of the event type used to segment the metric into distinct categories.

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.

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
Rate Proportion between two sets of events

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

Metric filters

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

Limits

  • Maximum of 20 metrics per event type.
  • The combination of dimensions must be unique per event type — it is not possible to have two metrics with the same dimensions.

Visualization

Each metric has its own chart, accessible through the admin panel. In the chart you can:

  • select the time range;
  • choose the granularity (1 minute, 1 hour, 1 day, among others);
  • select which aggregations to display (up to 5 at a time);
  • apply additional filters without changing the metric configuration.