New upstream version 2.0.0

This commit is contained in:
Jan Wagner 2016-12-04 11:31:25 +01:00
parent e8c75af4e8
commit e1ab4578a6
71 changed files with 20366 additions and 9590 deletions

256
plugins/doc/faq.html Executable file
View file

@ -0,0 +1,256 @@
<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 Executable file
View file

@ -0,0 +1,431 @@
<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 Executable file

File diff suppressed because it is too large Load diff

471
plugins/doc/snmp_cpfw.html Executable file
View file

@ -0,0 +1,471 @@
<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 Executable file
View file

@ -0,0 +1,381 @@
<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 Executable file
View file

@ -0,0 +1,370 @@
<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 Executable file
View file

@ -0,0 +1,673 @@
<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 Executable file
View file

@ -0,0 +1,409 @@
<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 Executable file
View file

@ -0,0 +1,485 @@
<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 Executable file
View file

@ -0,0 +1,377 @@
<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 Executable file

File diff suppressed because it is too large Load diff

358
plugins/doc/snmp_vrrp.html Executable file
View file

@ -0,0 +1,358 @@
<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 Executable file
View file

@ -0,0 +1,261 @@
<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>