You are on page 1of 8

Configuring CPU Threshold Notifications

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

Release

Modification

12.0(26)S

This feature was introduced.

12.3(4)T

This feature was integrated into Cisco IOS Release 12.3(4)T.

12.2(25)S

This feature was integrated into Cisco IOS Release 12.2(25)S.

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.

Contents

Restrictions for CPU Thresholding Notification, page 2

Information About CPU Thresholding Notification, page 2

How to Configure CPU Thresholding Notification, page 2

Configuration Examples for CPU Thresholding Notification, page 5

Additional References, page 7

Command Reference, page 8

Americas Headquarters:
Cisco Systems, Inc., 170 West Tasman Drive, San Jose, CA 95134-1706 USA

© 2007 Cisco Systems, Inc. All rights reserved.

triggers a CPU threshold notification. triggers a CPU threshold notification. trigger a notification. page 3 • Setting the Entry Limit and Size of CPU Utilization Statistics. when CPU usage falls below this level for a configured period of time. How to Configure CPU Thresholding Notification This section contains the following procedures: • Enabling CPU Thresholding Notification. the CPU Thresholding Notification feature may not accurately measure the CPU load. page 4 Enabling CPU Thresholding Notification To specify the recipient of SNMP notification operations and enable CPU thresholding notification. perform these steps: SUMMARY STEPS 2 1. page 2 Rising Threshold A rising CPU utilization threshold specifies the percentage of CPU resources that. enable 2. when crossed. when exceeded for a configured period of time. page 2 • Defining CPU Thresholding Notification. Falling Threshold A falling CPU utilization threshold specifies the percentage of CPU resources that. Two types of CPU utilization threshold are supported: • Rising Threshold. In the unlikely event where the traffic rate is a multiple of this tick rate over a prolonged period of time. page 2 • Falling Threshold.Configuring CPU Threshold Notifications Restrictions for CPU Thresholding Notification Restrictions for CPU Thresholding Notification CPU utilization averages are computed by Cisco IOS software using a 4-millisecond Network-to-Management Interface (NMI) tick. configure terminal 3. snmp-server enable traps cpu threshold . Information About CPU Thresholding Notification The CPU Thresholding Notification feature allows you to configure CPU utilization thresholds that.

0.168. Example: Router(config)# snmp-server enable traps cpu threshold Step 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] Sends CPU traps to the specified address. configure terminal 3. perform these steps: SUMMARY STEPS 1. • Enter your password if prompted. Example: Router(config)# snmp-server host 192. Example: Router# configure terminal Step 3 snmp-server enable traps cpu threshold Enables CPU thresholding violation notification as traps and inform requests.0 traps public cpu Defining CPU Thresholding Notification To define a rising and a falling CPU threshold notification. 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] DETAILED STEPS Step 1 Command or Action Purpose enable Enables privileged EXEC mode. enable 2. process cpu threshold type {total | process | interrupt} rising percentage interval seconds [falling percentage interval seconds] 3 . Example: Router> enable Step 2 configure terminal Enables global configuration mode.Configuring CPU Threshold Notifications How to Configure CPU Thresholding Notification 4.

Example: Router> enable Step 2 configure terminal Enters global configuration mode. perform these steps: SUMMARY STEPS 4 1. Setting the Entry Limit and Size of CPU Utilization Statistics To set the process entry limit and the size of the history table for CPU utilization statistics.Configuring CPU Threshold Notifications How to Configure CPU Thresholding Notification DETAILED STEPS Step 1 Command or Action Purpose enable Enables privileged EXEC mode. • Enter your password if prompted. Example: Router# configure terminal Step 3 process cpu threshold type {total | process | interrupt} rising percentage interval seconds [falling percentage interval seconds] Example: Router(config)# process cpu threshold type total rising 80 interval 5 falling 20 interval 5 Sets the CPU thresholding notifications types and values. enable 2. the CPU utilization threshold is set to 80 percent for a rising threshold notification and 20 percent for a falling threshold notification. configure terminal 3. • In this example. with a 5-second polling interval. process cpu statistics limit entry-percentage number [size seconds] .

