Using Data-Driven Web Services › Change Data Retention Periods

Change Data Retention Periods

You can change the rate at which Data Repository retains the polled data, hourly rollup data, daily rollup data, and weekly rollup data. For example, you can change the polled data retention value to 30 days to conserve disk space. Find the balance that best suits your needs and environment.

By default, data is retained in Data Repository for the following number of days:

• Polled data: 45 days

  Note: If you upgraded to this release from a previous release of Data Aggregator, the polled data retention will not change from the prior default of ten days.

• Hourly rollup data: 90 days
• Daily rollup data: 365 days
• Weekly rollup data: 730 days

The minimum number of days that Data Repository can retain data for is as follows:

• Polled data: two days
• Hourly rollup data: eight days
• Daily rollup data: 31 days
• Weekly rollup data: 366 days

Follow these steps:

1. Enter the following information in a web browser:
2. http://hostname:port/rest/globalretentiondefinition

   hostname:port

   Specifies the Data Aggregator host name and the port number.

   Default port: 8581

   The globalretentiondefinition webservice endpoint URL opens.

3. Take note of the ID that is assigned to the globalretentiondefinition.
4. Look for the elements that have GtdRollupDataRetentionPeriod, DailyRollupDataRetentionPeriod, PolledDataRetentionPeriod, and HourlyRollupDataRetentionPeriod. This information helps you determine which types of data you want to modify the retention period for.
5. Open a REST client editor or HTTP tool that sends requests and gets responses and set the Content-type to application/xml.
6. Enter the following criteria:
   • URL: http://hostname:port/rest/globalretentiondefinition/ID

     ID

     Is a unique identification number that is assigned to the globalretentiondefinition.

   • HTTP method = PUT
   • Enter the retention periods that you want to change in the Body tab of the HTTP Request pane.

     For example:

     <GlobalRetentionDefinition version="1.0.0"> 
     <PolledDataRetentionPeriod>4</PolledDataRetentionPeriod>
     </GlobalRetentionDefinition>
     

     Important! Verify that there is no white space at the beginning of each of these lines, otherwise the PUT fails.

     In this example, the polled data retention period has been changed to four days.

   Results are returned in the Body tab of the HTTP Response pane.

   For example:

   <GlobalRetentionDefinitionList>
   <GlobalRetentionDefinition version="1.0.0">
     <ID>4</ID> 
     <GtdRollupDataRetentionPeriod>730</GtdRollupDataRetentionPeriod> 
     <DailyRollupDataRetentionPeriod>365</DailyRollupDataRetentionPeriod> 
     <PolledDataRetentionPeriod>4</PolledDataRetentionPeriod> 
     <HourlyRollupDataRetentionPeriod>90</HourlyRollupDataRetentionPeriod> 
   <Item version="1.0.0">
     <CreateTime>Thu Dec 08 16:03:05 CST 2011</CreateTime> 
     <Name>Global Retention Definition</Name> 
     </Item>
     </GlobalRetentionDefinition>
     </GlobalRetentionDefinitionList>
   

   In this example, the polled data retention period has been changed to four days. The default retention periods for weekly rollup data, daily rollup data, and hourly rollup data remain.