aggregate
To configure the size and number of bins into which to aggregate the results of statistics collection, use the aggregate command in SLA profile statistics configuration mode. To return to the default, use the no form of this command.
aggregate { bins count width [usec] width | none}
Syntax Description
bins count |
Number of bins. The range is 2 to 100. |
width width |
For delay and jitter measurements, the size of each bin in milliseconds (range is 1 to 10000). When the usec keyword is specified, the size of bins can be configured in microseconds (range is 1 to 10000000). For loss measurements, the size of each bin in percentage points (range is 1 to 100). In addition, the width must be specified if the number of bins is at least 2, regardless of the type of measurement. |
usec |
(Optional) When specified, the size of each bin can be configured in microseconds. |
none |
No aggregation is performed. All samples are stored individually. |
Command Default
For delay measurements, all collected statistics are aggregated into one bin.
For loss measurements, the default is aggregation disabled.
Command Modes
SLA profile statistics configuration (config-sla-prof-stat-cfg)
Command History
Release 3.9.0 |
This command was introduced. |
Release 4.3.0 |
The measurement statistics for Y.1731 Synthetic Loss Measurement (SLM) was included. |
Release 7.7.1 |
The usec option was introduced. |
Usage Guidelines
Changing the aggregation for a given metric clears all stored data for that metric.
When aggregation is enabled, a number of bins are created, each of which represents a range of values. Instead of storing each individual result, all that is stored is a counter of the number of results that fall within the range for each bin. This uses much less memory than storing each individual result.
For delay and jitter measurements, the first bin starts at 0, each bin covers a range of values defined by the specified width, except for the last bin which ends at infinity. For example, an aggregate bin count of 4 and a width of 20 for delay measurements yields 4 bins of statistics for these sample ranges:
-
Bin 1—Samples with delay ranges 0 to < 20 ms.
-
Bin 2—Samples with delay ranges greater than or equal to 20 and < 40 ms.
-
Bin 3—Samples with delay ranges greater than or equal to 40 and < 60 ms.
-
Bin 4—Samples with delay ranges 60 ms or greater (unbounded).
For synthetic loss measurements, the first bin starts at 0, each bin covers a range of values defined by the specified width, except for the last bin which ends at infinity. For example, an aggregate bin count of 4 and a width of 25 for loss measurements yields 4 bins of statistics for these sample ranges:
-
Bin 1—Samples with loss ranges 0 to < 25 percentage points.
-
Bin 2—Samples with loss ranges greater than or equal to 25 and < 50 percentage points.
-
Bin 3—Samples with loss ranges greater than or equal to 50 and < 75 percentage points.
-
Bin 4—Samples with loss ranges greater than or equal to 75 and <100 percentage points.
![]() Note |
For delay and jitter measurements (round-trip or one-way), the lower bound of the first bin is zero, and the last bin is effectively of infinite width. If aggregation is disabled, each individual delay value is stored. For loss measurements, the lower bound of the first bin is zero, and the upper bound of the last bin is 100. The last bin may be wider than the other bins. If aggregation is disabled, each calculated FLR value is stored. |
![]() Note |
The lower bound of each bin is inclusive, while the upper bound is exclusive. Changing the aggregation for a given metric clears all stored data for that metric. |
Task ID
Task ID |
Operations |
---|---|
ethernet-services |
read, write |
Examples
This example shows how to configure round-trip-delay statistics measurement in 4 bins each with a width of 10000000 microseconds:
Router# configure
Router(config)# ethernet sla
Router(config-sla)# profile Prof1 type cfm-delay-measurement
Router(config-sla-prof)# statistics measure round-trip-delay
Router(config-sla-prof-stat-cfg)# aggregate bins 4 width usec 10000000