debian/nagios-snmp-plugins
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity

New upstream version 2.1.0

Browse source
This commit is contained in:
Jan Wagner 2017-11-29 16:28:59 +01:00
parent e1ab4578a6
commit 75687e089f
37 changed files with 1333 additions and 8079 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

59
CHANGELOG.md Normal file
View file

@ -0,0 +1,59 @@
# Change Log
## [2.1.0](https://github.com/dnsmichi/manubulon-snmp/tree/2.1.0) (2017-10-12)
[Full Changelog](https://github.com/dnsmichi/manubulon-snmp/compare/v2.0.0...2.1.0)
**Implemented enhancements:**
- Cisco SMB switch [\#30](https://github.com/dnsmichi/manubulon-snmp/issues/30)
- Allow output for NagVis "weathermap" lines [\#22](https://github.com/dnsmichi/manubulon-snmp/issues/22)
- Enhance and write better documentation [\#40](https://github.com/dnsmichi/manubulon-snmp/pull/40) ([dnsmichi](https://github.com/dnsmichi))
- Escape dot in perfdata labels [\#39](https://github.com/dnsmichi/manubulon-snmp/pull/39) ([mj84](https://github.com/mj84))
- \[\#30\] add support for cisco small business switches \(tested with SG500\) [\#31](https://github.com/dnsmichi/manubulon-snmp/pull/31) ([spali](https://github.com/spali))
- Allow output for NagVis "weathermap" lines [\#26](https://github.com/dnsmichi/manubulon-snmp/pull/26) ([miken32](https://github.com/miken32))
- Add SNMP v3 authentication dependencies and distro-specific Perl module packages [\#23](https://github.com/dnsmichi/manubulon-snmp/pull/23) ([virtualtam](https://github.com/virtualtam))
**Fixed bugs:**
- check\_snmp\_load.pl =\> SNMPv3 do not use the -p \(port\) option [\#27](https://github.com/dnsmichi/manubulon-snmp/issues/27)
- Fix typos in documentation [\#29](https://github.com/dnsmichi/manubulon-snmp/pull/29) ([moepot](https://github.com/moepot))
- The -p \(port\) option was forgotten in some cases [\#28](https://github.com/dnsmichi/manubulon-snmp/pull/28) ([Niflou](https://github.com/Niflou))
- Fix check\_snmp\_int.pl temp file name [\#25](https://github.com/dnsmichi/manubulon-snmp/pull/25) ([waja](https://github.com/waja))
**Closed issues:**
- Have waiting info always [\#4](https://github.com/dnsmichi/manubulon-snmp/issues/4)
## [v2.0.0](https://github.com/dnsmichi/manubulon-snmp/tree/v2.0.0) (2016-11-25)
**Implemented enhancements:**
- check\_snmp\_load.pl - Linux load multiple CPUs [\#6](https://github.com/dnsmichi/manubulon-snmp/issues/6)
- Ignore DOWN state and big snmp requests [\#19](https://github.com/dnsmichi/manubulon-snmp/pull/19) ([SteScho](https://github.com/SteScho))
**Fixed bugs:**
- check\_snmp\_process.pl does not honour timeout \(-t\) [\#21](https://github.com/dnsmichi/manubulon-snmp/issues/21)
**Closed issues:**
- Apply a programming style to the plugins [\#20](https://github.com/dnsmichi/manubulon-snmp/issues/20)
- Get rid of utils.pm [\#10](https://github.com/dnsmichi/manubulon-snmp/issues/10)
- Net::SNMP version string no longer numeric in CentOS 7 [\#9](https://github.com/dnsmichi/manubulon-snmp/issues/9)
- fortigate 4.3 support for check\_snmp\_load [\#7](https://github.com/dnsmichi/manubulon-snmp/issues/7)
**Merged pull requests:**
- Not all Systems have connections [\#18](https://github.com/dnsmichi/manubulon-snmp/pull/18) ([SteScho](https://github.com/SteScho))
- Add the -A/--use-ifalias option to do name lookup from ifAlias [\#17](https://github.com/dnsmichi/manubulon-snmp/pull/17) ([darksoul42](https://github.com/darksoul42))
- pnp need perf-data with always same order [\#16](https://github.com/dnsmichi/manubulon-snmp/pull/16) ([SteScho](https://github.com/SteScho))
- pnp need perf-data with always same order [\#15](https://github.com/dnsmichi/manubulon-snmp/pull/15) ([SteScho](https://github.com/SteScho))
- Add -N/--use-ifname option to switch name lookup from ifDescr to ifName [\#14](https://github.com/dnsmichi/manubulon-snmp/pull/14) ([darksoul42](https://github.com/darksoul42))
- Fix, check\_snmtp\_load output [\#12](https://github.com/dnsmichi/manubulon-snmp/pull/12) ([casvcasv](https://github.com/casvcasv))
- making checks executable [\#8](https://github.com/dnsmichi/manubulon-snmp/pull/8) ([morgajel](https://github.com/morgajel))
- Add Cisco Nexus Devices capability for load [\#3](https://github.com/dnsmichi/manubulon-snmp/pull/3) ([pasancario](https://github.com/pasancario))
- Fix typo protcol vs. protocol [\#2](https://github.com/dnsmichi/manubulon-snmp/pull/2) ([waja](https://github.com/waja))
- Fix error writing tmp file using plugin with remote unix system [\#1](https://github.com/dnsmichi/manubulon-snmp/pull/1) ([TheCry](https://github.com/TheCry))
\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

0
plugins/LICENSE → LICENSE
View file

95
README.md
View file

@ -1,56 +1,89 @@
# Manubulon SNMP Plugins
## General information
#### Table of Contents
1. [About](#about)
2. [License](#license)
3. [Support](#support)
4. [Requirements](#requirements)
5. [Installation](#installation)
6. [Configuration](#configuration)
7. [FAQ](#faq)
8. [Thanks](#thanks)
9. [Contributing](#contributing)
## About
Manubulon SNMP plugins is a set of Icinga/Nagios plugins
to check hosts/devices using the SNMP protocol. Check
[http://nagios.manubulon.com](http://nagios.manubulon.com) for more details.
to check hosts/devices using the SNMP protocol.
This is a fork using a [cvs2git import](http://sourceforge.net/projects/nagios-snmp/develop) which includes community patches.
### Plugin Overview
The original project was last active in 2007 so this project
helps collect all patches and feature requests.
Plugin | Description
------------------------------|----------------------------------------
check\_snmp\_storage | Storage checks (disks, swap, memory, etc.)
check\_snmp\_int | Interface states, usage on hosts, switches, routers, etc.
check\_snmp\_process | Running processes, their number, used CPU and memory.
check\_snmp\_load | Load/CPU checks
check\_snmp\_mem | Memory and swap usage
check\_snmp\_env | Environmental status of fan, temp, power supplies.
check\_snmp\_vrrp | Interface state of a VRRP cluster
check\_snmp\_cpfw | Checkpoint Firewall-1 status
check\_snmp\_win | Windows services
check\_snmp\_css | CSS service states
check\_snmp\_nsbox | Nsbox VHost and diode status
check\_snmp\_boostedge | Boostedge services
check\_snmp\_linkproof\_ndr | Linkproof NHR
Feel free to use & distribute it under the original license.
## License
## Requirements
* perl in /usr/bin/perl
* Perl modules `Net::SNMP` and `Getopt::Long` (RHEL: `perl-Net-SNMP perl-Getopt-Long`)
* `icinga` user able to write files in /tmp/ directory
Perl, default directory and temp files location can be changed using the install.sh script.
`utils.pm` from `Monitoring::Plugin::Perl` is no longer required.
## Documentation
The original documentation and sourcecode is located at
[http://nagios.manubulon.com](http://nagios.manubulon.com).
A website copy was added underneath the `doc/` directory.
These plugins are licensed under the terms of the GNU General Public License.
You will find a copy of this license in the LICENSE file included in the source package.
## Support
You may create [GitHub issues](https://github.com/dnsmichi/manubulon-snmp)
as well. I do have a lot of things on my plate so best is to send in a tested (!) patch at the same time.
Join the [Icinga community channels](https://www.icinga.com/about/get-involved/) for questions.
If you want to help maintain this project, just contact
me on [twitter](https://twitter.com/dnsmichi) and I'll
happily grant commit access.
You may head over to [monitoring-portal.org community](http://www.monitoring-portal.org)
for questions and feedback.
## Requirements
The original support tracker is still located on [sourceforge](https://sourceforge.net/p/nagios-snmp/feature-requests/).
* Perl in `/usr/bin/perl`
* Perl modules
[Net::SNMP](http://search.cpan.org/~dtown/Net-SNMP-v6.0.1/lib/Net/SNMP.pm) and
[Getopt::Long](http://search.cpan.org/~jv/Getopt-Long-2.49.1/lib/Getopt/Long.pm)
* `icinga` user able to write files in /tmp/ directory
* SNMP v3 authentication: Perl modules
[Crypt::DES](http://search.cpan.org/~dparis/Crypt-DES-2.07/DES.pm),
[Crypt::Rijndael](http://search.cpan.org/~leont/Crypt-Rijndael-1.13/Rijndael.pm) and
[Digest::HMAC](http://search.cpan.org/~gaas/Digest-HMAC-1.03/lib/Digest/HMAC.pm)
## Development
## Installation
Fork this repository on Github and send in a PR.
Detailed installation instructions can be found [here](doc/02-Installation.md).
## Configuration
Proceed [here](doc/03-Configuration.md) to get details on the configuration with Icinga 2, Icinga 1.x, etc.
## FAQ
## Thanks
Patrick Proy for creating and maintaining the original plugins.
## Contributing
Fork this repository on GitHub and send in a PR.
There's a `.perltidyrc` file in the main repository tree. If you are uncertain about the coding style,
create your patch and then run:
$ perltidy -b plugins/*.pl
```
$ perltidy -b plugins/*.pl
```
This requires the `perltidy` module being installed.

30
doc/01-About.md Normal file
View file

@ -0,0 +1,30 @@
# About Manubulon SNMP Plugins <a href="manubulon-snmp-plugins-about"></a>
Manubulon SNMP plugins is a set of Icinga/Nagios plugins
to check hosts/devices using the SNMP protocol.
Please find more insights in the following chapters:
* [Installation](02-Installation.md)
* [Configuration](03-Configuration.md)
* [Plugins](04-Plugins.md)
## History <a href="manubulon-snmp-plugins-about-history"></a>
These plugins have been written by Patrick Proy several years ago.
Many community members still use them, but development and patches
stopped.
I've used these plugins in my previous job, and decided to fork them
into this repository. Many patches have been applied, and put into
official releases for packagers.
This is reflected by moving each plugin into a v2.x version although
there are not so many changes.
I don't have a test system/hardware nor do much with these plugins these days.
Still this repository allows community members to send in their patches
and discuss bugs and feature requests.

56
doc/02-Installation.md Normal file
View file

@ -0,0 +1,56 @@
# Manubulon SNMP Plugins Installation <a href="manubulon-snmp-plugins-installation"></a>
The plugins rely on the `Net::SNMP` Perl library for fetching
data from SNMP enabled hosts.
## Prerequisites <a href="manubulon-snmp-plugins-installation-required-prerequisites"></a>
### RHEL/CentOS EPEL Repository <a href="manubulon-snmp-plugins-installation-epel"></a>
RHEL/CentOS requires the EPEL repository:
```
yum -y install epel-release
yum makecache
```
If you are using RHEL you need enable the `optional` repository and then install
the [EPEL rpm package](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F).
## Perl Dependencies <a href="manubulon-snmp-plugins-installation-perl-dependencies"></a>
Debian/Ubuntu:
```
apt-get -y install libnet-snmp-perl libcrypt-des-perl libcrypt-rijndael-perl libdigest-hmac-perl
```
RHEL/CentOS/Fedora:
```
yum -y install perl-Net-SNMP perl-Getopt-Long perl-Crypt-DES perl-Crypt-Rijndael perl-Digest-HMAC
```
## Plugin Setup <a href="manubulon-snmp-plugins-installation-plugins"></a>
Debian/Ubuntu:
```
install -o root -g root -m750 plugins/*.pl /usr/lib/nagios/plugins/
```
RHEL/CentOS/Fedora:
```
install -o root -g root -m750 plugins/*.pl /usr/lib64/nagios/plugins/
```
Proceed with inspecting the plugins `--help` parameter in [this chapter](04-Plugins.md).
Next up: Integrate the plugins into your monitoring by adding [configuration](03-Configuration.md).
## Advanced Hints <a href="manubulon-snmp-plugins-installation-advanced"></a>
Perl, default directory and temp files location can be changed using the install.sh script.
`utils.pm` from `Monitoring::Plugin::Perl` is no longer required.

104
doc/03-Configuration.md Normal file
View file

@ -0,0 +1,104 @@
# Manubulon SNMP Plugins Configuration <a href="manubulon-snmp-plugins-configuration"></a>
Each plugin requires a command definition which defines the command line parameters
and arguments passed from service checks.
* [Icinga 2](03-Configuration.md#manubulon-snmp-plugins-configuration-icinga-2) integration
* [Icinga 1.x/Naemon/Nagios](03-Configuration.md#manubulon-snmp-plugins-configuration-icinga-1) integration
## Icinga 2 <a href="manubulon-snmp-plugins-configuration-icinga-2"></a>
The Icinga 2 Template Library (ITL) already provides many [CheckCommand definitions](https://www.icinga.com/docs/icinga2/latest/doc/10-icinga-template-library/#plugin-check-commands-for-manubulon-snmp)
out of the box. This enables you to just use the CheckCommand object and focus
on your service apply rules.
### Icinga 2: Best Practices <a href="manubulon-snmp-plugins-configuration-icinga-2-best-practices"></a>
Best practice is to store the credentials in a separate constant:
```
vim /etc/icinga2/constants.conf
const ManubulonSnmpCommunity = "icingasnmpro"
```
Define a generic SNMP service template and set common attributes.
```
template Service "snmp-template" {
vars.snmp_community = ManubulonSnmpCommunity
}
```
### Icinga 2: Apply Rules <a href="manubulon-snmp-plugins-configuration-icinga-2-apply"></a>
Define service apply rules like this:
```
apply Service "snmp-memory" {
import "snmp-template"
check_command = "snmp-memory"
vars.snmp_warn = "50,0"
vars.snmp_crit = "80,0"
assign where "snmp" in host.groups
}
apply Service "snmp-storage /var" {
import "snmp-template"
check_command = "snmp-storage"
vars.snmp_warn = "50"
vars.snmp_crit = "80"
vars.snmp_storage_name = "/var"
assign where "snmp" in host.groups
}
apply Service "snmp-storage" {
import "snmp-template"
check_command = "snmp-storage"
vars.snmp_warn = "50"
vars.snmp_crit = "80"
assign where "snmp" in host.groups
}
```
### Icinga 2: Apply For Rules <a href="manubulon-snmp-plugins-configuration-icinga-2-apply-for"></a>
A more complex example using apply for rules is to store the
monitored storage disks on the host. This allows to generate
service objects in a more efficient way.
```
object Host "snmp-host" {
check_command = "hostalive"
vars.snmp_storage["/"] = {
snmp_warn = "80"
snmp_crit = "90"
}
vars.snmp_storage["/var"] = {
snmp_warn = "60"
snmp_crit = "90"
}
}
apply Service "snmp-storage-" for (storage_name => config in host.vars.snmp_storage) {
import "snmp-template"
display_name = "Storage: " + storage_name
vars += config
vars.snmp_storage_name = storage_name
}
```
## Icinga 1.x/Naemon/Nagios <a href="manubulon-snmp-plugins-configuration-icinga-1"></a>
You need to write a check command definition and use that in your service definitions.
Please refer to [this documentation](http://nagios.manubulon.com/index_commands.html).

891
doc/04-Plugins.md Normal file
View file

@ -0,0 +1,891 @@
# Manubulon SNMP Plugins <a href="manubulon-snmp-plugins"></a>
## Plugin Overview
Plugin | Description
----------------------------------------------------------------------|----------------------------------------
[check_snmp_storage](04-Plugins.md#manubulon-snmp-plugins-storage) | Storage checks (disks, swap, memory, etc.)
[check_snmp_int](04-Plugins.md#manubulon-snmp-plugins-int) | Interface states, usage on hosts, switches, routers, etc.
[check_snmp_process](04-Plugins.md#manubulon-snmp-plugins-process) | Running processes, their number, used CPU and memory.
[check_snmp_load](04-Plugins.md#manubulon-snmp-plugins-load) | Load/CPU checks
[check_snmp_mem](04-Plugins.md#manubulon-snmp-plugins-mem) | Memory and swap usage
[check_snmp_env](04-Plugins.md#manubulon-snmp-plugins-env) | Environmental status of fan, temp, power supplies.
[check_snmp_vrrp](04-Plugins.md#manubulon-snmp-plugins-vrrp) | Interface state of a VRRP cluster
[check_snmp_cpfw](04-Plugins.md#manubulon-snmp-plugins-cpfw) | Checkpoint Firewall-1 status
[check_snmp_win](04-Plugins.md#manubulon-snmp-plugins-win) | Windows services
[check_snmp_css](04-Plugins.md#manubulon-snmp-plugins-css) | CSS service states
[check_snmp_nsbox](04-Plugins.md#manubulon-snmp-plugins-nsbox) | Nsbox VHost and diode status
[check_snmp_boostedge](04-Plugins.md#manubulon-snmp-plugins-hostedge) | Boostedge services
[check_snmp_linkproof_ndr](04-Plugins.md#manubulon-snmp-plugins-ndr) | Linkproof NHR
## check\_snmp\_storage<a href="manubulon-snmp-plugins-storage"></a>
```
$ ./check_snmp_storage.pl --help
SNMP Disk Monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
(c)2004-2007 Patrick Proy
Usage: check_snmp_storage [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) [-p <port>] [-P <protocol>] -m <name in desc_oid> [-q storagetype] -w <warn_level> -c <crit_level> [-t <timeout>] [-T pl|pu|bl|bu ] [-r -s -i -G] [-e] [-S 0|1[,1,<car>]] [-o <octet_length>] [-R <% reserved>]
By default, plugin will monitor %used on drives :
warn if %used > warn and critical if %used > crit
-v, --verbose
print extra debugging information (and lists all storages)
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies SNMP v1)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-x, --passwd=PASSWD
Password for snmpv3 authentication
-p, --port=PORT
SNMP port (Default 161)
-P, --protocol=PROTOCOL
Network protocol to be used
['udp/ipv4'] : UDP over IPv4
'udp/ipv6' : UDP over IPv6
'tcp/ipv4' : TCP over IPv4
'tcp/ipv6' : TCP over IPv6
-m, --name=NAME
Name in description OID (can be mounpoints '/home' or 'Swap Space'...)
This is treated as a regexp : -m /var will match /var , /var/log, /opt/var ...
Test it before, because there are known bugs (ex : trailling /)
No trailing slash for mountpoints !
-q, --storagetype=[Other|Ram|VirtualMemory|FixedDisk|RemovableDisk|FloppyDisk
CompactDisk|RamDisk|FlashMemory|NetworkDisk]
Also check the storage type in addition of the name
It is possible to use regular expressions ( "FixedDisk|FloppyDisk" )
-r, --noregexp
Do not use regexp to match NAME in description OID
-s, --sum
Add all storages that match NAME (used space and total space)
THEN make the tests.
-i, --index
Parse index table instead of description table to select storage
-e, --exclude
Select all storages except the one(s) selected by -m
No action on storage type selection
-T, --type=TYPE
pl : calculate percent left
pu : calculate percent used (Default)
bl : calculate MegaBytes left
bu : calculate MegaBytes used
-w, --warn=INTEGER
percent / MB of disk used to generate WARNING state
you can add the % sign
-c, --critical=INTEGER
percent / MB of disk used to generate CRITICAL state
you can add the % sign
-R, --reserved=INTEGER
% reserved blocks for superuser
For ext2/3 filesystems, it is 5% by default
-G, --gigabyte
output, warning & critical levels in gigabytes
-f, --perfparse, --perfdata
Performance data output
-S, --short=<type>[,<where>,<cut>]
<type>: Make the output shorter :
0 : only print the global result except the disk in warning or critical
ex: "< 80% : OK"
1 : Don't print all info for every disk
ex : "/ : 66 %used (< 80) : OK"
<where>: (optional) if = 1, put the OK/WARN/CRIT at the beginning
<cut>: take the <n> first caracters or <n> last if n<0
-o, --octetlength=INTEGER
max-size of the SNMP message, usefull in case of Too Long responses.
Be carefull with network filters. Range 484 - 65535, default are
usually 1472,1452,1460 or 1440.
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
Note :
with T=pu or T=bu : OK < warn < crit
with T=pl ot T=bl : crit < warn < OK
If multiple storage are selected, the worse condition will be returned
i.e if one disk is critical, the return is critical
example :
Browse storage list : <script> -C <community> -H <host> -m <anything> -w 1 -c 2 -v
the -m option allows regexp in perl format :
Test drive C,F,G,H,I on Windows : -m ^[CFGHI]:
Test all mounts containing /var : -m /var
Test all mounts under /var : -m ^/var
Test only /var : -m /var -r
Test all swap spaces : -m ^Swap
Test all but swap spaces : -m ^Swap -e
```
## check\_snmp\_int <a href="manubulon-snmp-plugins-int"></a>
```
$ ./check_snmp_int.pl --help
SNMP Network Interface Monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
GPL license, (c)2004-2007 Patrick Proy
Usage: ./check_snmp_int.pl [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>) [-p <port>] -n <name in desc_oid> [-N -A -i -a -D --down] [-r] [-f[eSyY]] [-k[qBMGu] -g -w<warn levels> -c<crit levels> -d<delta>] [-o <octet_length>] [-t <timeout>] [-s] --label [-V]
-v, --verbose
print extra debugging information (including interface list on the system)
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies v1 protocol)
-l, --login=LOGIN ; -x, --passwd=PASSWD, -2, --v2c
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-2 : use snmp v2c
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-P, --port=PORT
SNMP port (Default 161)
-n, --name=NAME
Name in description OID (eth0, ppp0 ...).
This is treated as a regexp : -n eth will match eth0,eth1,...
Test it before, because there are known bugs (ex : trailling /)
-r, --noregexp
Do not use regexp to match NAME in description OID
-N, --use-ifname
Use IF-MIB::ifName as source for NIC name instead of IF-MIB::ifDescr
-A, --use-ifalias
Use IF-MIB::ifAlias as source for NIC name instead of IF-MIB::ifDescr
-i, --inverse
Make critical when up
-a, --admin
Use administrative status instead of operational
-D, --dormant
Dormant state is an OK state
--down
Down state is an OK state
-o, --octetlength=INTEGER
max-size of the SNMP message, usefull in case of Too Long responses.
Be carefull with network filters. Range 484 - 65535, default are
usually 1472,1452,1460 or 1440.
-f, --perfparse, --perfdata
Performance data output (no output when interface is down).
-W, --weather
Output data for "weathermap" lines in NagVis with performance data
-e, --error
Add error & discard to Perfparse output
-S, --intspeed
Include speed in performance output in bits/s
-y, --perfprct ; -Y, --perfspeed
-y : output performance data in % of max speed
-Y : output performance data in bits/s or Bytes/s (depending on -B)
-k, --perfcheck ; -q, --extperfcheck
-k check the input/ouput bandwidth of the interface
-q also check the error and discard input/output
--label
Add label before speed in output : in=, out=, errors-out=, etc...
-g, --64bits
Use 64 bits counters instead of the standard counters when checking
bandwidth & performance data for interface >= 1Gbps.
You must use snmp v2c or v3 to get 64 bits counters.
-d, --delta=seconds
make an average of <delta> seconds (default 300=5min)
-B, --kbits
Make the warning and critical levels in K|M|G Bits/s instead of K|M|G Bytes/s
-G, --giga ; -M, --mega ; -u, --prct
-G : Make the warning and critical levels in Gbps (with -B) or GBps
-M : Make the warning and critical levels in Mbps (with -B) or MBps
-u : Make the warning and critical levels in % of reported interface speed.
-w, --warning=input,output[,error in,error out,discard in,discard out]
warning level for input / output bandwidth (0 for no warning)
unit depends on B,M,G,u options
warning for error & discard input / output in error/min (need -q)
-c, --critical=input,output[,error in,error out,discard in,discard out]
critical level for input / output bandwidth (0 for no critical)
unit depends on B,M,G,u options
critical for error & discard input / output in error/min (need -q)
-s, --short=int
Make the output shorter : only the first <n> chars of the interface(s)
If the number is negative, then get the <n> LAST caracters.
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
Note : when multiple interface are selected with regexp,
all be must be up (or down with -i) to get an OK result.
```
## check\_snmp\_process <a href="manubulon-snmp-plugins-process"></a>
```
$ ./check_snmp_process.pl --help
SNMP Process Monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
GPL license, (c)2004-2006 Patrick Proy
Usage: ./check_snmp_process.pl [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd) [-p <port>] [-P <IP Protocol>] -n <name> [-w <min_proc>[,<max_proc>] -c <min_proc>[,max_proc] ] [-m<warn Mb>,<crit Mb> -a -u<warn %>,<crit%> -d<delta> ] [-t <timeout>] [-o <octet_length>] [-f -A -F ] [-r] [-V] [-g]
-v, --verbose
print extra debugging information (and lists all storages)
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies SNMP v1 or v2c with option)
-l, --login=LOGIN ; -x, --passwd=PASSWD, -2, --v2c
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-2 : use snmp v2c
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-p, --port=PORT
SNMP port (Default 161)
-P, --protocol=PROTOCOL
Network protocol to be used
['udp/ipv4'] : UDP over IPv4
'udp/ipv6' : UDP over IPv6
'tcp/ipv4' : TCP over IPv4
'tcp/ipv6' : TCP over IPv6
-n, --name=NAME
Name of the process (regexp)
No trailing slash !
-r, --noregexp
Do not use regexp to match NAME in description OID
-f, --fullpath
Use full path name instead of process name
(Windows doesn't provide full path name)
-A, --param
Add parameters to select processes.
ex : "named.*-t /var/named/chroot" will only select named process with this parameter
-F, --perfout
Add performance output
outputs : memory_usage, num_process, cpu_usage
-w, --warn=MIN[,MAX]
Number of process that will cause a warning
-1 for no warning, MAX must be >0. Ex : -w-1,50
-c, --critical=MIN[,MAX]
number of process that will cause an error (
-1 for no critical, MAX must be >0. Ex : -c-1,50
Notes on warning and critical :
with the following options : -w m1,x1 -c m2,x2
you must have : m2 <= m1 < x1 <= x2
you can omit x1 or x2 or both
-m, --memory=WARN,CRIT
checks memory usage (default max of all process)
values are warning and critical values in Mb
-a, --average
makes an average of memory used by process instead of max
-u, --cpu=WARN,CRIT
checks cpu usage of all process
values are warning and critical values in % of CPU usage
if more than one CPU, value can be > 100% : 100%=1 CPU
-d, --delta=seconds
make an average of <delta> seconds for CPU (default 300=5min)
-g, --getall
In some cases, it is necessary to get all data at once because
process die very frequently.
This option eats bandwidth an cpu (for remote host) at breakfast.
-o, --octetlength=INTEGER
max-size of the SNMP message, usefull in case of Too Long responses.
Be carefull with network filters. Range 484 - 65535, default are
usually 1472,1452,1460 or 1440.
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
Note :
CPU usage is in % of one cpu, so maximum can be 100% * number of CPU
example :
Browse process list : <script> -C <community> -H <host> -n <anything> -v
the -n option allows regexp in perl format :
All process of /opt/soft/bin : -n /opt/soft/bin/ -f
All 'named' process : -n named
```
## check\_snmp\_load <a href="manubulon-snmp-plugins-load"></a>
```
$ ./check_snmp_load.pl --help
SNMP Load & CPU Monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
GPL license, (c)2004-2007 Patrick Proy
Usage: ./check_snmp_load.pl [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) [-p <port>] [-P <protocol>] -w <warn level> -c <crit level> -T=[stand|netsl|netsc|as400|cisco|cata|cisg|nsc|fg|bc|nokia|hp|lp|hpux] [-f] [-t <timeout>] [-V]
-v, --verbose
print extra debugging information
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies v1 protocol)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-p, --port=PORT
SNMP port (Default 161)
-P, --protocol=PROTOCOL
Network protocol to be used
['udp/ipv4'] : UDP over IPv4
'udp/ipv6' : UDP over IPv6
'tcp/ipv4' : TCP over IPv4
'tcp/ipv6' : TCP over IPv6
Network protocol (Default udp/ipv4)
-w, --warn=INTEGER | INT,INT,INT
1 value check : warning level for cpu in percent (on one minute)
3 value check : comma separated level for load or cpu for 1min, 5min, 15min
-c, --crit=INTEGER | INT,INT,INT
critical level for cpu in percent (on one minute)
1 value check : critical level for cpu in percent (on one minute)
3 value check : comma separated level for load or cpu for 1min, 5min, 15min
-T, --type=stand|netsl|netsc|as400|cisco|cisg|bc|nokia|hp|lp
CPU check :
stand : standard MIBII (works with Windows),
can handle multiple CPU.
netsl : linux load provided by Net SNMP (1,5 & 15 minutes values)
netsc : cpu usage given by net-snmp (100-idle)
as400 : as400 CPU usage
cisco : Cisco CPU usage
n5k : Cisco Nexus CPU Usage
cata : Cisco catalyst CPU usage
cisg : Cisco small business (SG500) CPU usage (1,5 & 15 minutes values)
nsc : NetScreen CPU usage
fg : Fortigate CPU usage
bc : Bluecoat CPU usage
nokia : Nokia CPU usage
hp : HP procurve switch CPU usage
lp : Linkproof CPU usage
hpux : HP-UX load (1,5 & 15 minutes values)
-f, --perfparse, --perfdata
Performance data output
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
```
## check\_snmp\_mem <a href="manubulon-snmp-plugins-mem"></a>
```
$ ./check_snmp_load.pl --help
SNMP Load & CPU Monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
GPL license, (c)2004-2007 Patrick Proy
Usage: ./check_snmp_load.pl [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) [-p <port>] [-P <protocol>] -w <warn level> -c <crit level> -T=[stand|netsl|netsc|as400|cisco|cata|cisg|nsc|fg|bc|nokia|hp|lp|hpux] [-f] [-t <timeout>] [-V]
-v, --verbose
print extra debugging information
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies v1 protocol)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-p, --port=PORT
SNMP port (Default 161)
-P, --protocol=PROTOCOL
Network protocol to be used
['udp/ipv4'] : UDP over IPv4
'udp/ipv6' : UDP over IPv6
'tcp/ipv4' : TCP over IPv4
'tcp/ipv6' : TCP over IPv6
Network protocol (Default udp/ipv4)
-w, --warn=INTEGER | INT,INT,INT
1 value check : warning level for cpu in percent (on one minute)
3 value check : comma separated level for load or cpu for 1min, 5min, 15min
-c, --crit=INTEGER | INT,INT,INT
critical level for cpu in percent (on one minute)
1 value check : critical level for cpu in percent (on one minute)
3 value check : comma separated level for load or cpu for 1min, 5min, 15min
-T, --type=stand|netsl|netsc|as400|cisco|cisg|bc|nokia|hp|lp
CPU check :
stand : standard MIBII (works with Windows),
can handle multiple CPU.
netsl : linux load provided by Net SNMP (1,5 & 15 minutes values)
netsc : cpu usage given by net-snmp (100-idle)
as400 : as400 CPU usage
cisco : Cisco CPU usage
n5k : Cisco Nexus CPU Usage
cata : Cisco catalyst CPU usage
cisg : Cisco small business (SG500) CPU usage (1,5 & 15 minutes values)
nsc : NetScreen CPU usage
fg : Fortigate CPU usage
bc : Bluecoat CPU usage
nokia : Nokia CPU usage
hp : HP procurve switch CPU usage
lp : Linkproof CPU usage
hpux : HP-UX load (1,5 & 15 minutes values)
-f, --perfparse, --perfdata
Performance data output
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
michi@mbmif ~/coding/addons/manubulon-snmp/plugins (master *=) $ ./check_snmp_mem.pl --help
SNMP Memory Monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
GPL license, (c)2004-2007 Patrick Proy
Usage: ./check_snmp_mem.pl [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) [-p <port>] [-P <protocol>] -w <warn level> -c <crit level> [-I|-N|-E] [-f] [-m -b] [-t <timeout>] [-V]
-v, --verbose
print extra debugging information
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies SNMP v1 or v2c with option)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-p, --port=PORT
SNMP port (Default 161)
-P, --protocol=PROTOCOL
Network protocol to be used
['udp/ipv4'] : UDP over IPv4
'udp/ipv6' : UDP over IPv6
'tcp/ipv4' : TCP over IPv4
'tcp/ipv6' : TCP over IPv6
-w, --warn=INTEGER | INT,INT
warning level for memory in percent (0 for no checks)
Default (-N switch) : comma separated level for Real Memory and Swap
-I switch : warning level
-c, --crit=INTEGER | INT,INT
critical level for memory in percent (0 for no checks)
Default (-N switch) : comma separated level for Real Memory and Swap
-I switch : critical level
-N, --netsnmp (default)
check linux memory & swap provided by Net SNMP
-m, --memcache
include cached memory in used memory (only with Net-SNMP)
-b, --membuffer
exclude buffered memory in used memory (only with Net-SNMP)
-I, --cisco
check cisco memory (sum of all memory pools)
-E, --hp
check HP Procurve memory
-f, --perfdata
Performance data output
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
```
## check\_snmp\_env <a href="manubulon-snmp-plugins-env"></a>
```
$ ./check_snmp_env.pl --help
SNMP environmental Monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
GPL License, (c)2006-2007 Patrick Proy
Usage: ./check_snmp_env.pl [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) [-p <port>] -T (cisco|nokia|bc|iron|foundry|linux) [-F <rpm>] [-c <celcius>] [-f] [-t <timeout>] [-V]
-v, --verbose
print extra debugging information
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies v1 protocol)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-P, --port=PORT
SNMP port (Default 161)
-T, --type=cisco|nokia|bc|iron|foundry
Environemental check :
cisco : All Cisco equipements : voltage,temp,fan,power supply
(will try to check everything in the env mib)
nokia : Nokia IP platforms : fan and power supply
bc : BlueCoat platforms : fans, power supply, voltage, disks
iron : IronPort platforms : fans, power supply, temp
foundry : Foundry Network platforms : power supply, temp
linux : Net-SNMP with LM-SENSORS : temp, fan, volt, misc
-F, --fan=<rpm>
Minimum fan rpm value (only needed for 'iron' & 'linux')
-c, --celcius=<celcius>
Maximum temp in degree celcius (only needed for 'iron' & 'linux')
-f, --perfparse
Perfparse compatible output
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
```
## check\_snmp\_vrrp <a href="manubulon-snmp-plugins-vrrp"></a>
```
$ ./check_snmp_vrrp.pl --help
SNMP VRRP Monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
GPL license, (c)2004-2007 Patrick Proy
Usage: ./check_snmp_vrrp.pl [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) -s <master|backup|num,%> [-T <nokia|alteon|lp|nsc|ipsocluster|foundry>] [-p <port>] [-t <timeout>] [-V]
-v, --verbose
print extra debugging information
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies v1 protocol)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-P, --port=PORT
SNMP port (Default 161)
-T, --type=<nokia|alteon|lp|nsc|ipso>
Type of vrrp router to check
nokia (default) : Nokia vrrp. Should be working for most vrrp routers
alteon : for Alteon AD4 Loadbalancers
lp : Radware Linkproof
nsc : Nescreen (ScreenOS 5.x NSRP)
ipso : Nokia IPSO clustering
foundry : Foundry VRRP
-s, --state=master|backup|num,%
Nokia ipso clustering : number of members, max % assigned to nodes.
Other : check vrrp interface to be master or backup
-g, --long
Make output long even is all is OK
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
```
## check\_snmp\_cpfw <a href="manubulon-snmp-plugins-cpfw"></a>
```
$ ./check_snmp_cpfw.pl --help
SNMP Checkpoint FW-1 Monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
GPL License, (c)2004-2007 - Patrick Proy
Usage: ./check_snmp_cpfw.pl [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) [-s] [-w [-p=pol_name] [-c=warn,crit]] [-m] [-a [standby] ] [-f] [-p <port>] [-t <timeout>] [-V]
-v, --verbose
print extra debugging information (including interface list on the system)
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies v1 protocol)
2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-s, --svn
check for svn status
-w, --fw
check for fw status
-a, --ha[=standby]
check for ha status and node in "active" state
If using SecurePlatform and monitoring a standby unit, put "standby" too
-m, --mgmt
check for management status
-p, --policy=POLICY_NAME
check if installed policy is POLICY_NAME (must have -w)
-c, --connexions=WARN,CRIT
check warn and critical number of connexions (must have -w)
-f, --perfparse, --perfdata
performance data output (only works with -c)
-P, --port=PORT
SNMP port (Default 161)
-t, --timeout=INTEGER
timeout for SNMP (Default: Nagios default)
-V, --version
prints version number
```
## check\_snmp\_win <a href="manubulon-snmp-plugins-win"></a>
```
$ ./check_snmp_win.pl --help
SNMP Windows Monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
GPL license, (c)2004-2007 Patrick Proy
Usage: check_snmp_win [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd) [-p <port>] -n <name>[,<name2] [-T=service] [-r] [-s] [-N=<n>] [-t <timeout>] [-V]
-v, --verbose
print extra debugging information (and lists all services)
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies SNMP v1 or v2c with option)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN
Login for snmpv3 authentication (implies v3 protocol with MD5)
-x, --passwd=PASSWD
Password for snmpv3 authentication
-p, --port=PORT
SNMP port (Default 161)
-T, --type=service
Check type :
- service (default) checks service
-n, --name=NAME[,NAME2...]
Comma separated names of services (perl regular expressions can be used for every one).
By default, it is not case sensitive.
-N, --number=<n>
Compare matching services with <n> instead of the number of names provided.
-s, --showall
Show all services in the output, instead of only the non-active ones.
-r, --noregexp
Do not use regexp to match NAME in service description.
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
Note :
The script will return
OK if ALL services are in active state,
WARNING if there is more than specified (ex 2 service specified, 3 active services matching),
CRITICAL if at least one of them is non active.
The -n option will allows regexp in perl format
-n "service" will match 'service WINS' 'sevice DNS' etc...
It is not case sensitive by default : WINS = wins
```
## check\_snmp\_css <a href="manubulon-snmp-plugins-css"></a>
```
$ ./check_snmp_css.pl --help
SNMP Cisco CSS monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
(c)2004-2006 Patrick Proy
Usage: ./check_snmp_css.pl [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) -n <name> [-d directory] [-w <num>,<resp>,<conn> -c <num>,<resp>,<conn>] [-p <port>] [-f] [-t <timeout>] [-V]
-v, --verbose
print extra debugging information
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-n, --name=<name>
regexp to select service
-w, --warning=<num>,<resp>,<conn>
Optional. Warning level for
- minimum number of active & alive service
- average response time
- number of connexions
For no warnings, put -1 (ex : -w5,-1,3).
When using negative numbers, dont put space after "-w"
-d, --dir=<directory to put file>
Directory where the temp file with index, created by check_snmp_css_main.pl, can be found
If no directory is set, /tmp will be used
-c, --critical=<num>,resp>,<conn>
Optional. Critical levels (-1 for no critical levels)
See warning levels.
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies v1 protocol)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-P, --port=PORT
SNMP port (Default 161)
-f, --perfparse
Perfparse compatible output
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
```
## check\_snmp\_nsbox <a href="manubulon-snmp-plugins-nsbox"></a>
```
$ ./check_snmp_nsbox.pl --help
SNMP NetSecureOne Netbox monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
(c)2004-2006 Patrick Proy
Usage: ./check_snmp_nsbox.pl [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) -d <diode> -s <vhost> -n <ndiode>,<nvhost> [-p <port>] [-f] [-t <timeout>] [-V]
Check that diode and vhost selected by regexp are active.
-v, --verbose
print extra debugging information
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies v1 protocol)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-d, --diode=<diode>
Diode selection by regexp
-s, --vhost=<vhost>
Vhost selection by regexp
-n, --number=<ndiode>,<nvhost>
number of diode and vhost that must be up.
-P, --port=PORT
SNMP port (Default 161)
-f, --perfparse, --perfdata
Performance data output
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
```
## check\_snmp\_boostedge <a href="manubulon-snmp-plugins-boostedge"></a>
```
$ ./check_snmp_boostedge.pl --help
SNMP Boostedge service monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
GPL License, (c)2006-2007 Patrick Proy
Usage: ./check_snmp_boostedge.pl [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) -s <service> -n <number> [-p <port>] [-f] [-t <timeout>] [-V]
-v, --verbose
print extra debugging information
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies v1 protocol)
-s, --service=<service>
Regexp of service to select
-n, --number=<number>
Number of services selected that must be in running & enabled state
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-P, --port=PORT
SNMP port (Default 161)
-f, --perfparse, --perfdata
Performance data output
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
```
## check\_snmp\_linkproof\_nhr <a href="manubulon-snmp-plugins-linkproof-nhr"></a>
```
$ ./check_snmp_linkproof_nhr.pl --help
SNMP Radware Linkproof NHR monitor for Icinga/Nagios/Naemon/Shinken, Version 2.1.0
(c)2004-2006 Patrick Proy
Usage: ./check_snmp_linkproof_nhr.pl [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) [-p <port>] [-f] [-t <timeout>] [-V]
The plugin will test all nhr configured and will return
OK if all nhr are active
WARNING if one nhr at least is in "no new session" or "inactive" mode.
CRITICAL if all nhr are inactive.
-v, --verbose
print extra debugging information
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies v1 protocol)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=<authproto>,<privproto>
<authproto> : Authentication protocol (md5|sha : default md5)
<privproto> : Priv protocole (des|aes : default des)
-P, --port=PORT
SNMP port (Default 161)
-f, --perfparse, --perfdata
Performance data output
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
```

109
plugins/Changelog
View file

@ -1,109 +0,0 @@
################################
Release 1.1.2 / Jun 2007 :
Scripts, actual CVS version and changelog :
check_snmp_mem.pl : 1.3
check_snmp_vrrp.pl : 1.3
check_snmp_linkproof_nhr.pl : 1.1
check_snmp_process.pl : 1.7
- Added option to select process with his parameter
- Added option for performance output
- Corrected negative CPU when process restarts
- Added delta option for cpu average (-d option)
check_snmp_boostedge.pl : 1.2
check_snmp_nsbox.pl : 1.2
check_snmp_css_main.pl : 1.1
check_snmp_cpfw.pl : 1.7
check_snmp_int.pl : 1.22
- Correct speed query for interface > 4 Gbps
- Reduced snmp queries to 2 instead of 3 when perf data is on
- Bad maximum in perfdata when in Bps
- Added option to make dormant state OK
check_snmp_storage.pl : 1.10
- Return an UNKNOWN status when size/used/alloc is not defined in snmp
- Patch from Alexander Greiner-B?r to remove the reserved disk space for superuser on ext2/3 FS.
New -R option for this
- Added -G (giga) option for output & levels in Gigabytes
check_snmp_win.pl : 0.6
check_snmp_css.pl : 1.3
check_snmp_env.pl : 1.8
- Added test to check existence of some OIDs
check_snmp_load.pl : 1.11
- Corrected bug in performance output
- Added SIG{ALRM} sub and % sign in output
################################
Release 1.1.1 / April 2007 :
Added documentation in doc/ directory : (html format).
Scripts, actual CVS version and changelog :
check_snmp_mem.pl : 1.3
check_snmp_vrrp.pl : 1.3
check_snmp_linkproof_nhr.pl : 1.1
check_snmp_process.pl : 1.5
Makina Corpus contribs : snmpv3 enhancements, msg size parameter (-o)
check_snmp_boostedge.pl : 1.2 (No major changes)
check_snmp_nsbox.pl : 1.2 (No major changes)
check_snmp_css_main.pl : 1.1
check_snmp_cpfw.pl : 1.7
Added active/backup detection with SecureXL
Added SIG{ALRM} sub and small bug
check_snmp_int.pl : 1.18
Added bigint module to take care of 64 bits counters
check usage of snmp v2c or v3 when you use 64 bit counters (-g)
Added SIG{ALRM} sub
Added warning and critical levels in performance output
Added labels before in, out speed and errors (M. Berger contrib)
Added highperf counters option (-g)
Added SNMP packet length option (-o)
Added warning/critical levels in Mbps, MBps, Gbps, GBps options (-M, -G)
Added warning/critical levels in % of interface speed (-u)
Added performance output interface speed option (-S)
Added performance output in Bps or bps (-Y)
Added performance output in % of interface speed (-y)
Added port for snmpv3 (R. Leroy contrib)
check_snmp_storage.pl : 1.6
Makina Corpus contribs : snmpv3 port parameter, msg size parameter (-o)
check_snmp_win.pl : 0.6
check_snmp_css.pl : 1.3
check_snmp_env.pl : 1.7
Added SIG{ALRM} sub
Added voltage & temp checks on Cisco
Added Foundry checks
check_snmp_load.pl : 1.9
Added SIG{ALRM} sub and % sign in output
Bug in performance output
################################
Release 1.1 :
Added scripts :
- check_snmp_css_main : to get all services name and OID one time, then check only one OID with check_snmp_css. Reduces css cpu.
Corrected bugs :
- install.sh (Net::snmp detection)
- corrected bugs in check_snmp_css
- Added ironport checks in check_snmp_env
- Added hpux in check_snmp_load
- Bugs in check_snmp_int (specially for Windows).
Scripts and versions :
check_snmp_mem.pl : 1.3
check_snmp_vrrp.pl : 1.3
check_snmp_linkproof_nhr.pl : 1.1
check_snmp_process.pl : 1.4
check_snmp_boostedge.pl : 1.1
check_snmp_nsbox.pl : 1.1
check_snmp_css_main.pl : 1.1
check_snmp_cpfw.pl : 1.4
check_snmp_int.pl : 1.10
check_snmp_storage.pl : 1.5
check_snmp_win.pl : 0.6
check_snmp_css.pl : 1.3
check_snmp_env.pl : 1.4
check_snmp_load.pl : 1.9
################################
Release 1.0 :
Initial file release.

15
plugins/INSTALL
View file

@ -1,15 +0,0 @@
Installation:
-------------
You can simply copy the .pl files to the Nagios Plugin directory if
- Nagios plugins and utils.pm file are in /usr/local/nagios/libexec.
- You are sure Net::SNMP is installed. (Getopt::Long is standard).
- perl is in /usr/bin/perl
- Temp files can be written by Nagios in /tmp
You can also use the "install.sh" script provided in this directory to install the plugins.
Type : "./install.sh" to install all the plugins or "./install.sh <plugin name>" for a specific one.
The script will check for dependencies and ask for Nagios and temp directories.
It will modify the scripts depending on these answers and install the scripts.

50
plugins/README
View file

@ -1,50 +0,0 @@
Nagios SNMP plugins 1.1.2 README
------------------------------
Nagios SNMP plugins is a set of Nagios plugins to check hosts/devices using snmp protocol.
http://nagios.manubulon.com for more details.
Requirements:
-------------
- perl in /usr/bin/perl
- Net::SNMP and Getopt::Long
- File utils.pm in Nagios plugin directory (default /usr/local/nagios/libexec)
- Nagios user can write files in /tmp/ directory
Perl, default directory and temp files location can be changed using the install.sh script.
Installation:
-------------
Read INSTALL file
Help and support:
-----------------
Help files, config examples and FAQ in the doc/ directory
http://nagios.manubulon.com/
FAQ : http://nagios.manubulon.com/faq.html
Mailling list, forum : http://sourceforge.net/projects/nagios-snmp/
Legal stuff:
------------
Nagios SNMP plugins version 1.1.2, Copyright (C) 2004-2007 Patrick Proy (nagios at proy.org)
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 2 as
published by the Free Software Foundation.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
Nagios and the Nagios logo are registered trademarks of Ethan Galstad.

4
plugins/check_snmp_boostedge.pl
View file

@ -38,7 +38,7 @@ my $be_service_connect
# Globals
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
my $o_host = undef; # hostname
my $o_community = undef; # community
@ -247,6 +247,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthNoPriv login : $o_login, $o_authproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,
@ -257,6 +258,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthPriv login : $o_login, $o_authproto, $o_privproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,

2
plugins/check_snmp_cpfw.pl
View file

@ -1,6 +1,6 @@
#!/usr/bin/perl -w
############################## check_snmp_cpfw ##############
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
# Date : Oct 20 2007
# Author : Patrick Proy (patrick at proy.org)

4
plugins/check_snmp_css.pl
View file

@ -35,7 +35,7 @@ my @css_svc_state_nag = (3, 2, 2, 3, 0, 2);
# Globals
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
my $o_host = undef; # hostname
my $o_community = undef; # community
@ -326,6 +326,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthNoPriv login : $o_login, $o_authproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,
@ -336,6 +337,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthPriv login : $o_login, $o_authproto, $o_privproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,

4
plugins/check_snmp_css_main.pl
View file

@ -35,7 +35,7 @@ my @css_svc_state_nag = (3, 2, 2, 3, 0, 2);
# Globals
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
my $o_host = undef; # hostname
my $o_community = undef; # community
@ -205,6 +205,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthNoPriv login : $o_login, $o_authproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,
@ -215,6 +216,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthPriv login : $o_login, $o_authproto, $o_privproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,

4
plugins/check_snmp_env.pl
View file

@ -167,7 +167,7 @@ my $linux_misc_value = "1.3.6.1.4.1.2021.13.16.4.1.3"; # misc entry value
# Globals
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
my $o_host = undef; # hostname
my $o_community = undef; # community
@ -383,6 +383,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthNoPriv login : $o_login, $o_authproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,
@ -393,6 +394,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthPriv login : $o_login, $o_authproto, $o_privproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,

46
plugins/check_snmp_int.pl
View file

@ -1,6 +1,6 @@
#!/usr/bin/perl -w
############################## check_snmp_int ##############
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
# Date : Oct 10 2007
# Author : Patrick Proy ( patrick at proy.org )
@ -73,6 +73,7 @@ my $o_version = undef; # print version
my $o_noreg = undef; # Do not use Regexp for name
my $o_short = undef; # set maximum of n chars to be displayed
my $o_label = undef; # add label before speed (in, out, etc...).
my $o_weather = undef; # output "weathermap" data for NagVis
# Performance data options
my $o_perf = undef; # Output performance data
@ -229,6 +230,8 @@ sub help {
usually 1472,1452,1460 or 1440.
-f, --perfparse, --perfdata
Performance data output (no output when interface is down).
-W, --weather
Output data for "weathermap" lines in NagVis with performance data
-e, --error
Add error & discard to Perfparse output
-S, --intspeed
@ -353,7 +356,9 @@ sub check_options {
'delta:i' => \$o_delta,
'D' => \$o_dormant,
'dormant' => \$o_dormant,
'down' => \$o_down
'down' => \$o_down,
'W' => \$o_weather,
'weather' => \$o_weather
);
if (defined($o_help)) { help(); exit $ERRORS{"UNKNOWN"} }
if (defined($o_version)) { p_version(); exit $ERRORS{"UNKNOWN"} }
@ -418,6 +423,11 @@ sub check_options {
print_usage();
exit $ERRORS{"UNKNOWN"};
}
if (defined($o_weather) && !defined($o_perf)) {
print "Cannot output weathermap line data without -f option!\n";
print_usage();
exit $ERRORS{"UNKNOWN"};
}
if (defined($o_perfr) && defined($o_perfp)) {
print "-Y and -y options are exclusives\n";
print_usage();
@ -718,7 +728,7 @@ for (my $i = 0; $i < $num_int; $i++) {
if (defined($o_checkperf) && $int_status == 1) {
$temp_file_name = $descr[$i];
$temp_file_name =~ s/[ ;\/]/_/g;
$temp_file_name = $o_base_dir . $o_host . "." . $temp_file_name;
$temp_file_name = $o_base_dir . $o_host . "." . $o_port . "." . $temp_file_name;
# First, read entire file
my @ret_array = read_file($temp_file_name, $n_items_check);
@ -904,12 +914,12 @@ for (my $i = 0; $i < $num_int; $i++) {
$warn_factor /= $speed_real;
$warn_factor *= 100; # now turn into displayed % : 0,1 = 10%
}
$perf_out .= "'" . $descr[$i] . "_in_prct'=";
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_in_prct'=";
$perf_out .= sprintf("%.0f", $checkperf_out_raw[0] * 800 / $speed_real) . "%;";
$perf_out .= ($o_warn[0] != 0) ? sprintf("%.0f", $o_warn[0] * $warn_factor) . ";" : ";";
$perf_out .= ($o_crit[0] != 0) ? sprintf("%.0f", $o_crit[0] * $warn_factor) . ";" : ";";
$perf_out .= "0;100 ";
$perf_out .= "'" . $descr[$i] . "_out_prct'=";
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_out_prct'=";
$perf_out .= sprintf("%.0f", $checkperf_out_raw[1] * 800 / $speed_real) . "%;";
$perf_out .= ($o_warn[1] != 0) ? sprintf("%.0f", $o_warn[1] * $warn_factor) . ";" : ";";
$perf_out .= ($o_crit[1] != 0) ? sprintf("%.0f", $o_crit[1] * $warn_factor) . ";" : ";";
@ -925,12 +935,12 @@ for (my $i = 0; $i < $num_int; $i++) {
} else { # just convert from K|M|G bps
$warn_factor = (defined($o_meg)) ? 1000000 : (defined($o_gig)) ? 1000000000 : 1000;
}
$perf_out .= "'" . $descr[$i] . "_in_bps'=";
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_in_bps'=";
$perf_out .= sprintf("%.0f", $checkperf_out_raw[0] * 8) . ";";
$perf_out .= ($o_warn[0] != 0) ? $o_warn[0] * $warn_factor . ";" : ";";
$perf_out .= ($o_crit[0] != 0) ? $o_crit[0] * $warn_factor . ";" : ";";
$perf_out .= "0;" . $speed_real . " ";
$perf_out .= "'" . $descr[$i] . "_out_bps'=";
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_out_bps'=";
$perf_out .= sprintf("%.0f", $checkperf_out_raw[1] * 8) . ";";
$perf_out .= ($o_warn[1] != 0) ? $o_warn[1] * $warn_factor . ";" : ";";
$perf_out .= ($o_crit[1] != 0) ? $o_crit[1] * $warn_factor . ";" : ";";
@ -942,28 +952,32 @@ for (my $i = 0; $i < $num_int; $i++) {
} else { # just convert from K|M|G bps
$warn_factor = (defined($o_meg)) ? 1048576 : (defined($o_gig)) ? 1073741824 : 1024;
}
$perf_out .= "'" . $descr[$i] . "_in_Bps'=" . sprintf("%.0f", $checkperf_out_raw[0]) . ";";
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_in_Bps'=" . sprintf("%.0f", $checkperf_out_raw[0]) . ";";
$perf_out .= ($o_warn[0] != 0) ? $o_warn[0] * $warn_factor . ";" : ";";
$perf_out .= ($o_crit[0] != 0) ? $o_crit[0] * $warn_factor . ";" : ";";
$perf_out .= "0;" . $speed_real / 8 . " ";
$perf_out .= "'" . $descr[$i] . "_out_Bps'=" . sprintf("%.0f", $checkperf_out_raw[1]) . ";";
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_out_Bps'=" . sprintf("%.0f", $checkperf_out_raw[1]) . ";";
$perf_out .= ($o_warn[1] != 0) ? $o_warn[1] * $warn_factor . ";" : ";";
$perf_out .= ($o_crit[1] != 0) ? $o_crit[1] * $warn_factor . ";" : ";";
$perf_out .= "0;" . $speed_real / 8 . " ";
}
}
} else { # output in octet counter
$perf_out .= "'" . $descr[$i] . "_in_octet'=" . $$result{ $oid_perf_inoct[$i] } . "c ";
$perf_out .= "'" . $descr[$i] . "_out_octet'=" . $$result{ $oid_perf_outoct[$i] } . "c ";
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_in_octet'=" . $$result{ $oid_perf_inoct[$i] } . "c ";
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_out_octet'=" . $$result{ $oid_perf_outoct[$i] } . "c ";
}
if (defined($o_perfe)) {
$perf_out .= "'" . $descr[$i] . "_in_error'=" . $$result{ $oid_perf_inerr[$i] } . "c ";
$perf_out .= "'" . $descr[$i] . "_in_discard'=" . $$result{ $oid_perf_indisc[$i] } . "c ";
$perf_out .= "'" . $descr[$i] . "_out_error'=" . $$result{ $oid_perf_outerr[$i] } . "c ";
$perf_out .= "'" . $descr[$i] . "_out_discard'=" . $$result{ $oid_perf_outdisc[$i] } . "c ";
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_in_error'=" . $$result{ $oid_perf_inerr[$i] } . "c ";
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_in_discard'=" . $$result{ $oid_perf_indisc[$i] } . "c ";
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_out_error'=" . $$result{ $oid_perf_outerr[$i] } . "c ";
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_out_discard'=" . $$result{ $oid_perf_outdisc[$i] } . "c ";
}
if (defined($o_perfs)) {
$perf_out .= "'" . $descr[$i] . "_speed_bps'=" . $speed_real;
$perf_out .= "'" . $descr[$i] =~ s/\./_/r . "_speed_bps'=" . $speed_real . " ";
}
if (defined($o_weather) && $usable_data == 1) {
$perf_out .= "in=" . sprintf("%.0f", $checkperf_out_raw[0]) . ";;;0;" . sprintf("%.0f", $speed_real / 8) . " ";
$perf_out .= "out=" . sprintf("%.0f", $checkperf_out_raw[1]) . ";;;0;" . sprintf("%.0f", $speed_real / 8) . " ";
}
}
}

4
plugins/check_snmp_linkproof_nhr.pl
View file

@ -29,7 +29,7 @@ my $lp_port = "1.3.6.1.4.1.89.35.1.38.1.1.15"; # nhr users
# Globals
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
my $o_host = undef; # hostname
my $o_community = undef; # community
@ -210,6 +210,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthNoPriv login : $o_login, $o_authproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,
@ -220,6 +221,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthPriv login : $o_login, $o_authproto, $o_privproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,

78
plugins/check_snmp_load.pl
View file

@ -1,6 +1,6 @@
#!/usr/bin/perl -w
############################## check_snmp_load #################
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
# Date : Oct 12 2007
# Author : Patrick Proy ( patrick at proy.org)
@ -44,6 +44,12 @@ my $ciscocata_cpu_5m = ".1.3.6.1.4.1.9.9.109.1.1.1.1.5.9"; # Cisco CPU load (
my $ciscocata_cpu_1m = ".1.3.6.1.4.1.9.9.109.1.1.1.1.3.9"; # Cisco CPU load (1min %)
my $ciscocata_cpu_5s = ".1.3.6.1.4.1.9.9.109.1.1.1.1.4.9"; # Cisco CPU load (5sec %)
# Cisco small business (SG500) cpu/load
my $cisg_cpu_5m = "1.3.6.1.4.1.9.6.1.101.1.9.0"; # Cisco CPU load (5min %)
my $cisg_cpu_1m = "1.3.6.1.4.1.9.6.1.101.1.8.0"; # Cisco CPU load (1min %)
my $cisg_cpu_5s = "1.3.6.1.4.1.9.6.1.101.1.7.0"; # Cisco CPU load (5sec %)
# Netscreen cpu/load
my $nsc_cpu_5m = "1.3.6.1.4.1.3224.16.1.4.0"; # NS CPU load (5min %)
@ -89,7 +95,7 @@ my $hpux_load_15_min = "1.3.6.1.4.1.11.2.3.1.1.5.0";
# valid values
my @valid_types
= ("stand", "netsc", "netsl", "as400", "cisco", "cata", "nsc", "fg", "bc", "nokia", "hp", "lp", "hpux", "n5k");
= ("stand", "netsc", "netsl", "as400", "cisco", "cata", "cisg", "nsc", "fg", "bc", "nokia", "hp", "lp", "hpux", "n5k");
# CPU OID array
my %cpu_oid = (
@ -107,7 +113,7 @@ my $o_help = undef; # wan't some help ?
my $o_verb = undef; # verbose mode
my $o_version = undef; # print version
# check type : stand | netsc | netsl | as400 | cisco | cata | nsc | fg | bc | nokia | hp | lp | hpux
# check type : stand | netsc | netsl | as400 | cisco | cata | cisg | nsc | fg | bc | nokia | hp | lp | hpux
my $o_check_type = "stand";
# End compatibility
@ -133,7 +139,7 @@ sub p_version { print "check_snmp_load version : $VERSION\n"; }
sub print_usage {
print
"Usage: $0 [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) [-p <port>] [-P <protocol>] -w <warn level> -c <crit level> -T=[stand|netsl|netsc|as400|cisco|cata|nsc|fg|bc|nokia|hp|lp|hpux] [-f] [-t <timeout>] [-V]\n";
"Usage: $0 [-v] -H <host> -C <snmp_community> [-2] | (-l login -x passwd [-X pass -L <authp>,<privp>]) [-p <port>] [-P <protocol>] -w <warn level> -c <crit level> -T=[stand|netsl|netsc|as400|cisco|cata|cisg|nsc|fg|bc|nokia|hp|lp|hpux] [-f] [-t <timeout>] [-V]\n";
}
sub isnnum { # Return true if arg is not a number
@ -182,7 +188,7 @@ sub help {
critical level for cpu in percent (on one minute)
1 value check : critical level for cpu in percent (on one minute)
3 value check : comma separated level for load or cpu for 1min, 5min, 15min
-T, --type=stand|netsl|netsc|as400|cisco|bc|nokia|hp|lp
-T, --type=stand|netsl|netsc|as400|cisco|cisg|bc|nokia|hp|lp
CPU check :
stand : standard MIBII (works with Windows),
can handle multiple CPU.
@ -192,6 +198,7 @@ sub help {
cisco : Cisco CPU usage
n5k : Cisco Nexus CPU Usage
cata : Cisco catalyst CPU usage
cisg : Cisco small business (SG500) CPU usage (1,5 & 15 minutes values)
nsc : NetScreen CPU usage
fg : Fortigate CPU usage
bc : Bluecoat CPU usage
@ -315,6 +322,7 @@ sub check_options {
if ( ($o_check_type eq "netsl")
|| ($o_check_type eq "cisco")
|| ($o_check_type eq "cata")
|| ($o_check_type eq "cisg")
|| ($o_check_type eq "nsc")
|| ($o_check_type eq "hpux"))
{
@ -390,6 +398,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthNoPriv login : $o_login, $o_authproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,
@ -401,6 +410,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthPriv login : $o_login, $o_authproto, $o_privproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,
@ -681,6 +691,64 @@ if ($o_check_type eq "cata") {
exit $exit_val;
}
############## Cisco SG CPU check ################
if ($o_check_type eq "cisg") {
my @oidlists = ($cisg_cpu_5m, $cisg_cpu_1m, $cisg_cpu_5s);
my $resultat
= (is_legacy_snmp_version())
? $session->get_request(@oidlists)
: $session->get_request(-varbindlist => \@oidlists);
if (!defined($resultat)) {
printf("ERROR: Description table : %s.\n", $session->error);
$session->close;
exit $ERRORS{"UNKNOWN"};
}
$session->close;
if (!defined($$resultat{$cisg_cpu_5s})) {
print "No CPU information : UNKNOWN\n";
exit $ERRORS{"UNKNOWN"};
}
my @load = undef;
$load[0] = $$resultat{$cisg_cpu_5s};
$load[1] = $$resultat{$cisg_cpu_1m};
$load[2] = $$resultat{$cisg_cpu_5m};
print "CPU : $load[0] $load[1] $load[2] :";
$exit_val = $ERRORS{"OK"};
for (my $i = 0; $i < 3; $i++) {
if ($load[$i] > $o_critL[$i]) {
print " $load[$i] > $o_critL[$i] : CRITICAL";
$exit_val = $ERRORS{"CRITICAL"};
}
if ($load[$i] > $o_warnL[$i]) {
# output warn error only if no critical was found
if ($exit_val eq $ERRORS{"OK"}) {
print " $load[$i] > $o_warnL[$i] : WARNING";
$exit_val = $ERRORS{"WARNING"};
}
}
}
print " OK" if ($exit_val eq $ERRORS{"OK"});
if (defined($o_perf)) {
print " | load_5_sec=$load[0]%;$o_warnL[0];$o_critL[0] ";
print "load_1_min=$load[1]%;$o_warnL[1];$o_critL[1] ";
print "load_5_min=$load[2]%;$o_warnL[2];$o_critL[2]\n";
} else {
print "\n";
}
exit $exit_val;
}
############## Netscreen CPU check ################
if ($o_check_type eq "nsc") {

4
plugins/check_snmp_mem.pl
View file

@ -1,6 +1,6 @@
#!/usr/bin/perl -w
############################## check_snmp_mem ##############
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
# Date : 17 October 2007
# Author : Patrick Proy (nagios at proy.org)
@ -156,7 +156,7 @@ sub help {
-I, --cisco
check cisco memory (sum of all memory pools)
-E, --hp
check HP proccurve memory
check HP Procurve memory
-f, --perfdata
Performance data output
-t, --timeout=INTEGER

4
plugins/check_snmp_nsbox.pl
View file

@ -37,7 +37,7 @@ my $ns_rsa_oper_second = ".1.3.6.1.4.1.14020.1.1.3.4.0;"; # number of RSA operat
# Globals
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
my $o_host = undef; # hostname
my $o_community = undef; # community
@ -265,6 +265,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthNoPriv login : $o_login, $o_authproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,
@ -275,6 +276,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 AuthPriv login : $o_login, $o_authproto, $o_privproto");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,

2
plugins/check_snmp_process.pl
View file

@ -1,6 +1,6 @@
#!/usr/bin/perl -w
############################## check_snmp_process ##############
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
# Date : Oct 12 2007
# Author : Patrick Proy (patrick at proy dot org)

2
plugins/check_snmp_storage.pl
View file

@ -53,7 +53,7 @@ $hrStorage{"1.3.6.1.2.1.25.2.1.10"} = 'NetworkDisk';
# Globals
my $Name = 'check_snmp_storage';
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
my $o_host = undef; # hostname
my $o_community = undef; # community

2
plugins/check_snmp_vrrp.pl
View file

@ -1,6 +1,6 @@
#!/usr/bin/perl -w
############################## check_snmp_vrrp ##############
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
# Date : Oct 17 2007
# Author : Patrick Proy (patrick at proy.org)

3
plugins/check_snmp_win.pl
View file

@ -1,6 +1,6 @@
#!/usr/bin/perl -w
############################## check_snmp_win ##############
my $VERSION = "2.0.0";
my $VERSION = "2.1.0";
# Date : Oct 12 2007
# Author : Patrick Proy (patrick at proy.org)
@ -247,6 +247,7 @@ if (defined($o_login) && defined($o_passwd)) {
verb("SNMPv3 login");
($session, $error) = Net::SNMP->session(
-hostname => $o_host,
-port => $o_port,
-version => '3',
-username => $o_login,
-authpassword => $o_passwd,

256
plugins/doc/faq.html
View file

@ -1,256 +0,0 @@
<HTML>
<HEAD>
<TITLE>Nagios plugins</TITLE>
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
<STYLE type="text/css">
<!--
.Default { font-family: verdana,arial,serif; font-size: 10pt; }
.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
.Email { font-family: verdana,arial,serif; font-size: 10pt;}
.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
-->
</STYLE>
</HEAD>
<body background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
<!-- background="img/sideback.jpg" -->
<table border="0" height="1477">
<tr>
<td valign=top>
<!-- Begin Side Bar -->
<table border="0" width="125" valign=top>
<tr>
<td><a href="http://nagios.manubulon.com/" class="SideNavBarItem" >Home</a></td>
</tr>
<tr>
<td></td>
</tr>
<tr>
<td><BR>
</td>
</tr>
<tr>
<td> </td>
</tr>
</table>
<!-- End Side Bar -->
</td>
<td valign=top>
<table border="0" valign=top height="1452">
<tr>
<td class="ProgramTitle"> FAQ</td>
</tr>
<tr>
<td>
<p class="NewsItemDate">&nbsp;</p>
<p class="SectionTitle"> Last update : May 25 2007</p>
</td>
</tr>
<tr>
<td valign="top">
<p class="SectionTitle">&nbsp;</p>
<p class="SectionTitle"><b>FIRST, </b>look at the web page associated
with every script.</p>
<p class="SectionBody"><b>Running the scripts :</b></p>
<p class="SectionBody">- <a href="#FAQ1">The scripts outputs &quot;Can't
locate Net/SNMP.pm in @INC.....&quot;</a></p>
<p class="SectionBody">-<a href="#FAQ2"> How do I install Net::SNMP
perl module</a></p>
<p class="SectionBody">- <a href="#FAQ3">What are the supported platforms
to run the scripts on ?</a></p>
<p class="SectionBody">- <a href="#FAQ4">How do I get help on the
options ?</a></p>
<p class="SectionBody">- <a href="#FAQ5">Return code of X is out of
bounds</a></p>
<p class="SectionBody">- <a href="#FAQ6">Are these plugins compatible
with Nagios 2.0 ?</a></p>
<p class="SectionBody">- <a href="#FAQ7"> ERROR: XXXXXX : Expected
OBJECT IDENTIFIER in dotted notation. </a></p>
<p class="SectionBody">- <a href="#FAQ8">&quot;No Output&quot; using
Nagios 2</a></p>
<p class="SectionBody">- <a href="#FAQ9">Getting : &quot;ERROR: Size
table :Message size exceeded buffer maxMsgSize&quot;</a></p>
<p class="SectionBody">- <a href="#FAQ10">No usable data on file (X rows)</a></p>
<p class="SectionBody"><b>Misc<br>
</b></p>
<p class="SectionBody">- <a href="#FAQM3">Are these scripts secure
?</a></p>
<p class="SectionBody">- <a href="#FAQM1">How can I get help ? Is
there a mailling list ? a forum ?</a></p>
<p class="SectionBody">- <a href="#FAQM2">Can I donate to help this
project ?</a></p>
<hr>
<p class="SectionTitle"><a name="FAQ1"></a>The scripts outputs &quot;Can't
locate Net/SNMP.pm in @INC.....&quot;</p>
<p class="SectionBody">You don't have Net::SNMP installed, see below</p>
<p class="SectionTitle"><a name="FAQ2"></a>How do I install Net::SNMP
perl module ?</p>
<p class="SectionBody">There are 2 ways of doing this </p>
<p class="SectionBody"><b>1) By CPAN (best)</b></p>
<p class="SectionBody">on command line, as root : <br>
<br>
[your_host]# <b>perl -MCPAN -e shell</b><br>
cpan shell -- CPAN exploration and modules installation (v1.76)<br>
ReadLine support enabled<br>
cpan&gt; <b>install Net::SNMP</b><br>
</p>
<p class="SectionBody">If it's the first time you run CPAN, it will
probably ask you some (simple) questions.</p>
<p class="SectionBody">CPAN will also ask you to satisfy some dependencies
(Crypt::DES, Digest::MD5, etc..).</p>
<p class="SectionBody"><b>2) &quot;By hand&quot;</b><br>
</p>
<p class="SectionBody">Get the folowings modules (tar.gz format) on
<a href="http://www.cpan.org">www.cpan.org</a></p>
<p class="SectionBody">- Crypt::DES<br>
- Digest::MD5<br>
- Digest::SHA1<br>
- Digest::HMAC<br>
- Net::SNMP<br>
<br>
for each one (you must install Net::SNMP at the end) : <br>
<b>tar zxf &lt;module&gt;.tar.gz<br>
cd &lt;module&gt;<br>
perl Makefile.pl<br>
make test<br>
make install</b></p>
<p class="SectionTitle"><a name="FAQ3"></a>What are the supported
platforms to run the scripts on ?</p>
<p class="SectionBody">Most Linux, maybe some unixes and maybe Cygwin.<br>
Actually anything you can run perl on.<br>
If you can install the latest Net::SNMP module, then the perl version
should be OK.</p>
<p class="SectionTitle"><a name="FAQ4"></a>How do I get help on the
options ?</p>
<p class="SectionBody">Just run <b>&lt;script&gt; -h </b>on the command
line.<br>
<br>
</p>
<p class="SectionTitle"><a name="FAQ5"></a>Return code of X is out
of bounds</p>
<p class="SectionBody">Have a look at : <a href="http://www.nagios.org/faqs/viewfaq.php?faq_id=17">http://www.nagios.org/faqs/viewfaq.php?faq_id=17</a></p>
<p class="SectionBody">In case of return code 127, try putting perl
in the command line definition : </p>
<p class="SectionBody"> define command{<br>
command_name check_disk<br>
command_line <b>/usr/bin/perl</b> $USER1$/check_snmp_storage.pl
-C $ARG1$ [........]<br>
}<br>
</p>
<p class="SectionTitle"><a name="FAQ6"></a>Are these plugins compatible
with Nagios 2.0 ?</p>
<p class="SectionBody">Yes.</p>
<p class="SectionTitle"><a name="FAQ7"></a>ERROR: XXXXXX : Expected OBJECT IDENTIFIER in dotted notation.
</p>
<p class="SectionBody">Upgrade your Net::SNMP module version (5 is good, 4 maybe OK, 3 gives this error) <br>
This happens with Debian Woody (Net::SNMP version 3.6).<br>
I have special patches if you can't upgrade : contact me.</p>
<p class="SectionTitle"><a name="FAQ8"></a>&quot;No Output&quot; using
Nagios 2</p>
<p class="SectionBody">It's a &quot;bug&quot; of embeded perl. It
has been corrected in latest Nagios releases.</p>
<p class="SectionBody">You can :<br>
</p>
<p class="SectionBody">- Add a patch if your nagios release is old.
Here is a patch made by Gavin Carr for the p1.pl file to correct
this (it should be in nagios CVS shortly). <a href="http://nagios.manubulon.com/p1-print.pl.patch">http://nagios.manubulon.com/p1-print.pl.patch</a>
</p>
<p class="SectionBody">- Upgrade Nagios.<br>
<br>
- add &quot;/usr/bin/perl&quot; before the script command so Nagios
won't use embeded perl. </p>
<p class="SectionTitle"><a name="FAQ9"></a>Getting : &quot;ERROR:
Size table :Message size exceeded buffer maxMsgSize&quot;</p>
<p class="SectionBody">Your snmp table is too big.</p>
<p class="SectionBody">Some of my scripts (check_snmp_storage and
check_snmp_process) now have an option (-o) to set this directly
on command line (thx to Makina Corpus for the patch).</p>
<p class="SectionBody">In other scripts, try adding :</p>
<p class="SectionBody"> $session-&gt;max_msg_size(5000);<br>
</p>
<p class="SectionBody">After the session has been initialized. </p>
<p class="SectionTitle"><a name="FAQ10"></a>No usable data on file (X rows)</p>
<p class="SectionBody">Scripts like check_snmp_int need to store data when they get a SNMP counter so they can outpout readable data like bandwidth, cpu, etc....</p>
<p class="SectionBody">For example, to output a bandwidth with an octet counter, check_snmp_int will store data every time it is run. It will also read the previous data, and try to get data old enough to make a correct average. By default, it needs data which was produced 5 minutes ago.</p>
<p class="SectionBody">So, when you first run the script - or if you run it a long time ago -, it won't be able to get data old enough and will report an error (UNKNOWN status) saying the is &quot;no usable data on file (X rows)&quot;.<br>
If you leave the 5 minutes default delta value, the script will need data wich is : <br>
- At least 4 minutes and 30 seconds old (5 min - 10%)<br>
- At most 15 minutes old (3 * 5 min) </p>
<p class="SectionBody">You can change this 5 minutes value using the '-d &lt;sec&gt;' option. The script will then look for data which is at least &lt;sec&gt;-10% old and at most 3*&lt;sec&gt;. </p>
<p class="SectionBody">This option will only tell to make an average on &lt;sec&gt; seconds, you can run the service every minute with Nagios, it will always get the newest value which is at least &lt;sec&gt;-10% old.<br>
The only thing you must check is that your service will at least run every 15 minutes, or the script will always output &quot;unknown&quot; as the value will be too old for him. </p>
<p class="SectionTitle"><br>
<a name="FAQM3"></a>Are these scripts secure ?</p>
<p class="SectionBody">Not at all ! You must secure the Nagios server.<br>
Nobody else than the nagios user should be allowed to even think
about running these scripts.<br>
</p>
<p class="SectionTitle"><a name="FAQM1"></a>How can I get help ? Is
there a mailling list ? a forum ?</p>
<p class="SectionBody">Go to the sourceforge project page for all this : <a href=http://sourceforge.net/projects/nagios-snmp/>Nagios-snmp</a>
<p class="SectionBody"><a name="FAQM2"></a><span class="SectionTitle">Can
I donate to help this project ?</span></p>
<p class="SectionBody">Of course you can, I just haven't got any idea
of how, so just send a postcard to my son (Jolan) with a nice drawing (or buy a cookie to your son/daughter/nephew/grand-ma...).<br>
You can get my postal address on my resume (<a href="http://www.manubulon.com/cvpproy.htm">www.manubulon.com/cvpproy.htm</a>).<br>
He will answer you when he knows how to write (in several years).</p>
</td>
</tr>
<tr>
<td>
<p class="SectionBody">This project is also hosted by : <br>
<A href="http://sourceforge.net/projects/nagios-snmp/"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
</p></td>
</tr>
</table>
</td>
</tr>
</table>
<p>&nbsp;</p>
</BODY>
</HTML>

431
plugins/doc/index.html
View file

@ -1,431 +0,0 @@
<HTML>
<HEAD>
<TITLE>Nagios plugins</TITLE>
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
<STYLE type="text/css">
<!--
.Default { font-family: verdana,arial,serif; font-size: 10pt; }
.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
.Email { font-family: verdana,arial,serif; font-size: 10pt;}
.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
-->
</STYLE>
</HEAD>
<body background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
<table width="100%" border="0">
<tr>
<td width="127" valign=top height="1448">
<!-- Begin Side Bar -->
<table border="0" width="125" valign=top>
<tr>
<td><a class="SideNavBarHotItem" >This site :</a></td>
</tr>
<tr>
<td><a href="http://nagios.manubulon.com/" class="SideNavBarItem" >Home</a></td>
</tr>
<tr>
<td><a href="index_snmp.html" class="SideNavBarItem" >Nagios plugins</a></td>
</tr>
<tr>
<td><a href="index_info.html" class="SideNavBarItem" >Info on snmp</a></td>
</tr>
<tr>
<td><a href="index_commands.html" class="SideNavBarItem" > Nagios config</a></td>
</tr>
<tr>
<td><a href="faq.html" class="SideNavBarItem" > FAQ</a></td>
</tr>
<tr>
<td> <a href="http://sourceforge.net/projects/nagios-snmp/" class="SideNavBarItem" >
Project page on SourceForge</a> </td>
</tr>
<tr>
<td><font color="#FFFFFF">-----------</font></td>
</tr>
<tr>
<td><a class="SideNavBarHotItem" >Links :</a></td>
</tr>
<tr>
<td><a href="http://www.nagios.org/" class="SideNavBarItem" >Nagios
Home</a></td>
</tr>
<tr>
<td><a href="http://sourceforge.net/projects/nagiosplugins" class="SideNavBarItem" >Nagios
Plugins</a></td>
</tr>
<tr>
<td><a href="http://www.oreon.org" class="SideNavBarItem" >Oreon project</a></td>
</tr>
<tr>
<td><a href="http://www.nagiosexchange.org" class="SideNavBarItem" >NagiosExchange</a></td>
</tr>
<tr>
<td><a href="http://forums.opsyx.com/viewforum.php?f=1" class="SideNavBarItem" >Opsyx
forum</a></td>
</tr>
<tr>
<td><a href="http://forum.2037.org/" class="SideNavBarItem" >Forum 2037</a></td>
</tr>
<tr>
<td><font color="#FFFFFF">-----------</font></td>
</tr>
<tr>
<td> <A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&amp;type=3" width="110" height="37" border="0" alt="SourceForge.net Logo" /></A>
</td>
</tr>
</table>
<!-- End Side Bar -->
</td>
<td valign=top>
<table width="100%" border="0" valign=top>
<tr>
<td class="ProgramTitle"> My plugins for <img src="img/smalllogo7.jpg" border="0" alt="Nagios">
</td>
</tr>
<tr>
<td>
<p class="SectionTitle" align="right">Last update : Jun 9 2007</p>
<p class="SectionTitle" align="left">About </p>
<p class="SectionBody">The general idea of these scripts is to check
as many things as possible with snmp (how do you install NRPE on
Cisco or AS/400 ?) : disks, memory, load, interface, running procsses,
etc...<br>
</p>
<p class="SectionBody">The other idea is to select disks, interfaces,
process using regular expressions <br>
<br>
- it is possible to test more than one disk/int/process in one Nagios
check (ex : eth* instead of eth0,eth1,eth2,...)<br>
<br>
- you only have to provide a unique part of the name to select a
disk/int/process (ex : &quot;C:&quot; instead of &quot;C:\ Label:
Serial Number xxxxxxx&quot; makes it easy to use on multiple Windows
hosts). </p>
<p class="SectionBody">Most of these scripts can make performance
outputs. </p>
<p class="SectionBody">Enjoy and give me feedback !<br>
<br>
All code here is under GPL licence. <br>
</p>
<p class="SectionTitle"> If you want to be informed when I release
new versions, <br>
or if you have some advices, feedback, questions, go to the project's
sourceforge page : <a href="http://sourceforge.net/projects/nagios-snmp">nagios-snmp</a></p>
<p class="SectionBody">Please send me your feedback : <br>
- Test with embeded Perl<br>
- Test on various systems<br>
- Bugs, advices, comments, RFE, etc...<br>
Thank you !</p>
<p class="SectionBody">Run the scripts with '-h' to get help.</p>
</td>
</tr>
<tr>
<td valign="top">
<p class="SectionTitle">&nbsp;</p>
<p class="SectionTitle">Requirements</p>
<p class="SectionBody"> - Perl in /usr/bin/perl - if not run 'perl
script' or change the path in the scripts first line <br>
- Net::SNMP<br>
- file 'utils.pm' in diretory /usr/local/icinga/libexec or change
the line "use libs /usr/local/icinga/libexec/" in the scripts<br>
</p>
<p class="SectionBody"><a href="index_commands.html" class="SectionTitle">Configurations
examples</a></p>
<p class="SectionTitle">Plugins<br>
</p>
<table border="1" cellspacing="5">
<tr>
<td class="NewsItemDate" valign = top>Bundle of all plugins</td>
<td class="SectionBody">
<p>Version 1.1.1 : <a href="nagios-snmp-plugins.1.1.1.tgz">nagios-snmp-plugins.1.1.1.tgz</a></p>
<p>This bundle contains all the plugins, including an install
script useful if you have special Nagios or perl paths.</p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top>
<p><a href="snmp_storage.html">check_snmp_storage</a><br>
<br>
<p> Download version <a href="check_snmp_storage.pl">1.3.3</a></p>
<p>&nbsp; </p>
</td>
<td class="SectionBody">
<p>This scripts checks by snmp (1,2c,3) disks, memory, swap,
everthing in hrStorage table. <br>
Disk selection can be done by perl regexp on description,
index or type to select one or multiple storages.<br>
<br>
V&eacute;rifie par snmp v1 ou v3 (merci &agrave; V. Carpentier)
l'occupation des disques, mais aussi de la swap, de la m&eacute;moire,
etc.. tout ce qui est disponible en snmp par la table hrStorage.<br>
Les disques sont s&eacute;lectionnables par expression r&eacute;guli&egrave;re
compatible Perl</p>
<p><a href="snmp_storage.html">Details</a></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top>
<p><a href="snmp_int.html">check_snmp_int</a><br>
<br>
Download version <a href="check_snmp_int.pl">1.4.8</a></p>
</td>
<td class="SectionBody">
<p>Checks by snmp (1,2c,3) interface state and usage. Interfaces
can be selected by regexp.<br>
It is possible to check the input/output bandwidth and error
rate of the interface.<br>
<br>
V&eacute;rifie par snmp v1 ou v3 l'&eacute;tat des interfaces
d'un h&ocirc;te.<br>
Ce script permet d'utiliser des expressions r&eacute;guli&egrave;res
pour s&eacute;lectionner les interfaces : ex 'eth' va v&eacute;rifier
eth0, eth1, ...<br>
Il permet &eacute;galement de lister toutes les interfaces
disponibles sur la machine cible (option -v). </p>
<p><a href="snmp_int.html">Details</a></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top>
<p><a href="snmp_process.html">check_snmp_process</a></p>
<p>Download version <a href="check_snmp_process.pl">1.5<br>
</a></p>
<p>&nbsp;</p>
</td>
<td class="SectionBody">
<p>Checks by snmp (1,2c,3) the number (can be 1) of processes
matching a perl regexp.<br>
The script can also check memory and cpu usage of processes.</p>
<p>V&eacute;rifie par snmp v1 ou v3 (idem) le nombre de process
sur un h&ocirc;te.<br>
Ce script permet d'utiliser des expressions r&eacute;guli&egrave;res
pour s&eacute;lectionner les process.<br>
Il est &eacute;galement possible de v&eacute;rifier l'utilisation
m&eacute;moire et CPU de la machine.<br>
Il permet &eacute;galement de lister touts les process disponibles
sur la machine cible (option -v). </p>
<p><a href="snmp_load.html">Details</a></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top>
<p><a href="snmp_load.html">check_snmp_load</a></p>
<p> Download version <a href="check_snmp_load.pl">1.3.2</a></p>
</td>
<td class="SectionBody">
<p>Checks by snmp (1,2c,3) cpu or average load. <br>
Works on Linux, Windows, Cisco, AS400, HP Procurve, LinkProof,
Blucoat, Nokia, Fortinet, Netscreen,HP-UX.</p>
<p> V&eacute;rifie par snmp (1,2c,3) la charge ou l'ocupation
CPU.<br>
</p>
<p><a href="snmp_load.html">Details.</a></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top>
<p><a href="snmp_mem.html">check_snmp_mem</a></p>
<p>Download version <a href="check_snmp_mem.pl">1.1</a></p>
</td>
<td class="SectionBody">
<p>Checks by snmp (1,2c,3) : <br>
- Memory and swap usage on Linux/Net-snmp<br>
- Memory usage on cisco routers or Pix<br>
- Memory usage on HP Procurve switchs<br>
For memory check on other OS (Windows, AS400) see the description
page </p>
<p>V&eacute;rifcation de <br>
- l'utilisation m&eacute;moire et swap sur Linux/Net-snmp<br>
- l'utilisation m&eacute;moire sur Cisco (routeurs et Pix).<br>
- l'utilisation m&eacute;moire sur Switch Hp Procurve.<br>
Pour d'autres SE (Windows, AS400), aller &agrave; la page
de description.</p>
<p><a href="snmp_mem.html">D&eacute;tail</a></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top>
<p><a href="snmp_vrrp.html">check_snmp_vrrp</a></p>
<p>Download version : <a href="check_snmp_vrrp.pl">1.3</a></p>
</td>
<td class="SectionBody">
<p>Checks the vrrp state of all the interface of a host. You
can specify if they must be master or backup.<br>
Supported platforms : Nokia IP (vrrp &amp; clustering), Linkproof,
Alteon.</p>
<p>Verifie l'&eacute;tat vrrp des interfaces d'un host.</p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top>
<p><a href="snmp_cpfw.html">check_snmp_cpfw</a></p>
<p>Download version : <a href="check_snmp_cpfw.pl">1.2.1</a></p>
</td>
<td class="SectionBody">
<p>Checks the state of Checkpoint Firewall-1 modules (SVN, HA,
FW, MGMT) and active connexions (tested on NG).<br>
Snmp extensions must be activated</p>
<p>V&eacute;rifie l'&eacute;tat des modules Checkpoint Fw-1
(HA, SVN, MGMT, FW) et les connexions actives. Test&eacute;
sur NG-AI R55.<br>
L'extension SNMP doit &ecirc;tre activ&eacute;e sur les modules.</p>
<p><a href="snmp_cpfw.html">D&eacute;tail</a></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top>
<p><a href="snmp_windows.html">check_snmp_win</a></p>
<p>Download version : <a href="check_snmp_win.pl">0.6</a></p>
</td>
<td class="SectionBody">
<p>Checks windows services state with snmp.</p>
<p>V&eacute;ifie l'&eacute;tat de services Windows par snmp.</p>
<p><a href="snmp_windows.html">D&eacute;tail</a></p>
</td>
</tr>
<tr>
<td class="SectionBody">
<p><a href="snmp_css.html" class="NewsItemDate">check_snmp_css</a></p>
<p><b>Download version</b> : <a href="check_snmp_css.pl">1.0</a></p>
</td>
<td class="SectionBody">Checks css services state</td>
</tr>
<tr>
<td class="SectionBody">
<p><a href="snmp_env.html" class="NewsItemDate">check_snmp_env</a></p>
<p><b>Download version</b> : <a href="check_snmp_env.pl">1.2</a></p>
</td>
<td class="SectionBody">Checks environemental status (fan, temp,
power supply) on Cisco, Nokia, Bluecoat, IronPort.</td>
</tr>
<tr>
<td class="SectionBody">
<p class="NewsItemDate">check_snmp_nsbox</p>
<p><b>Download versio</b>n : <a href="check_snmp_nsbox.pl">1.0</a></p>
</td>
<td class="SectionBody">Checks nsbox vhost &amp; diode status.</td>
</tr>
<tr>
<td class="SectionBody">
<p class="NewsItemDate">check_snmp_boostedge</p>
<p><b>Download version</b> : <a href="check_snmp_boostedge.pl">1.0</a></p>
</td>
<td class="SectionBody">Checks Boostedge services</td>
</tr>
<tr>
<td class="SectionBody">
<p class="NewsItemDate">check_snmp_linkproof_nhr</p>
<p><b>Download version</b> : <a href="check_snmp_linkproof_nhr.pl">1.0</a></p>
</td>
<td class="SectionBody">Checks linkproof NHR</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<p class="SectionTitle">Compatibility matrix : </p>
<table width="100%" border="2" class="SectionBody" cellspacing="3">
<tr>
<td class="SectionTitle">System</td>
<td class="SectionTitle">check_snmp_storage</td>
<td class="SectionTitle">check_snmp_int</td>
<td class="SectionTitle">check_snmp_process</td>
<td class="SectionTitle">check_snmp_mem</td>
<td class="SectionTitle">check_snmp_load</td>
</tr>
<tr>
<td>Linux</td>
<td>
<p>OK : <br>
- '/home', '/var'<br>
- 'Swap', 'Real Memory'<br>
</p>
</td>
<td>OK : <br>
- 'eth' <br>
- 'ppp'</td>
<td>OK</td>
<td>OK (mem &amp; swap)</td>
<td>
<p>OK</p>
</td>
</tr>
<tr>
<td>Windows</td>
<td>
<p>OK :<br>
- '^[CDE]:'</p>
</td>
<td>OK</td>
<td>OK</td>
<td>
<p>NO<br>
See check_snmp_storage for virtual mem</p>
</td>
<td>OK</td>
</tr>
<tr>
<td>Cisco/HP switch</td>
<td>N/A</td>
<td>OK :<br>
- 'Giga' : all gigabits<br>
- 'Fast.*0.1[1234]' : checks FastEternet0/11 to 0/14.</td>
<td>N/A</td>
<td>OK</td>
<td>OK</td>
</tr>
<tr>
<td>AS400</td>
<td>OK :<br>
- '-m RAM -s' to get all RAM<br>
- 'System ASP' : Disk<br>
</td>
<td>OK </td>
<td>OK</td>
<td>
<p>NO<br>
See check_snmp_storage</p>
</td>
<td>OK</td>
</tr>
<tr>
<td>LinkProof</td>
<td>N/A</td>
<td>OK</td>
<td>N/A</td>
<td>N/A</td>
<td>OK</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<hr>
<p class="SectionBody">This project is hosted on : <br>
<A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
</p>
<p class="SectionBody"> Nagios and the Nagios logo are registered
trademarks of Ethan Galstad.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
</BODY>
</HTML>

2038
plugins/doc/index_commands.html
View file

File diff suppressed because it is too large Load diff

471
plugins/doc/snmp_cpfw.html
View file

@ -1,471 +0,0 @@
<HTML>
<HEAD>
<TITLE>Nagios plugins</TITLE>
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
<STYLE type="text/css">
<!--
.Default { font-family: verdana,arial,serif; font-size: 10pt; }
.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
.Email { font-family: verdana,arial,serif; font-size: 10pt;}
.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
-->
</STYLE>
</HEAD>
<body background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
<!-- background="img/sideback.jpg" -->
<table border="0">
<tr>
<td valign=top>
<!-- Begin Side Bar -->
<table border="0" width="125" valign=top>
<tr>
<td><a href="http://nagios.manubulon.com/" class="SideNavBarItem" >Home</a></td>
</tr>
<tr>
<td></td>
</tr>
<tr>
<td><BR>
</td>
</tr>
<tr>
<td> </td>
</tr>
</table>
<!-- End Side Bar -->
</td>
<td valign=top>
<table border="0" valign=top>
<tr>
<td class="ProgramTitle"> Snmp Checkpoint FW-1 check</td>
</tr>
<tr>
<td>
<p class="NewsItemDate">Script : check_snmp_cpfw.pl</p>
<p class="SectionTitle"> Last update : April 19 2007</p>
</td>
</tr>
<tr>
<td valign="top">
<p class="SectionTitle">Description : </p>
<p class="SectionBody">Checks by snmp v1, v2c or v3 some modules of
Checkpoint FW-1 filtering or management module :</p>
<p class="SectionBody">You can choose to check 1, 2, 3 or all 4 modules.
Each module will be checked independently and critical state will
be returned if one of them is not OK.</p>
<p class="SectionBody">- Firewall (on filtering firewall) : </p>
<p class="SectionBody">Checks policy state : must be installed<br>
Can check installed policy name : you mut provide the exact name
of the policy (-p = &lt;policy name&gt;)<br>
Can check connections : warning and maximum levels must be provided
( -c=&lt;warn&gt;,&lt;crit&gt;)</p>
<p class="SectionBody">- SVN</p>
<p class="SectionBody">Checks the svan status code (must be &quot;OK&quot;)
of SVN</p>
<p class="SectionBody">- Management</p>
<p class="SectionBody">Checks the management state (&quot;active&quot;)
and if management is alive.</p>
<p class="SectionBody">- High availability</p>
<p class="SectionBody">Checks the HA state : <br>
- &quot;active&quot; on IPSO &amp; master on SPLAT (default)<br>
- &quot;standby&quot; on SPLAT<br>
Use check_snmp_vrrp.pl for checks on active/standby or IPSO clusters
on IPSO<br>
Check the blocking state (&quot;OK&quot;)<br>
Checks the state of all HA softs, usually : Synchronization,Filter,
cphad and fwd.</p>
<p class="SectionBody"><span class="SectionTitle">SNMP Login</span><br>
</p>
<p class="SectionBody">See <a href="index_info.html">snmp info page</a></p>
<p class="SectionTitle">Requirements :</p>
<p class="SectionBody">- On the Checkpoint Firewall : SNMP extentions
must be active</p>
<p class="SectionBody">- Perl in /usr/bin/perl - or just run 'perl
script' <br>
- Net::SNMP<br>
- file 'utils.pm' in plugin diretory (/usr/local/icinga/libexec)</p>
<p class="SectionBody"><a href="index_commands.html" class="SectionTitle">Configurations
examples</a><br>
</p>
<p class="SectionBody"><a href="check_snmp_cpfw.pl" class="SectionTitle">Dowload
lastest version : 1.2.1</a></p>
<p class="NewsItemDate"><span class="SectionTitle">Changelog</span>
: On CVS repository on sourceforge : <a href="http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/">http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/</a>.</p>
<p class="SectionTitle">Examples :</p>
<p class="SectionBody"><br>
All examples below are considering the script is local directory.
Host to be checked is 127.0.0.1 with snmp community &quot;public&quot;.</p>
<table border="1" cellspacing="5">
<tr>
<td class="NewsItemDate" valign = top width="282">
<p>Get help
</td>
<td class="SectionBody" width="387">
<p>./check_snmp_cpfw.pl <b>-h</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">snmpv3 login</td>
<td class="SectionBody" width="387">./check_snmp_cpfw.pl -H 127.0.0.1
<b>-l login -x passwd .....</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<p>Check firewall / HA / SVN - for a HA filtering module -
</td>
<td class="SectionBody" width="387">
<p>./check_snmp_cpfw.pl -H 127.0.0.1 -C public <b>-swa</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<p align="right">Result example :
</td>
<td class="SectionBody" width="387">
<p>FW : OK / SVN : OK / HA : OK / CPFW Status : OK</p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<p>Check SVN/Mgmt - for a management -
</td>
<td class="SectionBody" width="387">
<p>./check_snmp_cpfw.pl -H 127.0.0.1 -C public <b>-sm</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<div align="right">Result example : </div>
</td>
<td class="SectionBody" width="387">SVN : OK / MGMT : OK / CPFW
Status : OK</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">Check policy
name </td>
<td class="SectionBody" width="387">./check_snmp_cpfw.pl -H 127.0.0.1
-C public <b>-w -p prod</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<p align="right">Result example : </p>
</td>
<td class="SectionBody" width="387">FW : OK / CPFW Status : OK</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<div align="right">Same with another policy installed : </div>
</td>
<td class="SectionBody" width="387">FW : Policy installed : Standard
/ CPFW Status : CRITICAL</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">Check number
of active connection with performance data output</td>
<td class="SectionBody" width="387">./check_snmp_cpfw.pl -H 127.0.0.1
-C public <b>-w -c 1000,5000 -f</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<div align="right">Result example : </div>
</td>
<td class="SectionBody" width="387">FW : OK / CPFW Status : OK
| fw_connexions=340</td>
</tr>
</table>
<p class="SectionBody">&nbsp;</p>
<p class="NewsItemDate">Output of check_snmp_cpfw.pl -h</p>
<table border="1" cellspacing="5">
<tr>
<td class="SectionBody" valign = top>
<p class="SectionBody">SNMP Checkpoint FW-1 Monitor for Nagios
version 1.2.1<br>
GPL Licence, (c)2004-2007 - Patrick Proy
<p>Usage: ./check_snmp_cpfw.pl [-v] -H &lt;host&gt; -C &lt;snmp_community&gt;
[-2] | (-l login -x passwd [-X pass -L &lt;authp&gt;,&lt;privp&gt;])
[-s] [-w [-p=pol_name] [-c=warn,crit]] [-m] [-a [standby]
] [-f] [-p &lt;port&gt;] [-t &lt;timeout&gt;] [-V]<br>
-v, --verbose<br>
print extra debugging information (including interface list
on the system)<br>
-h, --help<br>
print this help message<br>
-H, --hostname=HOST<br>
name or IP address of host to check<br>
-C, --community=COMMUNITY NAME<br>
community name for the host's SNMP agent (implies v1 protocol)<br>
2, --v2c<br>
Use snmp v2c<br>
-l, --login=LOGIN ; -x, --passwd=PASSWD<br>
Login and auth password for snmpv3 authentication <br>
If no priv password exists, implies AuthNoPriv <br>
-X, --privpass=PASSWD<br>
Priv password for snmpv3 (AuthPriv protocol)<br>
-L, --protocols=&lt;authproto&gt;,&lt;privproto&gt;<br>
&lt;authproto&gt; : Authentication protocol (md5|sha : default
md5)<br>
&lt;privproto&gt; : Priv protocole (des|aes : default des)
<br>
-s, --svn<br>
check for svn status<br>
-w, --fw<br>
check for fw status<br>
-a, --ha[=standby]<br>
check for ha status and node in &quot;active&quot; state<br>
If using SecurePlatform and monitoring a standby unit, put
&quot;standby&quot; too<br>
-m, --mgmt<br>
check for management status<br>
-p, --policy=POLICY_NAME<br>
check if installed policy is POLICY_NAME (must have -w)<br>
-c, --connexions=WARN,CRIT<br>
check warn and critical number of connexions (must have -w)<br>
-f, --perfparse, --perfdata<br>
performance data output (only works with -c)<br>
-P, --port=PORT<br>
SNMP port (Default 161)<br>
-t, --timeout=INTEGER<br>
timeout for SNMP (Default: Nagios default) <br>
-V, --version<br>
prints version number<br>
</p>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<p class="SectionBody">This project is hosted on : <br>
<A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
</p>
<p class="SectionBody"> Nagios and the Nagios logo are registered
trademarks of Ethan Galstad.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
</BODY>
</HTML>

381
plugins/doc/snmp_css.html
View file

@ -1,381 +0,0 @@
<HTML>
<HEAD>
<TITLE>Nagios plugins</TITLE>
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
<STYLE type="text/css">
<!--
.Default { font-family: verdana,arial,serif; font-size: 10pt; }
.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
.Email { font-family: verdana,arial,serif; font-size: 10pt;}
.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
-->
</STYLE>
</HEAD>
<body background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
<!-- background="img/sideback.jpg" -->
<table border="0">
<tr>
<td valign=top>
<!-- Begin Side Bar -->
<table border="0" width="125" valign=top>
<tr>
<td><a href="http://nagios.manubulon.com/" class="SideNavBarItem" >Home</a></td>
</tr>
<tr>
<td></td>
</tr>
<tr>
<td><BR>
</td>
</tr>
<tr>
<td> </td>
</tr>
</table>
<!-- End Side Bar -->
</td>
<td valign=top>
<table border="0" valign=top>
<tr>
<td class="ProgramTitle"> Snmp CSS check</td>
</tr>
<tr>
<td>
<p class="NewsItemDate">Script : check_snmp_css.pl / check_snmp_css_main.pl</p>
<p class="SectionTitle"> Last update : Jan 22 2007</p>
</td>
</tr>
<tr>
<td valign="top">
<p class="SectionTitle">Description : </p>
<p class="SectionBody">Checks by snmp v1, v2c or v3 CSS services state</p>
<p class="SectionBody"><span class="SectionTitle">SNMP Login</span><br>
</p>
<p class="SectionBody">See <a href="index_info.html">snmp info page</a></p>
<p class="SectionTitle">Requirements :</p>
<p class="SectionBody"> - Perl in /usr/bin/perl - or just run 'perl
script' <br>
- Net::SNMP<br>
- file 'utils.pm' in plugin diretory (/usr/local/icinga/libexec)<br>
</p>
<p class="SectionTitle">Checks </p>
<p class="SectionBody">This scripts checks status of the CSS services.</p>
<p class="SectionBody"><b class="SectionTitle">Select service(s)</b><br>
You select services you wan't to check with -n using regular expressions</p>
<p class="SectionBody"><b class="SectionTitle">Put thresholds</b><br>
You select the warning and critical levels for : &lt;num&gt;,&lt;resp&gt;,&lt;conn&gt;
<br>
num : minimum number of active &amp; alive service <br>
resp : average response time in ms<br>
conn : number of connexions </p>
<p class="SectionBody">You can choose not to put 1, 2 or 3 numbers.
<br>
If you set &quot;-w 3&quot; only the number of active services will
be checked.<br>
If you set &quot;-w 3,200&quot; only the number of active services
and response time will be checked.<br>
<br>
For no warnings, put -1 (ex : -w5,-1,3). <br>
When using negative numbers, dont put space after &quot;-w&quot;
: &quot;-w -1,100,6&quot; will not work, &quot;-w-1,100,6&quot;
will work.</p>
<p class="SectionBody"><b class="SectionTitle">-d option and check_snmp_css_main.pl</b></p>
<p class="SectionBody">This option is set to make the script read
the index from a file instead of on the CSS.</p>
<p class="SectionBody">The reason of this option is :<br>
- when you have a lot (&gt; 50) services on the CSS <br>
- you want to check 10 service group consisting of 5 services every
2 minutes.</p>
<p class="SectionBody">If you use check_snmp_css, then it will read
the index (50 oids) + checks 5 oids = 55 OID every 12 seconds in
average. This will heavily load the CSS.<br>
This is why I wrote check_snmp_css_main.pl. This script will get
the index of the CSS every 10 minutes for example (could be more)
as the index won't change often.<br>
Then the check_snmp_css will only have to check for the 5 oids every
12 seconds, which will reduce by about 10 the amount of snmp queries
!</p>
<p class="SectionBody">How to use it :</p>
<p class="SectionBody">Create a service with long inter-delay check
executing : </p>
<p class="SectionBody">check_snmp_css_main.pl -H &lt;host&gt; &lt;snmp
logins&gt; -2 -d /var/tmp<br>
<b>-2 </b>if for using snmpv2c (better to get a lot of data)<br>
<b>-d /var/tmp </b>is to put the temp file to a special directory
(default is /tmp).</p>
<p class="SectionBody">A file named : <b>Nagios_CSS_&lt;IP Address&gt;</b>
will be created</p>
<p class="SectionBody">Then you can use your check_snmp_css.pl script
just as before but adding the '<b>-d</b>' option with the temp directory
if not /tmp.</p>
<p class="SectionBody">If the Nagios_CSS_&lt;IP&gt; file is not created
when the check_snmp_css script runs, it will then return unknown
status.<br>
If the check_snmp_css_main.pl cannot read index, a warning will
be returned but the old index file will remain.</p>
<p class="SectionBody">A lockfile is created bye check_snmp_css_main.pl
when it writes it's file. The check_snmp_css script will wait until
the lock file is removed to read the index file. <br>
The lock file is named : <b>Nagios_CSS_&lt;IP Address&gt;.lock<br>
</b>The lock file format is simple: every line is in format <b>
<br>
&lt;OID&gt;:&lt;Service name&gt;</b> </p>
<p class="SectionBody">&nbsp;</p>
<p class="SectionBody"><a href="check_snmp_css.pl" class="SectionTitle">Dowload
lastest version of check_snmp_css.pl : 1.0</a></p>
<p class="SectionBody"><a href="check_snmp_css_main.pl" class="SectionTitle">Dowload
lastest version of check_snmp_css_main.pl : 1.0</a></p>
<p class="SectionBody"><a href="index_commands.html" class="SectionTitle">Configurations
examples</a></p>
<p class="NewsItemDate"><span class="SectionTitle">Changelog</span>
: On CVS repository on sourceforge : <a href="http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/">http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/</a>.</p>
<p class="SectionTitle">Examples :</p>
<p class="SectionBody"><br>
All examples below are considering the script is local directory.
Host to be checked is 127.0.0.1 with snmp community &quot;public&quot;.</p>
<table border="1" cellspacing="5">
<tr>
<td class="NewsItemDate" valign = top width="154">
<p>Get help
</td>
<td class="SectionBody" width="420">
<p>./check_snmp_css.pl <b>-h</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">Verbose output</td>
<td class="SectionBody" width="420">./check_snmp_css.pl -H &lt;IP&gt;
-C &lt;com&gt; <b>-v</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">snmpv3 login</td>
<td class="SectionBody" width="420">./check_snmp_css.pl -H 127.0.0.1
-l login -x passwd<b></b></td>
</tr>
</table>
<p class="NewsItemDate">Output of check_snmp_css.pl -h </p>
<table border="1" cellspacing="5" width="100">
<tr>
<td>
<pre>
SNMP Cisco CSS monitor for Nagios version 1.0
(c)2004-2006 Patrick Proy
Usage: ./check_snmp_css.pl [-v] -H &lt;host&gt; -C &lt;snmp_community&gt; [-2] | (-l login -x passwd [-X pass -L &lt;authp&gt;,&lt;privp&gt;])
-n &lt;name&gt; [-d directory] [-w &lt;num&gt;,&lt;resp&gt;,&lt;conn&gt; -c &lt;num&gt;,&lt;resp&gt;,&lt;conn&gt;] [-p &lt;port&gt;] [-f] [-t &lt;timeout&gt;] [-V]
-v, --verbose
print extra debugging information
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-n, --name=&lt;name&gt;
regexp to select service
-w, --warning=&lt;num&gt;,&lt;resp&gt;,&lt;conn&gt;
Optional. Warning level for
- minimum number of active &amp; alive service
- average response time
- number of connexions
For no warnings, put -1 (ex : -w5,-1,3).
When using negative numbers, dont put space after &quot;-w&quot;
-d, --dir=&lt;directory to put file&gt;
Directory where the temp file with index, created by check_snmp_css_main.pl, can be found
If no directory is set, /tmp will be used
-c, --critical=&lt;num&gt;,resp&gt;,&lt;conn&gt;
Optional. Critical levels (-1 for no critical levels)
See warning levels.
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies v1 protocol)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=&lt;authproto&gt;,&lt;privproto&gt;
&lt;authproto&gt; : Authentication protocol (md5|sha : default md5)
&lt;privproto&gt; : Priv protocole (des|aes : default des)
-P, --port=PORT
SNMP port (Default 161)
-f, --perfparse, --perfdata
Performance data output
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
</pre>
</td>
</tr>
</table>
<br>
<p class="NewsItemDate">Output of check_snmp_css_main.pl -h </p>
<table border="1" cellspacing="5" width="100">
<tr>
<td>
<pre>
SNMP Cisco CSS monitor MAIN script for Nagios version 1.0
GPL Licence, (c)2004-2006 Patrick Proy
Usage: ./check_snmp_css_main.pl [-v] -H &lt;host&gt; -C &lt;snmp_community&gt; [-2] | (-l login -x passwd [-X pass -L &lt;authp&gt;,&lt;privp&gt;])
[-d directory] [-p &lt;port&gt;] [-t &lt;timeout&gt;] [-V]
-v, --verbose
print extra debugging information
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-d, --dir=&lt;directory to put file&gt;
Directory where temp file with index is written
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies v1 protocol)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=&lt;authproto&gt;,&lt;privproto&gt;
&lt;authproto&gt; : Authentication protocol (md5|sha : default md5)
&lt;privproto&gt; : Priv protocole (des|aes : default des)
-P, --port=PORT
SNMP port (Default 161)
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
</pre>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<p class="SectionBody">This project is hosted on : <br>
<A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
</p>
<p class="SectionBody"> Nagios and the Nagios logo are registered
trademarks of Ethan Galstad.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
</BODY>
</HTML>

370
plugins/doc/snmp_env.html
View file

@ -1,370 +0,0 @@
<HTML>
<HEAD>
<TITLE>Nagios plugins</TITLE>
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
<STYLE type="text/css">
<!--
.Default { font-family: verdana,arial,serif; font-size: 10pt; }
.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
.Email { font-family: verdana,arial,serif; font-size: 10pt;}
.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
-->
</STYLE>
</HEAD>
<body background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
<!-- background="img/sideback.jpg" -->
<table border="0">
<tr>
<td valign=top>
<!-- Begin Side Bar -->
<table border="0" width="125" valign=top>
<tr>
<td><a href="http://nagios.manubulon.com/" class="SideNavBarItem" >Home</a></td>
</tr>
<tr>
<td></td>
</tr>
<tr>
<td><BR>
</td>
</tr>
<tr>
<td> </td>
</tr>
</table>
<!-- End Side Bar -->
</td>
<td valign=top>
<table border="0" valign=top>
<tr>
<td class="ProgramTitle"> Snmp env check</td>
</tr>
<tr>
<td>
<p class="NewsItemDate">Script : check_snmp_env.pl</p>
<p class="SectionTitle"> Last update : April 19 2007</p>
</td>
</tr>
<tr>
<td valign="top">
<p class="SectionTitle">Description : </p>
<p class="SectionBody">Checks by snmp v1, v2c or v3 environemental
parameters such as fan, power supply, temperature</p>
<p class="SectionBody"><span class="SectionTitle">SNMP Login</span><br>
</p>
<p class="SectionBody">See <a href="index_info.html">snmp info page</a></p>
<p class="SectionTitle">Requirements :</p>
<p class="SectionBody"> - Perl in /usr/bin/perl - or just run 'perl
script' <br>
- Net::SNMP<br>
- file 'utils.pm' in plugin diretory (/usr/local/icinga/libexec)<br>
</p>
<p class="SectionTitle">Checks </p>
<p class="SectionBody">The script will make the following checks depending
on host type.<br>
Either the threshold is directly set by the hardware manufacturer,
or you must set them with an option.</p>
<p class="SectionBody">This table shows what the script CAN check,
depending on hardware version the sensors might not be there.<br>
The script will return &quot;UNKNOWN&quot; if no sensors can be
found. </p>
<p class="SectionBody">If no option is specified in this table, it
means the script uses the threshold of the snmp table.</p>
<table width="100%" border="1">
<tr>
<td class="SectionTitle">Host type</td>
<td class="SectionTitle">Option</td>
<td class="SectionTitle">Power supply</td>
<td class="SectionTitle">Fan</td>
<td class="SectionTitle">Voltage</td>
<td class="SectionTitle">Temperature</td>
<td class="SectionTitle">Disks</td>
</tr>
<tr>
<td class="SectionBody">Cisco</td>
<td class="SectionBody">cisco</td>
<td class="SectionBody">Yes</td>
<td class="SectionBody">Yes</td>
<td class="SectionBody">No (working on it)</td>
<td class="SectionBody">No (working on it)</td>
<td class="SectionBody">No</td>
</tr>
<tr>
<td class="SectionBody">Nokia Ipso</td>
<td class="SectionBody">nokia</td>
<td class="SectionBody">Yes</td>
<td class="SectionBody">Yes</td>
<td class="SectionBody">No.</td>
<td class="SectionBody">Yes</td>
<td class="SectionBody">No</td>
</tr>
<tr>
<td class="SectionBody">Bluecoat</td>
<td class="SectionBody">bc</td>
<td class="SectionBody">Yes</td>
<td class="SectionBody">Yes</td>
<td class="SectionBody">Yes</td>
<td class="SectionBody">Yes</td>
<td class="SectionBody">Yes</td>
</tr>
<tr>
<td class="SectionBody">IronPort</td>
<td class="SectionBody">iron</td>
<td class="SectionBody">Yes</td>
<td class="SectionBody">Yes, option '-F' in RPM</td>
<td class="SectionBody">No</td>
<td class="SectionBody">Yes, option '-c' in Celcius</td>
<td class="SectionBody">No</td>
</tr>
<tr>
<td class="SectionBody">Foundry</td>
<td class="SectionBody">Foundry</td>
<td class="SectionBody">Yes</td>
<td class="SectionBody">No (bug in snmp agent)</td>
<td class="SectionBody">No</td>
<td class="SectionBody">Yes</td>
<td class="SectionBody">No</td>
</tr>
</table>
<p class="SectionBody">Note : Bluecoat provides an &quot;other&quot;
sensor which is tested also. But I never saw a Bluecoat reporting
it.</p>
<p class="SectionBody">&nbsp;</p>
<p class="SectionBody"><a href="check_snmp_env.pl" class="SectionTitle">Dowload
lastest version : 1.2</a></p>
<p class="SectionBody"><a href="index_commands.html" class="SectionTitle">Configurations
examples</a></p>
<p class="NewsItemDate"><span class="SectionTitle">Changelog</span>
: On CVS repository on sourceforge : <a href="http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/">http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/</a>.</p>
<p class="SectionTitle">Examples :</p>
<p class="SectionBody"><br>
All examples below are considering the script is local directory.
Host to be checked is 127.0.0.1 with snmp community &quot;public&quot;.</p>
<table border="1" cellspacing="5">
<tr>
<td class="NewsItemDate" valign = top width="154">
<p>Get help
</td>
<td class="SectionBody" width="420">
<p>./check_snmp_env.pl <b>-h</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">Verbose output</td>
<td class="SectionBody" width="420">./check_snmp_env.pl -H &lt;IP&gt;
-C &lt;com&gt; <b>-v</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">snmpv3 login</td>
<td class="SectionBody" width="420">./check_snmp_env.pl -H 127.0.0.1
-l login -x passwd<b></b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">
<p>Check Cisco for all sensors
</td>
<td class="SectionBody" width="420">
<p class="SectionBody">./check_snmp_env.pl -H 127.0.0.1 -C public
<b>-T cisco</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">Check Nokia
for all sensors</td>
<td class="SectionBody" width="420">./check_snmp_env.pl -H 127.0.0.1
-C public <b>-T nokia</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">checks ironport
fans RPM &gt; 1500 and temp &lt; 70 deg celcius</td>
<td class="SectionBody" width="420">./check_snmp_env.pl -H 127.0.0.1
-C public <b>-T iron -F 1500 -c 70</b></td>
</tr>
</table>
<p class="NewsItemDate">Output of check_snmp_env.pl -h </p>
<table border="1" cellspacing="5">
<tr>
<td class="SectionBody" valign = top>
<p class="SectionBody"> <br>
SNMP environmental Monitor for Nagios version 1.2<br>
GPL Licence, (c)2006-2007 Patrick Proy
<p>Usage: ./check_snmp_env.pl [-v] -H &lt;host&gt; -C &lt;snmp_community&gt;
[-2] | (-l login -x passwd [-X pass -L &lt;authp&gt;,&lt;privp&gt;])
[-p &lt;port&gt;] -T (cisco|nokia|bc|iron|foundry) [-F &lt;rpm&gt;]
[-c &lt;celcius&gt;] [-f] [-t &lt;timeout&gt;] [-V]<br>
-v, --verbose<br>
print extra debugging information <br>
-h, --help<br>
print this help message<br>
-H, --hostname=HOST<br>
name or IP address of host to check<br>
-C, --community=COMMUNITY NAME<br>
community name for the host's SNMP agent (implies v1 protocol)<br>
-2, --v2c<br>
Use snmp v2c<br>
-l, --login=LOGIN ; -x, --passwd=PASSWD<br>
Login and auth password for snmpv3 authentication <br>
If no priv password exists, implies AuthNoPriv <br>
-X, --privpass=PASSWD<br>
Priv password for snmpv3 (AuthPriv protocol)<br>
-L, --protocols=&lt;authproto&gt;,&lt;privproto&gt;<br>
&lt;authproto&gt; : Authentication protocol (md5|sha : default
md5)<br>
&lt;privproto&gt; : Priv protocole (des|aes : default des)
<br>
-P, --port=PORT<br>
SNMP port (Default 161)<br>
-T, --type=cisco|nokia|bc|iron|foundry<br>
Environemental check : <br>
cisco : voltage,temp,fan,power supply status<br>
will try to check everything present<br>
nokia : fan and power supply<br>
bc : fans, power supply, voltage, disks<br>
iron : fans, power supply, temp<br>
foundry : power supply, temp<br>
-F, --fan=&lt;rpm&gt;<br>
Minimum fan rpm value<br>
-c, --celcius=&lt;celcius&gt;<br>
Maximum temp in degree celcius<br>
-f, --perfparse, --perfdata<br>
Performance data output<br>
-t, --timeout=INTEGER<br>
timeout for SNMP in seconds (Default: 5)<br>
-V, --version<br>
prints version number<br>
</p>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<p class="SectionBody">This project is hosted on : <br>
<A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
</p>
<p class="SectionBody"> Nagios and the Nagios logo are registered
trademarks of Ethan Galstad.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
</BODY>
</HTML>

673
plugins/doc/snmp_int.html
View file

@ -1,673 +0,0 @@
<HTML>
<HEAD>
<TITLE>Nagios plugins</TITLE>
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
<STYLE type="text/css">
<!--
.Default { font-family: verdana,arial,serif; font-size: 10pt; }
.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
.Email { font-family: verdana,arial,serif; font-size: 10pt;}
.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
-->
</STYLE>
</HEAD>
<body background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
<!-- background="img/sideback.jpg" -->
<table border="0" height="1477">
<tr>
<td valign=top>
<!-- Begin Side Bar -->
<table border="0" width="125" valign=top>
<tr>
<td><a href="http://nagios.manubulon.com/" class="SideNavBarItem" >Home</a></td>
</tr>
<tr>
<td></td>
</tr>
<tr>
<td><BR>
</td>
</tr>
<tr>
<td> </td>
</tr>
</table>
<!-- End Side Bar -->
</td>
<td valign=top>
<table border="0" valign=top height="1452">
<tr>
<td class="ProgramTitle"> Snmp interface check</td>
</tr>
<tr>
<td>
<p class="NewsItemDate">Script : check_snmp_int.pl</p>
<p class="SectionTitle"> Last update : May 24 2007</p>
</td>
</tr>
<tr>
<td valign="top">
<p class="SectionTitle">Description :</p>
<p class="SectionBody">Checks by snmp (v1, v2c or v3) host interface
state and usage. <br>
<br>
Interfaces can be selected by regexp ( 'eth' will check eth0, eth1,
eth2, ...).<br>
If multiple interfaces are selected, all must be up to get an OK
result<br>
<b><br>
</b>Vérifie par snmp v1, v2c ou v3 l'&eacute;tat des interfaces
d'un h&ocirc;te, leur utilisation (bande passante, erreurs, pertes)
et sortir des informations de performances.<br>
Ce script permet d'utiliser des expressions r&eacute;guli&egrave;res
pour s&eacute;lectionner les interfaces : ex 'eth' va v&eacute;rifier
eth0, eth1, ...<br>
Il permet également de lister toutes les interfaces disponibles
sur la machine cible (option -v) pour voir leur nom en SNMP.<br>
<i>Pour les francophones, je ferais un manuel en Fran&ccedil;ais
quand j'aurais le temps... (et toute aide est bienvenue).</i><b><br>
</b><br>
<span class="SectionTitle">Standard checks</span><br>
</p>
<p class="SectionBody">The script will check interface operationnal
status using the MIB-II table. The interface is (are) selected by
the <b>-n </b>option.<br>
This option will be treated as a regular expression (eth will match
eth0, eth1, eth2...). You can disable this with the <b>-r </b>option
: the interface will be selected if it's description exactly matches
the name given by -n</p>
<p class="SectionBody">The interfaces are selected by their description
in the MIB-II table.<br>
<b>To see how interface looks like by snmp, you can list all of
them with the '-v' switch.</b><br>
</p>
<p class="SectionBody">The script will return OK if ALL interfaces
selected are UP, or CRITICAL if at least one interface is down.<br>
<br>
You can make the script return a OK value when all interfaces are
down (and CRITICAL when at least one is up) with the <b>-i </b>option.</p>
<p class="SectionBody">You can make the same tests on administrative
status instead with the <b>-a </b>option.</p>
<p class="SectionBody">If you have ISDN interface, and want that DORMANT state returns ok, put <strong>-D</strong>.</p>
<p class="SectionBody">To make output shorter, specially when you
have multiple interface, you can put the <b>-s</b> option. <br>
It will get only the first &lt;n&gt; caracters of the interface
descrition. If the number is negative then get the last &lt;n&gt;
caracters.</p>
<p class="SectionBody">Ex : EL20005 3Com Gigabit NIC (3C2000 Family)<br>
<b> -s 4 </b> will output : &quot;EL20&quot;.<br>
<b>-s -4</b> will output : &quot;ily)&quot;.</p>
<p class="SectionTitle">Performance output </p>
<p class="SectionBody"><b>-f </b>option : activate performance output
(default the In/out octet as a counter).<br>
<b>-e </b>option : in/out errors and discarded packets. -f must
also be set.<br>
-<b>S</b> option : Include speed in performance output in bits/s
as '&lt;interface_name&gt;_speed_bps'<br>
<b>-y </b>option : output performance data in % of interface speed<b><br>
-Y</b> option : output performance data in bits/s or Bytes/s (depending
on -B)</p>
<p class="SectionBody"><b>Note</b> : -y and -Y options need the usage
check to ba active (-k)</p>
<p class="SectionBody"><b>Warning</b> : the counters needed by -e
are not always available on all machines (ex Nokia IP)<br>
</p>
<p class="SectionBody"><span class="SectionTitle">Usage check (-k)
</span><br>
<br>
<br>
A temporary file will be created in &quot;/tmp&quot; by default
: this can be changed at the beginning of the script. <br>
The file name will be : tmp_Icinga_int.&lt;host IP&gt;.&lt;Interface
name&gt;. One file will be created by interface.<br>
<br>
The status UNKNOWN is returned when the script doesn't have enough
information (see -d option).<br>
<br>
You will have to tell the warning and critical levels, separated
with &quot;,&quot; and you can use decimal (ex : 10.3).<br>
For standard checks (no &quot;-q&quot; option) : <br>
-w <i>&lt;In warn&gt;</i>,<i>&lt;Out warn&gt;</i> -c <i>&lt;In warn&gt;</i>,<i>&lt;Out
warn&gt;<br>
</i>In warn : warning level for incomming traffic<br>
Out warn : warning level for outgoing traffic<br>
In crit : critical level for incomming traffic<br>
Out crit : critical level for outgoing traffic<br>
</p>
<p class="SectionBody">The unit for the check depends on the -B, -M
and -G option :</p>
<table border="0" cellpadding="2" cellspacing="3" width="276">
<tr>
<td class="SectionBody" width="111">&nbsp;</td>
<td class="SectionBody" width="66"><b> -B set</b></td>
<td class="SectionBody" width="75"><b>-B not set</b></td>
</tr>
<tr>
<td class="SectionBody" width="111"><b>-M &amp; -G not set</b></td>
<td class="SectionBody" width="66">
<div align="center">Kbps</div>
</td>
<td class="SectionBody" width="75">
<div align="center">KBps</div>
</td>
</tr>
<tr>
<td class="SectionBody" width="111"><b>-M set</b></td>
<td class="SectionBody" width="66">
<div align="center">Mbps</div>
</td>
<td class="SectionBody" width="75">
<div align="center">MBps</div>
</td>
</tr>
<tr>
<td class="SectionBody" width="111"><b>-G set</b></td>
<td class="SectionBody" width="66">
<div align="center">Gbps</div>
</td>
<td class="SectionBody" width="75">
<div align="center">GBps</div>
</td>
</tr>
</table>
<p class="SectionBody">It is possible to put warning and critical
levels with -b option.<br>
<b>0 means no warning or critical level checks</b></p>
<p class="SectionBody">When the extended checks are activated (-q
option), the warning levels are <br>
-w <i>&lt;In bytes&gt;</i>,<i>&lt;Out bytes&gt;</i>,<i>&lt;In error&gt;</i>,<i>&lt;Out
error&gt;,<i>&lt;In disc&gt;</i>,<i>&lt;Out disc&gt;</i></i> -c
<i>&lt;In warn&gt;</i>,<i>&lt;Out warn&gt;</i>, .....<br>
In error : warn/crit level in inboud <b>error/minute<br>
</b>Out error : warn/crit level in outbound error/minute<b> </b><br>
In disc : warn/crit level in inboud <b>discarded packets/minute<br>
</b>Out disc : warn/crit level in outbound discarded packets/minute<b>
</b><br>
</p>
<p class="SectionBody"><b>-k</b> : activates the standard usage feature<br>
<b>-q</b> : activates the extended usage<br>
<b>-d</b> : delta in seconds (default is 300s)<br>
<b>-w</b> : warning levels<br>
<b>-c</b> : critical levels<br>
</p>
<p class="SectionBody"><b>-d</b>: delta time<br>
You can put the delta time as an option : the &quot;delta&quot;
is the prefered time between two values that the script will use
to calculate the average Kbytes/s or error/min. The delta time should
(not must) be bigger than the check interval.<br>
Here is an example : Check interval of 2 minutes and delta of 4min</p>
<p class="SectionBody">T0 : value 1 : can't calculate usage<br>
T0+2 : value 2 : can't calculate usage<br>
T0+4 : value 3 : usage=(value3-value1)/((T0+4)-T0) <br>
T0+6 : value 4 : usage=(value4-value2)/((T0+6)-T0+2)<br>
(Yes I know TO+4-T0=4, it's just to explain..)<br>
.........</p>
<p class="SectionBody">The script will allow 10% less of the delta
and 300% more than delta as a correct interval. <br>
For example, with a delta of 5 minutes, the acceptable interval
will be between 4'30&quot; and 15 minutes.</p>
<p class="SectionBody"> <b>Msg size option </b>(<i>-o</i><b><i> </i></b>option)</p>
<p class="SectionBody">In case you get a &quot;ERROR: running table
: Message size exceeded maxMsgSize&quot; error, you may need to
adjust the maxMsgSize, i.e. the maximum size of snmp message with
the -o option. Try a value with the -o AND the -v option : the script
will output the actual value so you can add some octets to it with
the -o option.</p>
<p class="SectionBody"><b>--label option</b></p>
<p class="SectionBody">This option just put label before the speed
output :<br>
Without : eth1:UP (10.3Kbps/4.4Kbps), eth0:UP (10.9Kbps/16.4Kbps):2
UP: OK<br>
With : eth1:UP (in=14.4Kbps/out=6.2Kbps), eth0:UP (in=15.3Kbps/out=22.9Kbps):2
UP: OK<br>
</p>
<p class="SectionBody"><span class="SectionTitle">SNMP Login</span><br>
</p>
<p class="SectionBody">See <a href="index_info.html">snmp info page</a></p>
<p class="SectionTitle">Requirements :</p>
<p class="SectionBody"> - Perl in /usr/bin/perl - or just run 'perl
script' <br>
- Net::SNMP<br>
- file 'utils.pm' in plugin diretory (/usr/local/icinga/libexec)<br>
</p>
<p class="SectionBody"><a href="check_snmp_int.pl" class="SectionTitle">Dowload
latest version : 1.4.8</a></p>
<p class="SectionBody"><a href="index_commands.html" class="SectionTitle">Configuration
examples</a></p>
<p class="SectionTitle">Examples :</p>
<p class="SectionBody"><br>
All examples below are considering the script is local directory.
Host to be checked is 127.0.0.1 with snmp community &quot;public&quot;.</p>
<p class="SectionBody">If multiple interfaces are selected, all must
be up to get an OK result</p>
<table border="1" cellspacing="5">
<tr>
<td class="NewsItemDate" valign = top width="198">
<p>Get help
</td>
<td class="SectionBody" width="496">
<p>./check_snmp_int.pl <b>-h</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="198">List all interfaces</td>
<td class="SectionBody" width="496">./check_snmp_int.pl -H 127.0.0.1
-C public -n zzzz <b>-v</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="198">snmpv3 login</td>
<td class="SectionBody" width="496">./check_snmp_int.pl -H 127.0.0.1
-l login -w passwd<b></b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="198">
<p>Check eth0 interface is up
</td>
<td class="SectionBody" width="496">
<p>./check_snmp_int.pl -H 127.0.0.1 -C public <b>-n eth0 -r</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="198">
<p>Check that all eth interface are up
</td>
<td class="SectionBody" width="496">
<p>./check_snmp_int.pl -H 127.0.0.1 -C public <b>-n eth </b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="198">
<p>Check that all ppp interface are down
</td>
<td class="SectionBody" width="496">
<p>./check_snmp_int.pl -H 127.0.0.1 -C public <b>-n ppp -i</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="198">
<p>Check that all eth interface are administratively up
</td>
<td class="SectionBody" width="496">
<p>./check_snmp_int.pl -H 127.0.0.1 -C public <b>-n eth -a</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="198">
<p>Check that FastEternet0/11 to 0/14 are up (Cisco)
</td>
<td class="SectionBody" width="496">
<p>./check_snmp_int.pl -H 127.0.0.1 -C public <b>-n &quot;Fast.*0.1[1234]&quot;</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="198">Check the eth0
usage <br>
Note : no critical inbound (0)</td>
<td class="SectionBody" width="496">./check_snmp_int.pl -H 127.0.0.1
-C public -n eth0 <b>-k -w 200,400 -c 0,600</b></td>
</tr>
</table>
<p class="NewsItemDate"><span class="SectionTitle">Changelog</span>
: On CVS repository on sourceforge : <a href="http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/">http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/</a>.</p>
<p class="NewsItemDate">Output of check_snmp_int.pl -h</p>
<table border="1" cellspacing="5">
<tr>
<td class="SectionBody" valign = top>
<p>SNMP Network Interface Monitor for Nagios version 1.4.8<br>
GPL licence, (c)2004-2007 Patrick Proy</p>
<p>Usage: ./check_snmp_int.pl [-v] -H &lt;host&gt; -C &lt;snmp_community&gt; [-2] | (-l login -x passwd [-X pass -L &lt;authp&gt;,&lt;privp&gt;) [-p &lt;port&gt;] -n &lt;name in desc_oid&gt; [-i -a -D] [-r] [-f[eSyY]] [-k[qBMGu] -g -w&lt;warn levels&gt; -c&lt;crit levels&gt; -d&lt;delta&gt;] [-o &lt;octet_length&gt;] [-t &lt;timeout&gt;] [-s] --label [-V]<br>
-v, --verbose<br>
print extra debugging information (including interface list on the system)<br>
-h, --help<br>
print this help message<br>
-H, --hostname=HOST<br>
name or IP address of host to check<br>
-C, --community=COMMUNITY NAME<br>
community name for the host's SNMP agent (implies v1 protocol)<br>
-l, --login=LOGIN ; -x, --passwd=PASSWD, -2, --v2c<br>
Login and auth password for snmpv3 authentication <br>
If no priv password exists, implies AuthNoPriv <br>
-2 : use snmp v2c<br>
-X, --privpass=PASSWD<br>
Priv password for snmpv3 (AuthPriv protocol)<br>
-L, --protocols=&lt;authproto&gt;,&lt;privproto&gt;<br>
&lt;authproto&gt; : Authentication protocol (md5|sha : default md5)<br>
&lt;privproto&gt; : Priv protocole (des|aes : default des) <br>
-P, --port=PORT<br>
SNMP port (Default 161)<br>
-n, --name=NAME<br>
Name in description OID (eth0, ppp0 ...).<br>
This is treated as a regexp : -n eth will match eth0,eth1,...<br>
Test it before, because there are known bugs (ex : trailling /)<br>
-r, --noregexp<br>
Do not use regexp to match NAME in description OID<br>
-i, --inverse<br>
Make critical when up<br>
-a, --admin<br>
Use administrative status instead of operational<br>
-D, --dormant<br>
Dormant state is an OK state<br>
-o, --octetlength=INTEGER<br>
max-size of the SNMP message, usefull in case of Too Long responses.<br>
Be carefull with network filters. Range 484 - 65535, default are<br>
usually 1472,1452,1460 or 1440. <br>
-f, --perfparse, --perfdata<br>
Performance data output (no output when interface is down).<br>
-e, --error<br>
Add error &amp; discard to Perfparse output<br>
-S, --intspeed<br>
Include speed in performance output in bits/s<br>
-y, --perfprct ; -Y, --perfspeed<br>
-y : output performance data in % of max speed <br>
-Y : output performance data in bits/s or Bytes/s (depending on -B) <br>
-k, --perfcheck ; -q, --extperfcheck <br>
-k check the input/ouput bandwidth of the interface<br>
-q also check the error and discard input/output<br>
--label<br>
Add label before speed in output : in=, out=, errors-out=, etc...<br>
-g, --64bits<br>
Use 64 bits counters instead of the standard counters when checking <br>
bandwidth &amp; performance data for interface &gt;= 1Gbps.<br>
You must use snmp v2c or v3 to get 64 bits counters.<br>
-d, --delta=seconds<br>
make an average of &lt;delta&gt; seconds (default 300=5min)<br>
-B, --kbits<br>
Make the warning and critical levels in K|M|G Bits/s instead of K|M|G Bytes/s<br>
-G, --giga ; -M, --mega ; -u, --prct<br>
-G : Make the warning and critical levels in Gbps (with -B) or GBps<br>
-M : Make the warning and critical levels in Mbps (with -B) or MBps<br>
-u : Make the warning and critical levels in % of reported interface speed.<br>
-w, --warning=input,output[,error in,error out,discard in,discard out]<br>
warning level for input / output bandwidth (0 for no warning)<br>
unit depends on B,M,G,u options<br>
warning for error &amp; discard input / output in error/min (need -q)<br>
-c, --critical=input,output[,error in,error out,discard in,discard out]<br>
critical level for input / output bandwidth (0 for no critical)<br>
unit depends on B,M,G,u options<br>
critical for error &amp; discard input / output in error/min (need -q)<br>
-s, --short=int<br>
Make the output shorter : only the first &lt;n&gt; chars of the interface(s)<br>
If the number is negative, then get the &lt;n&gt; LAST caracters.<br>
-t, --timeout=INTEGER<br>
timeout for SNMP in seconds (Default: 5) <br>
-V, --version<br>
prints version number<br>
Note : when multiple interface are selected with regexp, <br>
all be must be up (or down with -i) to get an OK result.</p>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<p class="SectionBody">This project is hosted on : <br>
<A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
</p>
<p class="SectionBody"> Nagios and the Nagios logo are registered
trademarks of Ethan Galstad.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
<p>&nbsp;</p>
</BODY>
</HTML>

409
plugins/doc/snmp_load.html
View file

@ -1,409 +0,0 @@
<HTML>
<HEAD>
<TITLE>Nagios plugins</TITLE>
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
<STYLE type="text/css">
<!--
.Default { font-family: verdana,arial,serif; font-size: 10pt; }
.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
.Email { font-family: verdana,arial,serif; font-size: 10pt;}
.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
-->
</STYLE>
</HEAD>
<body background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
<table border="0">
<tr>
<td valign=top>
<!-- Begin Side Bar -->
<table border="0" width="125" valign=top>
<tr>
<td><a href="http://nagios.manubulon.com/" class="SideNavBarItem" >Home</a></td>
</tr>
<tr>
<td></td>
</tr>
<tr>
<td><BR>
</td>
</tr>
<tr>
<td> </td>
</tr>
</table>
<!-- End Side Bar -->
</td>
<td valign=top>
<table border="0" valign=top>
<tr>
<td class="ProgramTitle"> Snmp load check</td>
</tr>
<tr>
<td>
<p class="NewsItemDate">Script : check_snmp_load.pl</p>
<p class="SectionTitle"> Last update : Sept 5 2006</p>
</td>
</tr>
<tr>
<td valign="top">
<p class="SectionTitle">Description : </p>
<p class="SectionBody">Checks by snmp v1, v2c or v3 cpu or average
load. <br>
Works on Windows, Linux/Unix, AS400, Cisco, Cisco catalyst, HP Procurve, LinkProof,
Blucoat, Nokia, Fortinet, Netscreen.</p>
<p class="SectionBody">Check types are selected by the -T option :
</p>
<table border="1">
<tr>
<td class="SectionTitle">
<div align="center">-T value</div>
</td>
<td class="SectionTitle">
<div align="center">System </div>
</td>
<td class="SectionTitle">
<div align="center">-w &amp; -c values</div>
</td>
</tr>
<tr>
<td class="SectionBody"><b>netsl</b></td>
<td class="SectionBody">Linux : load provided by Net SNMP</td>
<td class="SectionBody">3 values : load average on 1 min, 5 min,
15 min (absolute)</td>
</tr>
<tr>
<td class="SectionBody"><b>netsc</b></td>
<td class="SectionBody">Linux : CPU usage given by net-snmp</td>
<td class="SectionBody">1 value in %</td>
</tr>
<tr>
<td class="SectionBody"><b>as400</b></td>
<td class="SectionBody">as400 CPU usage</td>
<td class="SectionBody">1 value in %</td>
</tr>
<tr>
<td class="SectionBody"><b>cisco</b></td>
<td class="SectionBody">cisco CPU usage</td>
<td class="SectionBody">3 values : CPU average on 5sec, 1 min
&amp; 5 min (%)</td>
</tr>
<tr>
<td class="SectionBody"><b>cata</b></td>
<td class="SectionBody">cisco catalyst CPU usage</td>
<td class="SectionBody">3 values : CPU average on 5sec, 1 min
&amp; 5 min (%)</td>
</tr>
<tr>
<td class="SectionBody"><b>nsc</b></td>
<td class="SectionBody">Netscreen CPU usage</td>
<td class="SectionBody">3 values : CPU average on 5sec, 1 min
&amp; 5 min (%)</td>
</tr>
<tr>
<td class="SectionBody"><b>fg</b></td>
<td class="SectionBody">Fortigate CPU usage</td>
<td class="SectionBody">1 value in %</td>
</tr>
<tr>
<td class="SectionBody"><b>bc</b></td>
<td class="SectionBody">bluecoat CPU usage</td>
<td class="SectionBody">1 value in %</td>
</tr>
<tr>
<td class="SectionBody"><b>nokia</b></td>
<td class="SectionBody">nokia CPU usage</td>
<td class="SectionBody">1 value in %</td>
</tr>
<tr>
<td class="SectionBody"><b>hp</b></td>
<td class="SectionBody">HP procurve switch CPU usage</td>
<td class="SectionBody">1 value in %</td>
</tr>
<tr>
<td class="SectionBody"><b>lp</b></td>
<td class="SectionBody">Linkproof CPU usage</td>
<td class="SectionBody">1 value in %</td>
</tr>
<tr>
<td class="SectionBody"><b>hpux</b></td>
<td class="SectionBody">HP-UX load</td>
<td class="SectionBody">3 values : load average on 1 min, 5 min,
15 min</td>
</tr>
</table>
<p class="SectionBody"> V&eacute;rifie par snmp v1,v2c ou v3 la charge
ou l'ocupation CPU.</p>
<p class="SectionBody"><span class="SectionTitle">SNMP Login</span><br>
</p>
<p class="SectionBody">See <a href="index_info.html">snmp info page</a></p>
<p class="SectionTitle">Requirements :</p>
<p class="SectionBody"> - Perl in /usr/bin/perl - or just run 'perl
script' <br>
- Net::SNMP<br>
- file 'utils.pm' in plugin diretory<br>
</p>
<p class="SectionBody"><a href="check_snmp_load.pl" class="SectionTitle">Dowload
lastest version : 1.3.1</a> </p>
<p class="SectionBody"><a href="index_commands.html" class="SectionTitle">Configurations
examples</a></p>
<p class="SectionTitle"><span class="SectionTitle">Changelog</span>
: On CVS repository on sourceforge : <a href="http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/">http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/</a>.</p>
<p class="SectionTitle">Examples :</p>
<p class="SectionBody"><br>
All examples below are considering the script is local directory.
Host to be checked is 127.0.0.1 with snmp community &quot;public&quot;.</p>
<p class="SectionBody">If multiple interfaces are selected, all must
be up to get an OK result</p>
<table border="1" cellspacing="5">
<tr>
<td class="NewsItemDate" valign = top width="282">
<p>Get help
</td>
<td class="SectionBody">
<p>./check_snmp_load.pl <b>-h</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<p>Check loads on linux with Net-SNMP : checks the 1, 5 and
15 minutes load average.
</td>
<td class="SectionBody">
<p>./check_snmp_load.pl -H 127.0.0.1 -C public <b>-w 3,3,2 -c
4,4,3 -T netsl</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<p>Check cpu load (generic) : checks the %used CPU for the last
minute
</td>
<td class="SectionBody">
<p>./check_snmp_load.pl -H 127.0.0.1 -C public <b>-w 98% -c
99%</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<p>Check cpu load on AS/400
</td>
<td class="SectionBody">
<p>./check_snmp_load.pl -H 127.0.0.1 -C public <b>-w 98% -c
99% -T as400</b></p>
</td>
</tr>
</table>
<p class="NewsItemDate">Output of check_snmp_load.pl -h</p>
<table border="1" cellspacing="5">
<tr>
<td class="SectionBody" valign = top>
SNMP Load &amp; CPU Monitor for Nagios version 1.3<br>
(c)2004-2006 Patrick Proy
<p>Usage: ./check_snmp_load.pl [-v] -H &lt;host&gt; -C &lt;snmp_community&gt;
[-2] | (-l login -x passwd [-X pass -L &lt;authp&gt;,&lt;privp&gt;])
[-p &lt;port&gt;] -w &lt;warn level&gt; -c &lt;crit level&gt;
-T=[stand|netsl|netsc|as400|cisco|cata|nsc|fg|bc|nokia|hp|lp]
[-f] [-t &lt;timeout&gt;] [-V]<br>
-v, --verbose<br>
print extra debugging information <br>
-h, --help<br>
print this help message<br>
-H, --hostname=HOST<br>
name or IP address of host to check<br>
-C, --community=COMMUNITY NAME<br>
community name for the host's SNMP agent (implies v1 protocol)<br>
-2, --v2c<br>
Use snmp v2c<br>
-l, --login=LOGIN ; -x, --passwd=PASSWD<br>
Login and auth password for snmpv3 authentication <br>
If no priv password exists, implies AuthNoPriv <br>
-X, --privpass=PASSWD<br>
Priv password for snmpv3 (AuthPriv protocol)<br>
-L, --protocols=&lt;authproto&gt;,&lt;privproto&gt;<br>
&lt;authproto&gt; : Authentication protocol (md5|sha : default
md5)<br>
&lt;privproto&gt; : Priv protocole (des|aes : default des)
<br>
-P, --port=PORT<br>
SNMP port (Default 161)<br>
-w, --warn=INTEGER | INT,INT,INT<br>
1 value check : warning level for cpu in percent (on one minute)<br>
3 value check : comma separated level for load or cpu for
1min, 5min, 15min <br>
-c, --crit=INTEGER | INT,INT,INT<br>
critical level for cpu in percent (on one minute)<br>
1 value check : critical level for cpu in percent (on one
minute)<br>
3 value check : comma separated level for load or cpu for
1min, 5min, 15min <br>
-T, --type=stand|netsl|netsc|as400|cisco|bc|nokia|hp|lp<br>
CPU check : <br>
stand : standard MIBII (works with Windows), <br>
can handle multiple CPU.<br>
netsl : linux load provided by Net SNMP<br>
netsc : cpu usage given by net-snmp (100-idle)<br>
as400 : as400 CPU usage<br>
cisco : Cisco CPU usage<br>
cata : Cisco catalyst CPU usage<br>
nsc : NetScreen CPU usage<br>
fg : Fortigate CPU usage<br>
bc : Bluecoat CPU usage<br>
nokia : Nokia CPU usage<br>
hp : HP procurve switch CPU usage<br>
lp : Linkproof CPU usage<br>
-f, --perfparse, --perfdata<br>
Performance data output<br>
-t, --timeout=INTEGER<br>
timeout for SNMP in seconds (Default: 5)<br>
-V, --version<br>
prints version number</p>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<p class="SectionBody">This project is hosted on : <br>
<A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
</p>
<p class="SectionBody"> Nagios and the Nagios logo are registered
trademarks of Ethan Galstad.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
<p>&nbsp;</p>
</BODY>
</HTML>

485
plugins/doc/snmp_mem.html
View file

@ -1,485 +0,0 @@
<HTML>
<HEAD>
<TITLE>Nagios plugins</TITLE>
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
<STYLE type="text/css">
<!--
.Default { font-family: verdana,arial,serif; font-size: 10pt; }
.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
.Email { font-family: verdana,arial,serif; font-size: 10pt;}
.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
-->
</STYLE>
</HEAD>
<body background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
<!-- background="img/sideback.jpg" -->
<table border="0">
<tr>
<td valign=top>
<!-- Begin Side Bar -->
<table border="0" width="125" valign=top>
<tr>
<td><a href="http://nagios.manubulon.com/" class="SideNavBarItem" >Home</a></td>
</tr>
<tr>
<td></td>
</tr>
<tr>
<td><BR>
</td>
</tr>
<tr>
<td> </td>
</tr>
</table>
<!-- End Side Bar -->
</td>
<td valign=top>
<table border="0" valign=top>
<tr>
<td class="ProgramTitle"> Snmp memory check</td>
</tr>
<tr>
<td>
<p class="NewsItemDate">Script : check_snmp_mem.pl</p>
<p class="SectionTitle"> Last update : Sept 4 2006</p>
</td>
</tr>
<tr>
<td valign="top">
<p class="SectionTitle">Description : </p>
<p class="SectionBody">Checks by snmp v1, v2c or v3 :</p>
<p class="SectionBody">- Memory and swap usage on Linux given by Net-snmp.
<br>
It checks memory and swap usage independantly : one warning and
critical level for each of them.<br>
</p>
<p class="SectionBody">- Memory usage on cisco routers or Pix : the
plugin will add all of the memory pool and then checks the warning
and critical levels.<br>
On cisco routeurs, it will add 'IO' and 'Processor' memory<br>
On Pix, it will check the memory used (one memory pool only on Pix).<br>
</p>
<p class="SectionBody">- Memory usage on HP Procurve switch.<br>
Memory segments will be added then the free memory will be checked.<br>
</p>
<p class="SectionBody">V&eacute;rification de :<br>
- l'utilisation m&eacute;moire et swap sur Linux/Net-snmp<br>
- l'utilisation m&eacute;moire sur Cisco (routeurs et Pix).<br>
Pour d'autres SE (Windows, AS400), lire la suite.</p>
<p class="SectionTitle">Checking memory for other os :</p>
<p class="SectionBody"><b>AS/400 : </b>use the check_snmp_storage
command to check the RAM</p>
<p class="SectionBody">./check_snmp_storage.pl -H <b>&lt;IP&gt;</b>
-C <b>&lt;community&gt;</b> -m RAM -s -w <b>&lt;warn%&gt;</b> -c
<b>&lt;crit%&gt;</b></p>
<p class="SectionBody"><b>Windows : </b>use the check_snmp_storage
command to check the virtual memory (RAM+Swap)</p>
<p class="SectionBody">./check_snmp_storage.pl -H <b>&lt;IP&gt;</b>
-C <b>&lt;community&gt;</b> -m &quot;^Virtual Memory$&quot; -w <b>&lt;warn%&gt;</b>
-c <b>&lt;crit%&gt;</b></p>
<p class="SectionBody"><span class="SectionTitle">SNMP Login</span><br>
</p>
<p class="SectionBody">See <a href="index_info.html">snmp info page</a></p>
<p class="SectionTitle">Requirements :</p>
<p class="SectionBody"> - Perl in /usr/bin/perl - or just run 'perl
script' <br>
- Net::SNMP<br>
- file 'utils.pm' in plugin diretory (/usr/local/icinga/libexec)<br>
</p>
<p class="SectionBody"><a href="check_snmp_mem.pl" class="SectionTitle">Dowload
lastest version : 1.1</a> </p>
<p class="SectionBody"><a href="index_commands.html" class="SectionTitle">Configurations
examples</a></p>
<p class="NewsItemDate"><span class="SectionTitle">Changelog</span>
: On CVS repository on sourceforge : <a href="http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/">http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/</a>.</p>
<p class="SectionTitle">Examples :</p>
<p class="SectionBody"><br>
All examples below are considering the script is local directory.
Host to be checked is 127.0.0.1 with snmp community &quot;public&quot;.</p>
<table border="1" cellspacing="5">
<tr>
<td class="NewsItemDate" valign = top width="154">
<p>Get help
</td>
<td class="SectionBody" width="420">
<p>./check_snmp_mem.pl <b>-h</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">Verbose output</td>
<td class="SectionBody" width="420">./check_snmp_mem.pl -H &lt;IP&gt;
-C &lt;com&gt; -w 80 -c 81 <b>-v</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">snmpv3 login</td>
<td class="SectionBody" width="420">./check_snmp_mem.pl -H 127.0.0.1
-l login -x passwd<b></b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">
<p>&nbsp;
</td>
<td class="SectionBody" width="420">
<p class="NewsItemDate">Unix/Linux</p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">
<p>%used of <br>
- RAM &lt; 99% and 100%<br>
- Swap : &lt; 20% and 30%
</td>
<td class="SectionBody" width="420">
<p>./check_snmp_mem.pl -H &lt;IP&gt; -C &lt;com&gt; <b> -w 99,20
-c 100,30</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">
<p>Same with no warning levels for memory
</td>
<td class="SectionBody" width="420">
<p>./check_snmp_mem.pl -H &lt;IP&gt; -C &lt;com&gt; -w <b>0</b>,20
-c 100,30</p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="154">
<p>Check memory on Cisco
</td>
<td class="SectionBody" width="420">
<p>./check_snmp_mem.pl -H &lt;IP&gt; -C &lt;com&gt; <b>-I -w
90% -c 98%</b></p>
</td>
</tr>
</table>
<p class="NewsItemDate">Output of check_snmp_mem.pl -h &lt;</p>
<table border="1" cellspacing="5">
<tr>
<td class="SectionBody" valign = top>
<p class="SectionBody">
<pre>
SNMP Memory Monitor for Nagios version 1.1
(c)2004-2006 - Patrick Proy
Usage: ./check_snmp_mem.pl [-v] -H &lt;host&gt; -C &lt;snmp_community&gt; [-2] | (-l login -x passwd [-X pass -L &lt;authp&gt;,&lt;privp&gt;]) [-p &lt;port&gt;] -w &lt;warn level&gt; -c &lt;crit level&gt; [-I|-N|-E] [-f] [-m] [-t &lt;timeout&gt;] [-V]
-v, --verbose
print extra debugging information (including interface list on the system)
-h, --help
print this help message
-H, --hostname=HOST
name or IP address of host to check
-C, --community=COMMUNITY NAME
community name for the host's SNMP agent (implies SNMP v1 or v2c with option)
-2, --v2c
Use snmp v2c
-l, --login=LOGIN ; -x, --passwd=PASSWD
Login and auth password for snmpv3 authentication
If no priv password exists, implies AuthNoPriv
-X, --privpass=PASSWD
Priv password for snmpv3 (AuthPriv protocol)
-L, --protocols=&lt;authproto&gt;,&lt;privproto&gt;
&lt;authproto&gt; : Authentication protocol (md5|sha : default md5)
&lt;privproto&gt; : Priv protocole (des|aes : default des)
-P, --port=PORT
SNMP port (Default 161)
-w, --warn=INTEGER | INT,INT
warning level for memory in percent (0 for no checks)
Default (-N switch) : comma separated level for Real Memory and Swap
-I switch : warning level
-c, --crit=INTEGER | INT,INT
critical level for memory in percent (0 for no checks)
Default (-N switch) : comma separated level for Real Memory and Swap
-I switch : critical level
-N, --netsnmp (default)
check linux memory & swap provided by Net SNMP
-m, --memcache
include cached memory in used memory (only with Net-SNMP)
-I, --cisco
check cisco memory (sum of all memory pools)
-E, --hp
check HP proccurve memory
-f, --perfdata
Performance data output
-t, --timeout=INTEGER
timeout for SNMP in seconds (Default: 5)
-V, --version
prints version number
</pre>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<p class="SectionBody">This project is hosted on : <br>
<A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
</p>
<p class="SectionBody"> Nagios and the Nagios logo are registered
trademarks of Ethan Galstad.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
</BODY>
</HTML>

377
plugins/doc/snmp_process.html
View file

@ -1,377 +0,0 @@
<HTML>
<HEAD>
<TITLE>Nagios plugins</TITLE>
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
<STYLE type="text/css">
<!--
.Default { font-family: verdana,arial,serif; font-size: 10pt; }
.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
.Email { font-family: verdana,arial,serif; font-size: 10pt;}
.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
-->
</STYLE>
</HEAD>
<body background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
<table border="0">
<tr>
<td valign=top>
<!-- Begin Side Bar -->
<table border="0" width="125" valign=top>
<tr>
<td><a href="http://nagios.manubulon.com/" class="SideNavBarItem" >Home</a></td>
</tr>
<tr>
<td></td>
</tr>
<tr>
<td><BR>
</td>
</tr>
<tr>
<td> </td>
</tr>
</table>
<!-- End Side Bar -->
</td>
<td valign=top>
<table border="0" valign=top>
<tr>
<td class="ProgramTitle"> Snmp process check</td>
</tr>
<tr>
<td>
<p class="NewsItemDate">Script : check_snmp_process.pl</p>
<p class="SectionTitle"> Last update : Jun 09 2007</p>
</td>
</tr>
<tr>
<td valign="top">
<p class="SectionTitle">Description : </p>
<p class="SectionBody">Checks by snmp v1 or v3 if a process is running
and how many instances are running (minimum &amp; maximum). <br>
It is also possible to check memory and cpu used by one or a group
of process<br>
<br>
Works on Windows, Linux/Unix, AS400.</p>
<p class="SectionBody"> Vérifie par snmp v1 ou v3 si un process tourne
et combien d'instances de ce process tournent (minimum et maximum).<br>
Il est &eacute;galement possible de v&eacute;rifier la m&eacute;moire
et le cpu utilis&eacute;.<br>
<br>
<span class="SectionTitle"> Standard checks<br>
</span></p>
<p class="SectionBody">The plugin checks if there is at least one
process matching the filter (<b>-n </b>option) when no warning or
critical levels are set. <br>
The filter is treated as a regular expression by default, but you
can deactivate this (<b>-r</b>)</p>
<p class="SectionBody">With the following options, you can add to your process selection : </p>
<p class="SectionBody">-f : get full path of the script instead of only it's name</p>
<p class="SectionBody">-A : add parameters with the script name</p>
<table border="1">
<tr>
<th class="SectionBody" scope="col">Option</th>
<th class="SectionBody" scope="col">how the script will see the process </th>
</tr>
<tr>
<td class="SectionBody">None</td>
<td><span class="SectionBody">named</span></td>
</tr>
<tr>
<td class="SectionBody">-f</td>
<td><span class="SectionBody">/usr/sbin/named</span></td>
</tr>
<tr>
<td class="SectionBody">-A</td>
<td><span class="SectionBody">named -u named -t /var/named/chroot</span></td>
</tr>
<tr>
<td class="SectionBody">-f -A </td>
<td><span class="SectionBody">/usr/sbin/named -u named -t /var/named/chroot</span></td>
</tr>
</table>
<p class="SectionBody">Warning : the -f &amp; -A option will not function properly for Windows hosts (the snmp agent don't give this information)</p>
<p class="SectionBody"> You can use -w and -c options to set the warning
and critical levels : <br>
<b>-w &lt;minW&gt;,&lt;maxW&gt; </b>: with minW and maxW the minimum
and maximum number of processes.<br>
<br>
<b>-c &lt;minC&gt;,&lt;maxC&gt;</b> : same thing<br>
Of course : <b>minC &lt;= minW &lt; maxW &lt;=maxC</b><br>
<i><br>
You can omit &lt;maxW&gt; and &lt;maxC&gt;</i><br>
<br>
Saying N is the current number of processes<br>
- N &lt; minC : critical<br>
- minC &lt; N &lt;=minW : warning<br>
- minW&lt; N &lt;= maxW : OK<br>
- maxW&lt; N &lt;= maxC : warning<br>
- maxC &lt; N : critical<br>
</p>
<p class="SectionTitle">Memory checks </p>
<p class="SectionBody">The <b>-m </b>option can check the memory used
by the selected processes.<br>
By default, this will select the process wich use the maximum memory.
The <b>-a</b> switch will make an average<br>
<br>
Ex : <b>-m 7,20 </b>will send a warning if a process uses more than
7 Mb, and critical for more than 20Mb.</p>
<p class="SectionTitle">CPU checks</p>
<p class="SectionBody">When you use the <b>-u </b>option, a temporary
file will be created in &quot;/tmp&quot; by default : this can be
changed at the beginning of the script. <br>
The file name will be : tmp_Icinga_proc.&lt;host IP&gt;.&lt;process
filter&gt;.</p>
<p class="SectionBody">The -u option will add all the cpu used by
all selected process and the make the check<br>
</p>
<p class="SectionBody"><b>-u 91,95</b> : will send a warning if more
than 91% of cpu is used, and critical if more than 95% is used.</p>
<p class="SectionBody">On multiprocessor hosts, the % of cpu use can
be &gt; 100% : on a 4 CPU host, cpu usage can go up to 400% (the
script doesn't check if a host is multiprocessor or not).</p>
<p class="SectionBody">The script curently wants a minimum of 5 minutes
between values taken from host (can be changed at the beginning
of the scripts). You can check more than once every 5 minutes but
don't put check-interval to more than 15 minutes.<br>
When the script doesn't have enough data to compute the CPU use
(for example, the first time it is run), then it will return a UNKNOWN
status. </p>
<p class="SectionBody"><b>Msg size option </b>(<i>-o</i><b><i> </i></b>option)</p>
<p class="SectionBody">In case you get a &quot;ERROR: running table
: Message size exceeded maxMsgSize&quot; error, you may need to
adjust the maxMsgSize, i.e. the maximum size of snmp message with
the -o option. Try a value with the -o AND the -v option : the script
will output the actual value so you can add some octets to it with
the -o option.</p>
<p class="SectionBody"><span class="SectionTitle">SNMP Login</span><br>
</p>
<p class="SectionBody">See <a href="index_info.html">snmp info page</a></p>
<p class="SectionTitle">Requirements :</p>
<p class="SectionBody"> - Perl in /usr/bin/perl - or just run 'perl
script' <br>
- Net::SNMP<br>
- file 'utils.pm' in plugin diretory<br>
</p>
<p class="SectionBody"><a href="check_snmp_process.pl" class="SectionTitle">Dowload
latest version : 1.5</a> </p>
<p class="SectionBody"><a href="index_commands.html" class="SectionTitle">Configurations
examples</a></p>
<p class="SectionBody"><span class="SectionTitle">Changelog</span>
: On CVS repository on sourceforge : <a href="http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/">http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/</a>.</p>
<p class="SectionTitle">Examples :</p>
<p class="SectionBody"><br>
All examples below are considering the script is local directory.
Host to be checked is 127.0.0.1 with snmp community &quot;public&quot;.</p>
<p class="SectionBody">If multiple interfaces are selected, all must
be up to get an OK result</p>
<table border="1" cellspacing="5" width="819">
<tr>
<td class="NewsItemDate" valign = top width="261">
<p>Get help
</td>
<td class="SectionBody" width="533">
<p>./check_snmp_process.pl <b>-h</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="261">snmpv3 login</td>
<td class="SectionBody" width="533">./check_snmp_process.pl -H
127.0.0.1 -l login -x passwd<b></b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="261">
<p>Check if at least one process matching http is running
</td>
<td class="SectionBody" width="533">
<p>./check_snmp_process.pl -H 127.0.0.1 -C public <b>-n http</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="261">
<p align="right">Result example :
</td>
<td class="SectionBody" width="533">
<p>3 process matching http : &gt; 0 : OK</p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="261">
<p>Check if at least 3 process matching http are running
</td>
<td class="SectionBody" width="533">
<p>./check_snmp_process.pl -H 127.0.0.1 -C public -n http<b>
-w 2 -c 0</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="261">
<div align="right">Result example : <br>
(&lt;=2 will return warning, 0 critical)</div>
</td>
<td class="SectionBody" width="533">3 process matching httpd :
&gt; 2 : OK</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="261">Check if at
least one process named &quot;httpd&quot; exists (no regexp)</td>
<td class="SectionBody" width="533">./check_snmp_process.pl -H
127.0.0.1 -C public -n http <b>-r</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="261">
<p align="right">Result example : </p>
</td>
<td class="SectionBody" width="533">3 process <b>named</b> httpd
: &gt; 0 : OK</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="261">Check process
by their full path : check process of /opt/soft/bin/ (at least
one) </td>
<td class="SectionBody" width="533">./check_snmp_process.pl -H
127.0.0.1 -C public <b>-n /opt/soft/bin/ -f</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="261">Check that at
least 3 process but not more than 8 are running</td>
<td class="SectionBody" width="533">./check_snmp_process.pl -H
127.0.0.1 -C public -n http <b>-w 3,8 -c 0,15</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="261">Same checks
+ checks maximum memory used by process (in Mb) : warning and
critical levels</td>
<td class="SectionBody" width="533">./check_snmp_process.pl -H
127.0.0.1 -C public -n http -w 3,8 -c 0,15 <b>-m 9,25</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="261">Same check but
sum all CPU used by all selected process</td>
<td class="SectionBody" width="533">./check_snmp_process.pl -H
127.0.0.1 -C public -n http -w 3,8 -c 0,15 -m 9,25 <b>-u 70,99</b></td>
</tr>
</table>
<p class="NewsItemDate">Output of check_snmp_process.pl -h</p>
<table border="1" cellspacing="5">
<tr>
<td class="SectionBody" valign = top>
<p>SNMP Process Monitor for Nagios version 1.5<br>
GPL licence, (c)2004-2006 Patrick Proy</p>
<p>Usage: ./check_snmp_process.pl [-v] -H &lt;host&gt; -C &lt;snmp_community&gt; [-2] | (-l login -x passwd) [-p &lt;port&gt;] -n &lt;name&gt; [-w &lt;min_proc&gt;[,&lt;max_proc&gt;] -c &lt;min_proc&gt;[,max_proc] ] [-m&lt;warn Mb&gt;,&lt;crit Mb&gt; -a -u&lt;warn %&gt;,&lt;crit%&gt; -d&lt;delta&gt; ] [-t &lt;timeout&gt;] [-o &lt;octet_length&gt;] [-f -A -F ] [-r] [-V] [-g]<br>
-v, --verbose<br>
print extra debugging information (and lists all storages)<br>
-h, --help<br>
print this help message<br>
-H, --hostname=HOST<br>
name or IP address of host to check<br>
-C, --community=COMMUNITY NAME<br>
community name for the host's SNMP agent (implies SNMP v1 or v2c with option)<br>
-l, --login=LOGIN ; -x, --passwd=PASSWD, -2, --v2c<br>
Login and auth password for snmpv3 authentication <br>
If no priv password exists, implies AuthNoPriv <br>
-2 : use snmp v2c<br>
-X, --privpass=PASSWD<br>
Priv password for snmpv3 (AuthPriv protocol)<br>
-L, --protocols=&lt;authproto&gt;,&lt;privproto&gt;<br>
&lt;authproto&gt; : Authentication protocol (md5|sha : default md5)<br>
&lt;privproto&gt; : Priv protocole (des|aes : default des) <br>
-p, --port=PORT<br>
SNMP port (Default 161)<br>
-n, --name=NAME<br>
Name of the process (regexp)<br>
No trailing slash !<br>
-r, --noregexp<br>
Do not use regexp to match NAME in description OID<br>
-f, --fullpath<br>
Use full path name instead of process name <br>
(Windows doesn't provide full path name)<br>
-A, --param<br>
Add parameters to select processes.<br>
ex : &quot;named.*-t /var/named/chroot&quot; will only select named process with this parameter <br>
-F, --perfout<br>
Add performance output<br>
outputs : memory_usage, num_process, cpu_usage<br>
-w, --warn=MIN[,MAX]<br>
Number of process that will cause a warning <br>
-1 for no warning, MAX must be &gt;0. Ex : -w-1,50<br>
-c, --critical=MIN[,MAX]<br>
number of process that will cause an error (<br>
-1 for no critical, MAX must be &gt;0. Ex : -c-1,50<br>
Notes on warning and critical : <br>
with the following options : -w m1,x1 -c m2,x2<br>
you must have : m2 &lt;= m1 &lt; x1 &lt;= x2<br>
you can omit x1 or x2 or both<br>
-m, --memory=WARN,CRIT<br>
checks memory usage (default max of all process)<br>
values are warning and critical values in Mb<br>
-a, --average<br>
makes an average of memory used by process instead of max<br>
-u, --cpu=WARN,CRIT<br>
checks cpu usage of all process<br>
values are warning and critical values in % of CPU usage<br>
if more than one CPU, value can be &gt; 100% : 100%=1 CPU<br>
-d, --delta=seconds<br>
make an average of &lt;delta&gt; seconds for CPU (default 300=5min) <br>
-g, --getall<br>
In some cases, it is necessary to get all data at once because<br>
process die very frequently.<br>
This option eats bandwidth an cpu (for remote host) at breakfast.<br>
-o, --octetlength=INTEGER<br>
max-size of the SNMP message, usefull in case of Too Long responses.<br>
Be carefull with network filters. Range 484 - 65535, default are<br>
usually 1472,1452,1460 or 1440. <br>
-t, --timeout=INTEGER<br>
timeout for SNMP in seconds (Default: 5)<br>
-V, --version<br>
prints version number<br>
Note : <br>
CPU usage is in % of one cpu, so maximum can be 100% * number of CPU <br>
example : <br>
Browse process list : &lt;script&gt; -C &lt;community&gt; -H &lt;host&gt; -n &lt;anything&gt; -v <br>
the -n option allows regexp in perl format : <br>
All process of /opt/soft/bin : -n /opt/soft/bin/ -f<br>
All 'named' process : -n named<br>
<br>
</p>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<p class="SectionBody">This project is hosted on : <br>
<A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
</p>
<p class="SectionBody"> Nagios and the Nagios logo are registered
trademarks of Ethan Galstad.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
<p>&nbsp;</p>
</BODY>
</HTML>

1330
plugins/doc/snmp_storage.html
View file

File diff suppressed because it is too large Load diff

358
plugins/doc/snmp_vrrp.html
View file

@ -1,358 +0,0 @@
<HTML>
<HEAD>
<TITLE>Nagios plugins</TITLE>
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
<STYLE type="text/css">
<!--
.Default { font-family: verdana,arial,serif; font-size: 10pt; }
.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
.Email { font-family: verdana,arial,serif; font-size: 10pt;}
.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
-->
</STYLE>
</HEAD>
<body background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
<table border="0">
<tr>
<td valign=top>
<!-- Begin Side Bar -->
<table border="0" width="125" valign=top>
<tr>
<td><a href="http://nagios.manubulon.com/" class="SideNavBarItem" >Home</a></td>
</tr>
<tr>
<td></td>
</tr>
<tr>
<td><BR>
</td>
</tr>
<tr>
<td> </td>
</tr>
</table>
<!-- End Side Bar -->
</td>
<td valign=top>
<table border="0" valign=top>
<tr>
<td class="ProgramTitle"> Snmp vrrp check</td>
</tr>
<tr>
<td>
<p class="NewsItemDate">Script : check_snmp_vrrp.pl</p>
<p class="SectionTitle"> Last update : Sept 4 2006</p>
</td>
</tr>
<tr>
<td valign="top">
<p class="SectionTitle">Description : </p>
<p class="SectionBody">Checks by snmp v1, v2c or v3 the vrrp status
of all vrrp enabled interfaces. <br>
Works on<br>
- Nokia IP with ipso 3.X , 4.X in VRRP mode.<br>
- Nokia IP with ipso 3.X , 4.X in clustering mode.<br>
- Radware Linkproof<br>
- Alteon AD4 Loadbalancers</p>
<p class="SectionBody">Depending on the state you put as option (&quot;master&quot;
or &quot;backup&quot;) the script will get all the vrrp enables
interface and check they are in this state. <br>
If not, it will retrun a critical status<br>
By default, it will check Nokia IP platforms using vrrp, you can
test other platforms with the '-T' option :<br>
<br>
- Alteon<br>
- Linkproof (VRRP)<br>
- Nokia clustering.</p>
<p class="SectionTitle">Nokia clustering check</p>
<p class="SectionBody">Nokia clustering check does not have a master
&amp; backup state. Instead, the plugin will check : </p>
<p class="SectionBody">- The number of cluster member<br>
- The % load on each cluster.</p>
<p class="SectionBody">For example <b>-s 2,90</b> will issue <br>
- A critical level if there is not 2 members.<br>
- A warning level if more than 90% is assigned to one cluster member.</p>
<p class="SectionBody">To have a long output, put the '-g' option.</p>
<p class="SectionBody"><span class="SectionTitle">SNMP Login</span><br>
</p>
<p class="SectionBody">See <a href="index_info.html">snmp info page</a></p>
<p class="SectionBody"><span class="SectionTitle">French </span>:
Vérifie par snmp v1 ou v3 l'&eacute;tat des interfaces vrrp : Nokia,
Linkproof, Alt&eacute;on ou l'&eacute;tat d'un cluster Nokia.</p>
<p class="SectionTitle">Requirements :</p>
<p class="SectionBody"> - Perl in /usr/bin/perl - or just run 'perl
script' <br>
- Net::SNMP<br>
- file 'utils.pm' in plugin diretory<br>
</p>
<p class="SectionBody"><a href="check_snmp_vrrp.pl" class="SectionTitle">Dowload
lastest version : 1.3</a> </p>
<p class="SectionBody"><a href="index_commands.html" class="SectionTitle">Configurations
examples</a></p>
<p class="SectionTitle">Examples :</p>
<p class="SectionBody"><br>
All examples below are considering the script is local directory.
Host to be checked is 127.0.0.1 with snmp community &quot;public&quot;.</p>
<p class="SectionBody">If multiple interfaces are selected, all must
be up to get an OK result</p>
<table border="1" cellspacing="5">
<tr>
<td class="NewsItemDate" valign = top width="282">
<p>Get help
</td>
<td class="SectionBody" width="387">
<p>./check_snmp_vrrp.pl <b>-h</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">snmpv3 login</td>
<td class="SectionBody" width="387">./check_snmp_vrrp.pl -H 127.0.0.1
-l login -x passwd<b></b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<p>Check vrrp state of a node to be master.
</td>
<td class="SectionBody" width="387">
<p>./check_snmp_vrrp.pl -H 127.0.0.1 -C public <b>-s master</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<div align="right">
<p>Output example :<br>
The ouput is : &lt;vrid&gt;(&lt;state&gt;,&lt;status&gt;,&lt;priority&gt;)
</p>
</div>
</td>
<td class="SectionBody" width="387">Vrid : 10(master/up/100),
1(master/up/100), 3(master/up/100), 2(master/up/100), : All
master :OK</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">Check vrrp state
of a node to be backup. </td>
<td class="SectionBody" width="387">./check_snmp_vrrp.pl -H 127.0.0.1
-C public <b>-s backup</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">
<p align="right">Output example :
</td>
<td class="SectionBody" width="387">
<p>Vrid : 1(backup/up/95), 3(backup/up/95), 10(backup/up/95),
2(backup/up/95), : All backup :OK</p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">Test a Linkproof</td>
<td class="SectionBody" width="387">./check_snmp_vrrp.pl -H 127.0.0.1
-C public -s master <b>-T lp</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="282">Test a Nokia
cluster : 2 cluster members and max 90% load assigned to one
cluster. </td>
<td class="SectionBody" width="387">./check_snmp_vrrp.pl -H 127.0.0.1
-C public <b>-s 2,90%-T ipso</b></td>
</tr>
</table>
<p class="NewsItemDate"><span class="SectionTitle">Changelog</span>
: On CVS repository on sourceforge : <a href="http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/">http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/</a>.</p>
<p class="NewsItemDate">Output of check_snmp_vrrp.pl -h</p>
<table border="1" cellspacing="5">
<tr>
<td class="SectionBody" valign = top>
<p class="SectionBody">SNMP VRRP Monitor for Nagios version
1.3<br>
(c)2004-2006 to my cat Ratoune - Author : Patrick Proy
<p>Usage: ./check_snmp_vrrp.pl [-v] -H &lt;host&gt; -C &lt;snmp_community&gt;
[-2] | (-l login -x passwd [-X pass -L &lt;authp&gt;,&lt;privp&gt;])
-s &lt;master|backup|num,%&gt; [-T &lt;nokia|alteon|lp|nsc|ipsocluster&gt;]
[-p &lt;port&gt;] [-t &lt;timeout&gt;] [-V]<br>
-v, --verbose<br>
print extra debugging information (including interface list
on the system)<br>
-h, --help<br>
print this help message<br>
-H, --hostname=HOST<br>
name or IP address of host to check<br>
-C, --community=COMMUNITY NAME<br>
community name for the host's SNMP agent (implies v1 protocol)<br>
-2, --v2c<br>
Use snmp v2c<br>
-l, --login=LOGIN ; -x, --passwd=PASSWD<br>
Login and auth password for snmpv3 authentication <br>
If no priv password exists, implies AuthNoPriv <br>
-X, --privpass=PASSWD<br>
Priv password for snmpv3 (AuthPriv protocol)<br>
-L, --protocols=&lt;authproto&gt;,&lt;privproto&gt;<br>
&lt;authproto&gt; : Authentication protocol (md5|sha : default
md5)<br>
&lt;privproto&gt; : Priv protocole (des|aes : default des)
<br>
-P, --port=PORT<br>
SNMP port (Default 161)<br>
-T, --type=&lt;nokia|alteon|lp|nsc|ipso&gt;<br>
Type of vrrp router to check<br>
nokia (default) : Nokai vrrp. Should be working for most vrrp
routers<br>
alteon : for Alteon AD4 Loadbalancers<br>
lp : Radware Linkproof<br>
nsc : Nescreen (ScreenOS 5.x NSRP)<br>
ipso : Nokia IPSO clustering<br>
-s, --state=master|backup|num,%<br>
Nokia ipso clustering : number of members, max % assigned
to nodes.<br>
Other : check vrrp interface to be master or backup<br>
-g, --long<br>
Make output long even is all is OK <br>
-t, --timeout=INTEGER<br>
timeout for SNMP in seconds (Default: 5)<br>
-V, --version<br>
prints version number</p>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<p class="SectionBody">This project is hosted on : <br>
<A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
</p>
<p class="SectionBody"> Nagios and the Nagios logo are registered
trademarks of Ethan Galstad.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
<p>&nbsp;</p>
</BODY>
</HTML>

261
plugins/doc/snmp_windows.html
View file

@ -1,261 +0,0 @@
<HTML>
<HEAD>
<TITLE>Nagios plugins</TITLE>
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
<STYLE type="text/css">
<!--
.Default { font-family: verdana,arial,serif; font-size: 10pt; }
.ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
.Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
.Email { font-family: verdana,arial,serif; font-size: 10pt;}
.NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
.NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
.NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
.NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
.NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
.SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
.SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
.ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
.Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
-->
</STYLE>
</HEAD>
<body background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
<table border="0">
<tr>
<td valign=top>
<!-- Begin Side Bar -->
<table border="0" width="125" valign=top>
<tr>
<td><a href="http://nagios.manubulon.com/" class="SideNavBarItem" >Home</a></td>
</tr>
<tr>
<td></td>
</tr>
<tr>
<td><BR>
</td>
</tr>
<tr>
<td> </td>
</tr>
</table>
<!-- End Side Bar -->
</td>
<td valign=top>
<table border="0" valign=top>
<tr>
<td class="ProgramTitle"> Snmp windows check</td>
</tr>
<tr>
<td>
<p class="NewsItemDate">Script : check_snmp_win.pl</p>
<p class="SectionTitle"> Last update : Jan 11 2007</p>
</td>
</tr>
<tr>
<td valign="top">
<p class="SectionTitle">Description : </p>
<p class="SectionBody">Checks by snmp v1 or v3 windows specific health
monitoring (service state for now).<br>
<br>
Works on Windows server (2000, 2003) maybe XP and NT.</p>
<p class="SectionBody"> Vérifie par snmp v1 ou v3 si un(des) service
Windows tournent.<br>
<br>
<span class="SectionTitle"> Service checks <br>
</span></p>
<p class="SectionBody">The plugin checks if there if the Windows service(s)
he gets as input are running. <br>
You can provide multiple services, comma separated : <br>
<b>-n &lt;service1&gt;,&lt;service2&gt;</b> </p>
<p class="SectionBody">The script will return : <br>
OK : if &lt;service1&gt; is found (and active) and &lt;service2&gt;
is found (and active). <br>
WARNING : if &lt;service1&gt; and &lt;service2&gt; match <b>more</b>
than 2 active services.<br>
CRITICAL : if &lt;service1&gt; OR &lt;service2&gt; don't match any
active service. </p>
<p class="SectionBody"><b>-N &lt;number&gt; </b>: will return OK if
&lt;number&gt; of active services matches the filter</p>
<p class="SectionBody"><b>-s </b>: will show all active services instead
of the non active ones only</p>
<p class="SectionTitle">Requirements :</p>
<p class="SectionBody"> - Perl in /usr/bin/perl - or just run 'perl
script' <br>
- Net::SNMP<br>
- file 'utils.pm' in plugin diretory<br>
</p>
<p class="SectionBody"><a href="check_snmp_win.pl" class="SectionTitle">Dowload
latest version : 0.6</a> </p>
<p class="SectionBody"><a href="index_commands.html" class="SectionTitle">Configurations
examples</a></p>
<p class="SectionTitle">Examples :</p>
<p class="SectionBody"><br>
All examples below are considering the script is local directory.
Host to be checked is 127.0.0.1 with snmp community &quot;public&quot;.</p>
<p class="SectionBody">If multiple interfaces are selected, all must
be up to get an OK result</p>
<table border="1" cellspacing="5" width="819">
<tr>
<td class="NewsItemDate" valign = top width="262">
<p>Get help
</td>
<td class="SectionBody" width="532">
<p>./check_snmp_win.pl <b>-h</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="262">snmpv3 login</td>
<td class="SectionBody" width="532">./check_snmp_win.pl -H 127.0.0.1
-l login -x passwd<b></b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="262">
<p>Check if at least one process matching dns is running
</td>
<td class="SectionBody" width="532">
<p>./check_snmp_win.pl -H 127.0.0.1 -C public <b>-n dns</b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="262">
<p align="right">Result example :
</td>
<td class="SectionBody" width="532">
<p>1 services active (matching &quot;dns&quot;) : OK</p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="262">
<p>Check if at least 3 process matching dns are running
</td>
<td class="SectionBody" width="532">
<p>./check_snmp_win.pl -H 127.0.0.1 -C public -n http<b> -N
2 </b></p>
</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="262">
<div align="right">Result example : <br>
(&lt;=2 will return warning, 0 critical)</div>
</td>
<td class="SectionBody" width="532">1 services active (matching
&quot;dns&quot;) : CRITICAL</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="262">Check if dns
and ssh services are running</td>
<td class="SectionBody" width="532">./check_snmp_win.pl -H 127.0.0.1
-C public -n dns,ssh</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="262">
<p align="right">Result example : </p>
</td>
<td class="SectionBody" width="532">&quot;dns&quot; active, &quot;ssh&quot;
active : OK</td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="262">Check if dns
and toto services are running</td>
<td class="SectionBody" width="532">./check_snmp_win.pl -H 127.0.0.1
-C public <b>-n dns,toto</b></td>
</tr>
<tr>
<td class="NewsItemDate" valign = top width="262">
<div align="right">Result example : </div>
</td>
<td class="SectionBody" width="532">&quot;toto&quot; not active
: CRITICAL</td>
</tr>
</table>
<p>&nbsp;</p>
<p class="NewsItemDate"><span class="SectionTitle">Changelog</span>
: On CVS repository on sourceforge : <a href="http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/">http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/</a>.<br>
</p>
<p class="NewsItemDate">Output of check_snmp_win.pl -h</p>
<table border="1" cellspacing="5">
<tr>
<td class="SectionBody" valign = top>
<p>SNMP Windows Monitor for Nagios version 0.6<br>
GPL licence, (c)2004-2005 Patrick Proy</p>
<p>Usage: check_snmp_win [-v] -H &lt;host&gt; -C &lt;snmp_community&gt;
[-2] | (-l login -x passwd) [-p &lt;port&gt;] -n &lt;name&gt;[,&lt;name2]
[-T=service] [-r] [-s] [-N=&lt;n&gt;] [-t &lt;timeout&gt;]
[-V]<br>
-v, --verbose<br>
print extra debugging information (and lists all services)<br>
-h, --help<br>
print this help message<br>
-H, --hostname=HOST<br>
name or IP address of host to check<br>
-C, --community=COMMUNITY NAME<br>
community name for the host's SNMP agent (implies SNMP v1
or v2c with option)<br>
-2, --v2c<br>
Use snmp v2c<br>
-l, --login=LOGIN<br>
Login for snmpv3 authentication (implies v3 protocol with
MD5)<br>
-x, --passwd=PASSWD<br>
Password for snmpv3 authentication<br>
-p, --port=PORT<br>
SNMP port (Default 161)<br>
-T, --type=service<br>
Check type : <br>
- service (default) checks service<br>
-n, --name=NAME[,NAME2...]<br>
Comma separated names of services (perl regular expressions
can be used for every one).<br>
By default, it is not case sensitive.<br>
-N, --number=&lt;n&gt;<br>
Compare matching services with &lt;n&gt; instead of the number
of names provided.<br>
-s, --showall<br>
Show all services in the output, instead of only the non-active
ones.<br>
-r, --noregexp<br>
Do not use regexp to match NAME in service description.<br>
-t, --timeout=INTEGER<br>
timeout for SNMP in seconds (Default: 5)<br>
-V, --version<br>
prints version number<br>
Note : <br>
The script will return <br>
OK if ALL services are in active state,<br>
WARNING if there is more than specified (ex 2 service specified,
3 active services matching), <br>
CRITICAL if at least one of them is non active.<br>
The -n option will allows regexp in perl format <br>
-n &quot;service&quot; will match 'service WINS' 'sevice DNS'
etc...<br>
It is not case sensitive by default : WINS = wins</p>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<p class="SectionBody">This project is hosted on : <br>
<A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A>
</p>
<p class="SectionBody"> Nagios and the Nagios logo are registered
trademarks of Ethan Galstad.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
<p>&nbsp;</p>
</BODY>
</HTML>