2-445
Cisco Broadband Cable Command Reference Guide
OL-1581-08
Chapter 2 Cisco CMTS Configuration Commands
monitoring-duration
monitoring-duration
To specify the time period and sample rate to be used for monitoring subscribers, use the
monitoring-
duration
command in enforce-rule configuration mode. To reset an enforce-rule to its default values,
use the
no
form of this command.
monitoring-duration
minutes
[
sample-rate
minutes
]
no monitoring-duration
Syntax Description
Defaults
The
monitoring-duration
value defaults to 360 minutes (6 hours), and the
sample-interval
value
defaults to 15 minutes.
Command Modes
Enforce-rule configuration
Command History
Usage Guidelines
When you an enable an enforce-rule, the CMTS periodically checks the bandwidth being used by
subscribers, so as to determine whether any subscribers are consuming more bandwidth than that
specified by their registered QoS profile. The CMTS keeps track of the subscribers using a sliding
window that begins at each sample-rate interval and continues for the monitoring-duration period.
For example, with the default sample-rate interval of 15 minutes and the default monitoring-duration
window of 360 minutes, the CMTS samples the bandwidth usage every 15 minutes and determines the
total bytes transmitted at the end of each 360 minute period. Each sample-rate interval begins a new
sliding window period for which the CMTS keeps track of the total bytes transmitted.
Note
The
sample-rate
interval must be less than or equal to the
monitoring-duration
period. If you attempt
to set the sample-rate to a value greater than the monitor-duration period, the command is ignored and
the parameters are unchanged.
minutes
The valid range is 10 to 10080 minutes, with a default of 360 minutes
(6 hours).
sample-rate
minutes
(Optional) Rate of sampling, in minutes. The valid range is 1 to 30
minutes, with a default value of 15 minutes.
Note
The
sample-rate
minutes
must be less than or equal to the
monitoring-duration
minutes
period.
Release
Modification
12.2(15)BC1
This command was introduced.
12.2(15)BC2 The
minimum
sample-rate
was reduced to 1 minute. Also, the
sample-rate
is not allowed to be set to a value greater than the
monitor-duration
period.
If you attempt to do so, the command is ignored and both parameters remain
set to their current values.