Skip to main content

Data Retention Feature

Overview

The Data Retention feature automatically removes old data from Immutable devices after the period you define. Its purpose is to help customers avoid unnecessary costs by deleting data that does not need to be kept long-term.

info

The Data Retention feature is available only for Optimized Device Data.

Selecting Data Retention

To configure Data Retention, you must select two fields:

These two fields are combined to create the device’s data retention policy.

Data Retention

UI helper text shown in the configuration:

Period

The Period field lets you choose the time chunk used to retain data (for example, Daily or Monthly). In combination with the Retention field, it defines how long data should be kept on your device.

Examples and important considerations:

info

Setting your devices Chunk Retention to 0 will cause the platform to delete all device data when the next period starts.

Retention ranges by period

PeriodRetention rangeDaily0–31Weekly0–26Monthly0–36Quarterly0–36
tip

Each period chunk is limited to 1 million registers. The retention feature keeps data for the selected retention plus the data in the current period.

Keep that in mind when setting your Chunk Retention, if your device sends more than 1 million data registers per period, you will lose data.

How it works

The removal schedule depends on the chosen Period:

Data is removed by a task that runs at these times. Therefore, data in your device can still be presented for several hours after the period crosses 0:00 h in your local time.

SDK

You can also access the data retention parameters using our SDK.