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 who requested automatic updates, and then resets the min and max values that are 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 can 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 can change this value by using the output_count and output_interval configuration parameters. For more information about modifying these parameters, see Configuring the Listener.
• A Manager can change this value when they are creating Clusters by specifying a collection interval (in seconds). For more information, see the IBM System Dashboard for Enterprise Content Management User's Guide on the IBM System Dashboard for Enterprise Content Management media.
• The application can change the interval dynamically during application execution by using the setInterval member function of the Listener:

  listener->setInterval(interval);

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