This documents describes Command Line Interface (CLI) description of count and low_count of the Simple Network Management Protocol (SNMP) Notification Threshold, snmp notif-threshold, in CLI Reference, StarOS is not clear. This article is intended to bring clarity to this command and its usage.
How Command SNMP Notif-Threshold Works?
The command syntax is as follows:
snmp notif-threshold <max-threshold> low <low-threshold> period <polling-period>
From this configuration, the traps creation rate is monitored periodically as configured by the period parameter. If the number of traps created over one period cycle exceeds the max-threshold value configured, then the trap creation is disabled. The trap creation is enabled again only if the number of trap creation drops below the <low-threshold> value configured else, trap creation remains disabled.
Example of Configuration
snmp notif-threshold 100 low 20 period 300
In the example, the maximum of 100 traps is set for every 300 seconds. The StarOS software releases 18.0 and earlier have 100 max threshold value while software releases 19.0 and higher have 300 max threshold value. If a chassis receives more than 100 traps within a 300 seconds period then the SNMP traps are disabled. Later on, if the chassis receives 20 traps (or less) within a 300 second period the chassis enables the SNMP traps again. If the trap generation remains for a value higher than 20 traps in a 300 second period then the SNMP traps remains disabled.
These commands can be used to check SNMP trap generation.
[local]ASR5500-2# show config | grep -i notif
snmp notif-threshold 1000 low 800 period 10
[local]ASR5500-2# show snmp trap statistics
SNMP Notification Statistics:
Total number of notifications : 2
Last notification sent : Tuesday October 07 12:00:27 CDT 2014
Notification sending is : enabled
Notifications have never been disabled
Notifications have never been cleared
Notifications in current period : 0
Notifications in previous period: 1
Notification monitor period : 10 seconds
SNMP server information
[local]ASR5500-2# show snmp server
SNMP Server Configuration:
Server State : enabled
SNMP Port : 161
authenticationFail traps : Disabled
Alert Threshold : 1000 alerts in 10 seconds
Alert Low Threshold : 800 alerts in 10 seconds