The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The CPU Thresholding Notification feature notifies users when a predefined threshold of CPU usage is crossed by generating a Simple Network Management Protocol (SNMP) trap message for the top users of the CPU.
Feature History for the CPU Thresholding Notification Feature
Finding Support Information for Platforms and Cisco IOS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.
•Restrictions for CPU Thresholding Notification
•Information About CPU Thresholding Notification
•How to Configure CPU Thresholding Notification
•Configuration Examples for CPU Thresholding Notification
CPU utilization averages are computed by Cisco IOS software using a 4-millisecond Network-to-Management Interface (NMI) tick. In the unlikely event where the traffic rate is a multiple of this tick rate over a prolonged period of time, the CPU Thresholding Notification feature may not accurately measure the CPU load.
The CPU Thresholding Notification feature allows you to configure CPU utilization thresholds that, when crossed, trigger a notification. Two types of CPU utilization threshold are supported:
A rising CPU utilization threshold specifies the percentage of CPU resources that, when exceeded for a configured period of time, triggers a CPU threshold notification.
A falling CPU utilization threshold specifies the percentage of CPU resources that, when CPU usage falls below this level for a configured period of time, triggers a CPU threshold notification.
This section contains the following procedures:
•Enabling CPU Thresholding Notification
•Defining CPU Thresholding Notification
•Setting the Entry Limit and Size of CPU Utilization Statistics
To specify the recipient of SNMP notification operations and enable CPU thresholding notification, perform these steps:
1. enable
2. configure terminal
3. snmp-server enable traps cpu threshold
4. snmp-server host host-address [traps | informs] [version {1 | 2c | 3 [auth | noauth | priv]}] community-string [udp-port port] cpu [notification-type] [vrf vrf-name]
To define a rising and a falling CPU threshold notification, perform these steps:
1. enable
2. configure terminal
3. process cpu threshold type {total | process | interrupt} rising percentage interval seconds [falling percentage interval seconds]
To set the process entry limit and the size of the history table for CPU utilization statistics, perform these steps:
1. enable
2. configure terminal
3. process cpu statistics limit entry-percentage number [size seconds]
The following examples show how to set a rising and a falling CPU thresholding notification:
•Setting a Rising CPU Thresholding Notification: Example
•Setting a Falling CPU Thresholding Notification: Example
The following example shows how to set a rising CPU thresholding notification for total CPU utilization. When total CPU utilization exceeds 80 percent for a period of 5 seconds or longer, a rising threshold notification is sent.
Router(config)# process cpu threshold type total rising 80 interval 5
Note When the optional falling arguments (percentage and seconds) are not specified, they take on the same values as the rising arguments (percentage and seconds).
The following example shows how to set a falling CPU thresholding notification for total CPU utilization. When total CPU utilization, which at one point had risen above 80 percent and triggered a rising threshold notification, falls below 70 percent for a period of 5 seconds or longer, a falling threshold notification is sent.
Router(config)# process cpu threshold type total rising 80 interval 5 falling 70 interval 5
Note When the optional falling arguments (percentage and seconds) are not specified, they take on the same values as the rising arguments (percentage and seconds).
For additional information related to the CPU Thresholding Notification feature, refer to the following references:
|
|
---|---|
SNMP traps |
|
|
---|---|
No new or modified standards are supported by this feature and support for existing standards has not been modified by this feature. |
— |
|
|
---|---|
CISCO-PROCESS-MIB |
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL: |
|
|
---|---|
No new or modified RFCs are supported by this feature and support for existing RFCs has not been modified by this feature. |
— |
The following new and modified commands are pertinent to this feature. To see the command pages for these commands and other commands used with this feature, go to the Cisco IOS Master Commands List, Release 12.4, at http://www.cisco.com/en/US/docs/ios/mcl/124mainlinemcl/124_book.html.
•process cpu statistics limit entry-percentage
•process cpu threshold type
•snmp-server enable traps cpu
•snmp-server host