Configuring TCAM Threshold Based Alarms
The Ternary Content-Addressable Memory (TCAM) threshold based alarms feature generates syslog and consequently a Simple Network Management Protocol (SNMP) trap when an application reaches the preset threshold for its allotted TCAM size.
- Finding Feature Information
- New and Changed Information
- Information on TCAM Threshold Based Alarms
- Information on TCAM Threshold Based Alarm Frequency
- Configuring TCAM Threshold Based Alarms
- Verifying TCAM Threshold Based Alarms
- Additional References
Finding Feature Information
Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table at the end of this module.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
New and Changed Information
Feature | Description | Changed in Release | Where Documented |
---|---|---|---|
TCAM Threshold Based Alarms | This feature generates a Syslog and consequently a SNMP trap when the number of entries for an application on TCAM becomes equal or greater than a preset threshold level. | Cisco IOS XE Release 3.11S | |
TCAM Threshold Based Alarm Frequency | This enhancement configures the frequency at which the TCAM Threshold based alarm should be generated. | Cisco IOS XE Release 3.12 |
Information on TCAM Threshold Based Alarms
This feature generates a Syslog and consequently an SNMP trap when the number of entries for an application on TCAM becomes equal to or greater than the threshold percentage of the value defined in the license template. You can configure the threshold percentage value for notification before the TCAM limit specified by the license for an application is exhausted. The default threshold value for all TCAM applications is 80 percent. The frequency of the alert messages is rate limited to avoid flooding the router console when many entries are added or deleted in quick succession.
Note | This feature can be enabled or disabled using the platform tcam-threshold enable or no platform tcam-threshold enable command. |
Information on TCAM Threshold Based Alarm Frequency
This feature enables you to configure the frequency at which the TCAM Threshold Based alarm should be generated. You can configure the TCAM Threshold Based alarm frequency only if you have enabled the TCAM Threshold Based alarms.
Note | By default, the platform tcam-threshold alarm-frequency command appears in the router configuration file with the default alarm frequency value 1. |
Configuring TCAM Threshold Based Alarms
To configure TCAM threshold based alarms, complete the following steps:
1.
enable
2.
configure terminal
3.
platform tcam-threshold
enable [app-name |
all]
[threshold_percentage |
default]
4.
platform tcam-threshold
alarm-frequency [frequency-value |
default]
5.
end
DETAILED STEPS
Verifying TCAM Threshold Based Alarms
-
Use the show platform hardware pp active tcam utilization app-name detail asic-id command to display the TCAM utilization for the applications.
Following is a sample output using the show platform hardware pp active tcam utilization command to display the TCAM utilization for ACL application on ASIC 0:
Router# show platform hardware pp active tcam utilization acl detail 0
Router Tcam Utilization per Application and Region ES == Entry size == Number of 80 bit TCAM words App/Region Start Num Avail ES Region Range Used Range Num Used --------------------------------------------------------------------------------------------------- ACL 0x8000 0x1000 2 000000 000000 000000 000000 172 Scale limit: 4000 Threshold configured: 4% Current usage: 172 (4% approx.)
-
Use the show platform hardware pp active tcam usage command to display the alarm status for the applications:
Router# show platform hardware pp active tcam usage
TCAM Size: Num of 80 bit entries: 0x010000, Number of Blocks: 16 Nile Tcam Application Table New Column Thld Alarm State = 1 if Threshold alarm raised, 0 if alarm cleared App/Region Start Index Num Entries Entry Size Num Regions Profile ID Blk_sel_bits4 Bsb3 Bsb2 Bsb1 Thld Alarm S... ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- UCASTV4 000000 0x3000 1 34 19 0 0 0 0x7 1 MCASTV4 0x3000 0x1000 2 109 4 0 0 0 0x18 0 INGRESS_VLAN_TRANS 0x5000 0x1000 1 25 16 0 0 0 0x20 0
Additional References
Related Documents
Related Topic | Document Title |
---|---|
Cisco IOS Commands |
|
Cisco ASR 903 Router Configuration Guides |
Standards and RFCs
Standard/RFC | Title |
---|---|
None |
— |
MIBs
MIB | MIBs Link |
---|---|
None |
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL: |
Technical Assistance
Description | Link |
---|---|
The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies. To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds. Access to most tools on the Cisco Support website requires a Cisco.com user ID and password. |