history

Use this command to store timing information for statistical modeling of the network for an IP SLA entry.

Syntax

history ageout minutes
history buckets buckets {[samples samples] |[interval seconds]}
history collections collections [wrap]
no history ageout
no history buckets
no history collections

Parameters

ageout minutes The amount of time, in minutes, before a history collection is aged out and the memory it used is returned to the free pool. Possible values are 0 and 15–7200 minutes. The default value, 0, indicates that a history collection does not age out.

If ageout is set to a value other than 0, it is possible to configure a history collection that runs longer than the ageout value. In this case, the test will finish running before it ages out.

buckets count The number of storage units for timing information in a history collection. Possible values are 1–50. The default value is 50 buckets.
samples count Indicates that the buckets have a static depth of n samples. Possible values are 16–512 samples. The default value is 16 samples.
interval seconds Indicates that the buckets have a timed depth, in seconds.

To estimate the depth of a timed bucket, multiply the number of packets per second defined in the probe by the number of seconds represented by the each bucket.

Possible values are 30–3600 seconds.

collections count Specifies the number of history collections to maintain. Possible values are 0 and 1–10. The default value, 0, indicates that no collections are kept.
wrap Indicates whether the storage history wraps when the number of collections exceeds the value of the collection parameter. By default, the collections do not wrap.

Defaults

For the samples, interval and wrap parameters, any parameter not specified remains at its current value.

Mode

Configuration IP SLA entry mode.

Usage

Use the no forms of the history command to reset the ageout, buckets, and collections parameters to the default values.

The packet timing entry, which is stored in the bucket, comes from the global pool. If the global pool is exhausted, the IP SLA application will not start the test.

If you have not specified a destination IP address for the IP SLA entry and your history settings use the defaults for ageout and wrap, the test uses a history collection but not data is collected. Also, the resources used by the history collection will not be freed. To free the resources, set the destination IP address and change the value of either ageout or wrap from the default.

Example

This example shows the ageout, buckets, and collections parameters set.

System(su-config)->sla entry 8 echo
System(su-config-sla)->history ageout 18
System(su-config-sla)->history buckets 5 interval 300
System(su-config-sla)->history collections 2 wrap