View time series retention policies

The MetricBase application provides pre-defined retention policies that define the data collection interval for a metric.

Before you begin

Role required: admin

About this task

How often time series data is collected and how long the time series data is retained are important parameters for each metric. The MetricBase application provides pre-defined retention policies. You cannot create retention policies.

A retention policy is a series of time periods and collection rates. An example is 8d@1h, which means for eight days data is collected at one hour intervals. A retention policy is a series of these time periods with longer intervals for each subsequent time period. For example, 8d@1m,94d@10m,397d@1h.

Retention policies define the collection interval, which changes with the age of the data. Older data is compacted and stored with lower fidelity. You can see the available retention policies with the Retention Policies module. The 8d@1m,31d@30m,397d@1h retention policy means
  • For the last eight days, data points are available at 1-minute intervals.
  • Data points from 9 through 31 days are compressed to 30-minute intervals.
  • Data points older than 32 days are compressed to 1-hour intervals.
  • If data is ingested at 30-second intervals in the last eight days, one data point is lost. Data in the last eight days are always stored at 1-minute intervals.
  • If data is ingested at 2-minute intervals in the last eight days, the missing data points are stored as NaN. Data in the last eight days are always stored at 1-minute intervals.

Procedure

  1. Navigate to MetricBase > Retention Policies.
  2. Click a policy to view the collection interval specification.