check_snmp_interface_status

Project Notes

This plugin is for monitoring the status of a Network interface using SNMP.

It will check if the interface is up, down or administratively down and generate an alert based on that.

Here are the instructions to update the plugin.

Download the check_snmp_interface_status.zip attached to the ticket and upload it to the system you want to install the plugin on.

The server may need to have development packages installed in the server.

For Centos / RHEL, these need to be installed.
yum install net-snmp-devel
yum install openssl-devel

For Ubuntu / Debian, these need to be installed.
apt-get install libssl-dev
apt-get install libsnmp-dev
apt-get install snmp-mibs-downloader

Upload the zip file to the server and extract it by running.
unzip check_snmp_interface_status.zip

Change the folder by running.
cd check_snmp_interface_status

To compile the plugin run the following.

make clean
make

To install the plugin (Default location is /usr/local/nagios/libexec) run the following.
make install

Make a backup of the Perl plugin.
cp /usr/local/nagios/libexec/check_ifoperstatus /usr/local/nagios/libexec/check_ifoperstatus.bak

Overwrite the Perl script with the C version.
cp /usr/local/nagios/libexec/check_snmp_interface_status /usr/local/nagios/libexec/check_ifoperstatus

At this point, the new plugin will be used.

FYI, the plugin may be reverted back to the perl version if you upgrade XI to a newer version.

Here is the help menu for the plugin showing the arguments is uses.
USAGE:check_snmp_interface -H HOST -C COMMUNITY -k interface number (Integer)

Options :
-H HOST Hostname/IP to query
-C COMMUNITY SNMP community name
-k Interface ifNumber Value
-d Interface ifDescr value
-n Interface ifName value
-w Generate Warning if interface is down
-f Output Performance Data
-a PROTOCOL set authentication protocol (MD5|SHA1)
-A PASSPHRASE set authentication protocol pass phrase
-L LEVEL set security level (noAuthNoPriv|authNoPriv|authPriv)
-U USER-NAME set security name (e.g. SNMPv3User)
-P PROTOCOL set privacy protocol (DES|AES)
-X PASSPHRASE set privacy protocol pass phrase
-t Timeout seconds before the plugin times out (default=6)
-p port SNMP port (default 161)
-D Admin Down i|w|c ignore(OK)|warn|crit if the interface is Admin Down(default critical)
-h -? Print this help
-V Print Version
-v VERSION SNMP VERSION=[1|2|3], (2 for SNMP v2c)(2 is default)