Previous Topic: About Data Retention Rules

Next Topic: Report Definition Structure

Data Retention Rules › Syntax

Syntax

Data retention rules have the following format:

RetentionRulen = period-level.attribute-name.application-id.retention-days
n

Specifies a sequence number for the rule. Rules must be numbered sequentially, starting at 1.

period-level

Specifies HOURLY, DAILY, or MONTHLY. This value is the recording level of the rows covered by this rule. A resource class or an attribute can have a different retention period for each period level. For example, hourly TotalConnections data can be kept for one week, daily TotalConnections data can be kept for six months, and monthly TotalConnections data can be kept for two years.

attribute-name

Specifies a valid attribute name or percentage, which means that this rule applies to the facts for any attribute that does not appear in a more specific rule. For information about the attributes, see the attributedetails.txt file in the SMP/E .../nm/reporter/wr76/reports/common/... Target Library directory.

application-id

Specifies an ID that organizes attributes into groups under a resource class. You can specify a resource class, a comma-separated list of resource classes, or percentage to indicate all resource classes.

retention-days

Specifies an integer that indicates the number of days that the data is kept before being deleted.

Data that does not match any rule is retained forever.

Example: Application ID for file transfer management attributes is FTMON

To find the application ID for an IP attribute

  1. From a data region, enter the /MONATTR shortcut.

    The Monitoring Attributes panel appears.

  2. Enter SHOWALL to list all the attributes.
  3. Enter S next to the required attribute.

    The Attribute Application Controls panel appears, showing the application ID. Ignore the $ prefix in the displayed ID.

Example: Retain All Data for 93 Days

The following retention rule keeps the daily data for all attributes with the application ID IPCWMON for 93 days:

RetentionRule1=DAILY.%.IPCWMON.93

Example: Retain ConTotalBytes Data for 14 Days

The following retention rule keeps the hourly aggregated ConTotalBytes data for 14 days:

RetentionRule2=HOURLY.CONTOTALBYTES.IPCWMON.14

Example: Retain Data for 366 Days

The following retention rule keeps the daily aggregated data for classes FTMON, IPCWMON, IPFWMON, and IPTWMON for 366 days:

RetentionRule3=DAILY.%.FTMON,IPCWMON,IPFWMON,IPTWMON.366

Example: Delete CSM Data

The following retention rule deletes the monthly aggregated data for any attributes from the communications storage manager (CSM) monitor:

RetentionRule4=MONTHLY.%.IPCSMM.0