Configuring the Aggregation Interval

The aggregation interval is the length of time over which each summary block of performance data is accumulated by the Listener. At the end of each aggregation interval, the Listener computes a summary block (basically, a snapshot of the current counter values), sends this summary to any Managers that have requested automatic updates, and then resets the min and max values associated with the Accumulators. This summary block is also added to a running history maintained by the Listener, which allows newly-connecting Managers to request information about recent application activity.

Although an application may configure the aggregation interval, the value is normally left to the default or specified by the Manager. The interval value can be specified in the following ways:

• By default, the IBM® System Dashboard for Enterprise Content Management specifies an aggregation interval of 900 seconds or 15 minutes.
• An administrator may change this value using the output_count and output_interval configuration parameters. For more information about modifying these parameters, see Configuring the Listener.
• A Manager may change this value when creating Clusters by specifying a collection interval (in seconds). For more information, see the IBM System Dashboard for Enterprise Content ManagementUser's Guide on the IBM System Dashboard for Enterprise Content Management media.
• The application may change the interval dynamically during application execution using the setInterval method of the Listener:

  listener.setInterval(interval);

  The interval is an int value that specifies the new value (in milliseconds) to assign as the aggregation interval. Values of less than 100 milliseconds are ignored.