check_interfaces
check_interfaces - spong-network module to check for down intefaces via SNMP
This is a plugin module for the Spong the spong-network manpage program. It is a core
Spong module. The check_interfaces module checks for down network interfaces
on a host by polling via SNMP. It reports any interfaces that are
administratively up but operationally not up.
- Status
- If all interfaces are operationally up, a 'green' status is returned. If a host
is found to have no interfaces a 'yellow' status is returned. Any interfaces
that are operationally down and administratively up, a 'red' status is
returned. Any SNMP session problems will also result in a 'red' status being
returned.
- Summary Field
- In normal operation, the status field will show "all interfaces up". If one or
more network interfaces are down, it will show "some interfaces are down".
Otherwise the summary field will have a description of what the problem or
anamoly is.
- Detail Message Field
- In normal opereration the detail message field will have a list of all of the
network interfaces in the MIBII ifTable table along with the interface
description (ifDesc), type (ifType), administrative status
(ifAdminStatus) and operational status (ifOperStatus). Otherwise this
field will have a detailed description of the cause of an error.
- SNMP Community Name
- The default SNMP Community name is public. To override the default name
specify a
snmp_ community
attribute in a host's entry in the %HOSTS
variabile of the the spong.conf manpage configuration file. See the
the section on EXAMPLES elsewhere in this document for a detailed example.
%HOSTS = ( 'hostname.my-inc.com' => { 'services' => 'interfaces',
'ip_addr' => ['192.168.13.123'],
'community' => 'local-read',
},
);
the spong-network manpage, the check_snmp manpage,
spong-network Modules Template,
Spong Developer Guide
The check_interfaces module use SNMP to poll a host. It retrieves the
ifIndex, ifDesc, ifType, ifAdminStatus, and ifOperStatus fields
for every entry in the ifTable table. The module then scans all of all of
the network interfaces inretrieved from the table. Any interface that is
administratively up and is not operationally up will result in an critical
status (red) being return.
check_interfaces uses the SNMP_Session
, SNMP_utils
and BER
modules
from the SNMP_Session package. The SNMP_Session package must be installed
in order for this module to work.
The latest version of SNMP_Session package can be obtained from:
http://www.switch.ch/misc/leinen/snmp/perl/index.html
The original author is Mike Bayliss <mbayliss@datax.be
>. Extra debug code
and enhancements added by Stephen L Johnson <sjohnson@monsters.org
>.
[Top]
Generated by Pod::HTML 0.41 on Wed Nov 29 21:02:19 2000