Example: Router# configure terminal Step 3 process cpu statistics limit entry-percentage number [size seconds] Sets the process entry limit and the size of the history table for CPU utilization statistics. falls below 70 percent for a period of 5 seconds or longer. Example: Router> enable Step 2 configure terminal Enters global configuration mode. When total CPU utilization. 5 . a process must exceed 40 percent CPU utilization. • Enter your password if prompted. to generate an entry in the history table. page 5 • Setting a Falling CPU Thresholding Notification: Example. page 5 Setting a Rising CPU Thresholding Notification: Example The following example shows how to set a rising CPU thresholding notification for total CPU utilization. they take on the same values as the rising arguments (percentage and seconds). the duration of time for which the most recent history is saved in the history table is 300 seconds. Setting a Falling CPU Thresholding Notification: Example The following example shows how to set a falling CPU thresholding notification for total CPU utilization. When total CPU utilization exceeds 80 percent for a period of 5 seconds or longer. • In this example. Router(config)# process cpu threshold type total rising 80 interval 5 Note When the optional falling arguments (percentage and seconds) are not specified. a falling threshold notification is sent. which at one point had risen above 80 percent and triggered a rising threshold notification.Configuring CPU Threshold Notifications Configuration Examples for CPU Thresholding Notification DETAILED STEPS Step 1 Command or Action Purpose enable Enables privileged EXEC mode. • In this example. Example: Router(config)# process cpu statistics limit entry-percentage 40 size 300 Configuration Examples for CPU Thresholding Notification The following examples show how to set a rising and a falling CPU thresholding notification: • Setting a Rising CPU Thresholding Notification: Example. a rising threshold notification is sent.

.Configuring CPU Threshold Notifications Configuration Examples for CPU Thresholding Notification Router(config)# process cpu threshold type total rising 80 interval 5 falling 70 interval 5 Note 6 When the optional falling arguments (percentage and seconds) are not specified. they take on the same values as the rising arguments (percentage and seconds).

technologies. MIBs MIBs MIBs Link CISCO-PROCESS-MIB To locate and download MIBs for selected platforms. and tools. containing 30. including links to products.com/go/mibs RFCs RFCs Title No new or modified RFCs are supported by this feature — and support for existing RFCs has not been modified by this feature. and feature sets. http://www. Technical Assistance Description Link Technical Assistance Center (TAC) home page.000 pages of searchable technical content. Cisco IOS releases.com/public/support/tac/home. solutions. refer to the following references: Related Documents Related Topic Document Title SNMP traps Configuration Fundamentals Command Reference Standards Standards Title No new or modified standards are supported by this — feature and support for existing standards has not been modified by this feature. technical tips. Registered Cisco.cisco.com users can log in from this page to access even more content. use Cisco MIB Locator found at the following URL: http://www.shtml 7 .cisco.Configuring CPU Threshold Notifications Additional References Additional References For additional information related to the CPU Thresholding Notification feature.

WebEx. LightStream. MGX. and/or its affiliates in the United States and certain other countries. Any use of actual IP addresses in illustrative content is unintentional and coincidental. PowerPanels. Changing the Way We Work. PCNow. Catalyst. Cisco IOS. and Learn and Cisco Store are service marks. and Access Registrar. Cisco WebEx. 8 . the Cisco logo. Play. Cisco StadiumVision.com/en/US/docs/ios/mcl/124mainlinemcl/124_book. CCSP. Inc.html. Bringing the Meeting To You. EtherFast. The use of the word partner does not imply a partnership relationship between Cisco and any other company. go to the Cisco IOS Master Commands List. To see the command pages for these commands and other commands used with this feature. (0809R) Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. and Welcome to the Human Network are trademarks. Cisco Press. StackWise. TransPath. Any examples. CCIE. Aironet. PIX. CCDP. Cisco Unity.Configuring CPU Threshold Notifications Command Reference Command Reference The following new and modified commands are pertinent to this feature. CCIP. SMARTnet. Event Center. Network Registrar. Live. GigaDrive. Cisco Lumin. Internet Quotient. CCNA. Linksys. iPhone. • process cpu statistics limit entry-percentage • process cpu threshold type • snmp-server enable traps cpu • snmp-server host CCDE. © 2007 Cisco Systems. and the WebEx logo are registered trademarks of Cisco Systems. AsyncOS. the IronPort logo. IronPort. Networkers. All rights reserved. Spectrum Expert. Cisco. Cisco Nexus. at http://www. Networking Academy. CCDA. Inc. MediaTone. ProConnect. Follow Me Browsing. Cisco Systems. EtherSwitch. CCVP. command display output. MeetingPlace Chime Sound. All other trademarks mentioned in this document or website are the property of their respective owners. IOS. SenderBase. Fast Step. The Fastest Way to Increase Your Internet Quotient. Collaboration Without Limitation. MeetingPlace. and figures included in the document are shown for illustrative purposes only.4. ScriptShare.cisco. Release 12. CCNP. iQuick Study. Cisco Eos. CCENT. the Cisco Certified Internetwork Expert logo. Cisco TelePresence. FormShare. the Cisco Systems logo. DCE. HomeLink. Cisco Systems Capital.