Configure Data Retention Rates

The default data retention rates for the Data Repository help to conserve disk space and improve reporting, and can be customized. Polled data is generated each poll cycle for all devices, and this data represents the most granular data available in the product. This raw, polled data is set to roll up at hourly, daily, and weekly aggregation levels.
capm320
The default data retention rates for the Data Repository help to conserve disk space and improve reporting, and can be customized. Polled data is generated each poll cycle for all devices, and this data represents the most granular data available in the product. This raw, polled data is set to roll up at hourly, daily, and weekly aggregation levels.
Because higher-level aggregated data requires less disk space, you can keep this data for a longer period than polled data.
You can change how long the 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
  • 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: 2 days
  • Hourly rollup data: 8 days
    When the hourly retention rate is less than 32 days, the calendar heat chart views show daily data (only one sample per day). The charts appear sparse as a result.
  • Daily rollup data: 31 days
  • Weekly rollup data: 366 days
Follow these steps:
  1. Enter the following information in a web browser:
    http://
    hostname:port
    /rest/globalretentiondefinition 
    • hostname
      :
      port
      Use this parameter to specify the Data Aggregator host name and the port number.
      Default port:
       8581
  2. Take note of the ID that is assigned to the globalretentiondefinition.
  3. Look for the following elements:
    • GtdRollupDataRetentionPeriod
    • DailyRollupDataRetentionPeriod
    • PolledDataRetentionPeriod
    • HourlyRollupDataRetentionPeriod
    This information helps you determine which types of data you want to modify the retention period for.
  4. Look for the elements that has the HistoricConfigurationDataRetentionPeriod parameter. This information helps you specify the number of days to keep item repository attribute values.
  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
        A unique identification number that is assigned to the globalretentiondefinition parameter
    • 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>
      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> 
        <HistoricConfigurationDataRetentionPeriod>7</HistoricConfigurationDataRetentionPeriod>
        <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.