Data purging

Learn about purging data in the IBM MobileFirst™ Platform Operational Analytics.

By default, data that is stored in the Analytics Platform is not automatically deleted. To enable automatic purging of data, the time to live (TTL) property must be set for each data type.

The TTL for analytics data types that are stored in the Analytics Platform can be set by using JNDI properties. For more information about analytics data types, see Operational analytics.

The following table shows the TTL properties:

Table 1. TTL properties for purging data that is stored in the Analytics Platform. This table lists TTL property names and description for purging data that is stored in the Analytics Platform.
Property Name	Description
`TTL_CustomData`	Time to live for custom data.
`TTL_MfpAppLogs`	Time to live for client logs, such as client-side captured logs, and stack traces.
`TTL_MfpAppPushAction`	Time to live for application push actions.
`TTL_ServerLogs`	Time to live for server logs.
`TTL_ServerNetworkTransactions`	Time to live for server network transactions.
`TTL_ServerPushNotifications`	Time to live for server push notifications.
`TTL_ServerPushSubscriptions`	Time to live for server push subscriptions.

Note: All JNDI properties must be preceded with the analytics/ string. For more information about JNDI properties, see JNDI properties.

Three document types are not configured with a TTL property and therefore documents of this type are automatically purged:

CustomCharts
Devices
MobileUsers

You can also set some of the TTL values in the Admin tab in the Analytics Console. Do not use both JNDI property and changing the setting in the console at the same time. A restart of the Analytics server reads and uses the JNDI property, which removes the previous value that was set in the console.

By default, the format for the TTL is in milliseconds. TTL can also be set by using a number followed by a character that represents the time interval:

d (days)
m (minutes)
h (hours)
ms (milliseconds)
w (weeks)

The following example shows how to set the custom data TTL to one day in milliseconds:

<jndiEntry jndiName="analytics/TTL_CustomData" value="86400000" />

The following example shows how to set the client logs data TTL to five days:

<jndiEntry jndiName="analytics/TTL_MfpAppLogs" value="5d" />

The following example shows how to set the server logs TTL to one week:

<jndiEntry jndiName="analytics/TTL_ServerLogs" value="1w" />

Note: The TTL properties are not applied to data that exists in the Analytics Platform. You must set the TTL properties before you add data.