Use this Knowledge Script to monitor the state of all interfaces in a device. This script tracks the values of ifAdminStatus and ifOperStatus for each interface across job iterations. If the operational status of an interface changes, an event is raised indicating the time the change occurred. This script also verifies whether ifAdminStatus and ifOperStatus are in sync.
The script attempts to track interface state on all SNMP devices on which the script is run, regardless of whether any previous attempts failed. If failures do occur, successful retrievals on other devices are not discarded.
This script collects separate data streams for each interface in a device. The data value saved is an integer representing the current operational state of each interface.
One or more SNMP Device objects
By default, this script runs every hour.
Set the following parameters as needed:
|
Parameter |
How to Set It |
|---|---|
|
SNMP Parameters |
|
|
List of interface indices |
By default, all interfaces are monitored. However, supplying a list of SNMP interface indices can restrict monitoring to those specific interfaces. Indices must be a single integer value. For example, "1 4 7" monitors only interfaces with an SNMP interface index of 1, 4 and 7. |
|
Maximum number of interfaces to monitor |
Specify the maximum number of interfaces to monitor. The default is 100. |
|
SNMP port number |
Specify the UDP port number on the remote SNMP device to which you want to send SNMP requests. The default is 161. |
|
SNMP retries |
Set the number of retries to attempt if a timeout occurs on an SNMP request. The default is 2 retries. |
|
SNMP timeout |
Set the number of seconds to wait for a response before timing out an SNMP request. The default is 5 seconds. |
|
Collect data for interface state? |
Set to Yes to collect data for use in graphs and reports. If enabled, returns a data stream for each interface in the device indicating its state. The default is unchecked. |
|
Event Notification |
|
|
Raise event if interface state mismatch detected? |
Set to Yes to raise an event if an interface has values for ifAdminStatus and ifOperStatus that are not the same. The details of the event contain the retrieved data. |
|
Event severity when interface state mismatch detected |
Set the event severity level, from 1 to 40, to indicate the importance of an event in which Interface State Mismatch exists. The default is 10. |
|
Raise event if interface state is up? |
Set to Yes to raise an event if an interface has transitioned to the Up state since the last Knowledge Script iteration. The details of the event contain the retrieved data. |
|
Event severity when interface state is up |
Set the severity level, from 1 to 40, to indicate the importance of an event in which the interface state is Up. The default is 25. |
|
Raise event if interface state is down? |
Set to Yes to raise an event if an interface has transitioned to the Down state since the last Knowledge Script iteration. The details of the event contain the retrieved data. |
|
Event severity when interface state is down |
Set the severity level, from 1 to 40, to indicate the importance of an event in which the interface state is Down. The default is 15. |
|
Raise event if SNMP timeout exceeded? |
Set to Yes to raise an event if the SNMP Get or GetNext request receives no response from the device, and all retries fail. |
|
Event severity when SNMP timeout exceeded |
Set the severity level, from 1 to 40, to indicate the importance of an event in which the SNMP timeout is exceeded. The default is 15. |
|
Raise event if SNMP Response error received? |
Set to Yes to raise an event if an SNMP Response error is received from the device. The type of error is reported in the event details. |
|
Event severity when SNMP Response error received |
Set the severity level, from 1 to 40, to indicate the importance of an event in which an SNMP Response error is received. The default is 10. |
|
Raise event if interface state baseline established? |
Set to Yes to raise an event when initial data values are retrieved, setting the baseline for comparison on the next retrieval. |
|
Event severity when interface state baseline established |
Set the severity level, from 1 to 40, to indicate the importance of an event in which baseline is established. The default severity level is 25. |