check-packeteer.pl - Nagios data from traffic shaper/monitor <link type="text/css" rel="stylesheet" href="http://www.smekal.at/default.css"> </HEAD> <BODY> <DIV class="main"> <H1>check-packeteer.pl - a Nagios plugin for network statistics</H1> <H2>Read anything you can get out of your <ahref=http://www.packeteer.com> Packeteer</a> network measurement/traffic shaping appliance</H2> <a href=check-packeteer_0.1.png><img src=t_check-packeteer_0.1.png align=right></a> <P class="date">May 22nd 2007</P> <P class="news"><a href=../check-packeteer-v0.2.tgz>v0.2</a>, introducing a new feature and a bugfix is available. See the <a href=CHANGELOG>changelog</a> for details. <P class="date">January 31st 2007</P> <P class="news"><a href=screenshots>Screenshots</a> illustrating the true power of this couple are available.</P> <P class="date">November 27th 2006</P> <P class="news"><a href=../check-packeteer-0.1.tgz>v0.1</a> out now<BR> This is the initial release of check-packeteer.pl, a plugin for the <a href=http://www.nagios.org>Nagios</a> network monitoring environment. <H2>Introduction</H2> <P>Nagios is an open source host, service and network monitoring program. Read all about it at <a href=http://www.nagios.org>http://www.nagios.org</a> <p> <strong><a href=../check-packeteer-0.1.tgz><em>check-packeteer.pl</em></a> </strong> is a plugin for the <a href=http://www.nagios.org>Nagios</a> network monitoring system. It is designed to read traffic statistics from a <a href="http://www.packeteer.com">Packeteer</a> appliance via HTTP request and return the status to Nagios. <H2>Prerequisites</H2> In order to use check-packeteer.pl you will at least need the following: <ul> <li>Perl v5 (developed in Perl v5.8.0, tested on perl 5.8.8) <li>Digest::MD5 Perl module to calculate md5 hash of credentials <li>LWP::UserAgent for HTTP communication </ul> ... and by the way, a working Nagios environment and a Packeteer appliance could also come in handy ;-) <H2>Installation</H2> <p>Copy the script to your favourite nagios-plugin location i.e. <em>/usr/lib/nagios/plugins/</em> and make sure it is read/executable by the nagios daemon (<em>chmod 755</em>). <p>Life gets a lot easier if you add a section to your <em>/etc/nagios/checkcommands.cfg</em> file: <pre class="code"> define command{ command_name check-packeteer command_line $USER1$/check_packeteer.pl -host 10.11.12.13 -hash 893c830ea67a0ad636c81f8f93d99002 -target $ARG1$ -variable $ARG2$ -period $ARG3$ -warn $ARG4$ -crit $ARG5$ } </pre> Where the value after '-hash' is a md5 hash in hex format, calculated from the concatenated Packeteer password and serial number. <p>For details on command line options just call check-packeteer.pl without any arguments. <p>To add a sensor to your Nagios environment just a a section to your /etc/nagios/services.cfg containing something like: <pre class="code"> define service { use generic-packeteer service_description TCP connection inits out 10min check_command check-packeteer!/Outbound!tcp-conn-inits!600!1000!1500 } </pre> Let Nagios reload its configuration ('service nagios reload' on RedHat) and off you go ... <HR> <H2>Copyright notice</H2> <P>This program is free software; you can redistribute it and/or modify it under the terms of the <a href=http://www.gnu.org/copyleft>GNU General Public License</a> as published by the <a href=http://www.fsf.org>Free Software Foundation</a> ; either version 2 of the License, or (at your option) any later version. <P>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. <P>You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. </DIV> <DIV class="menu"> <P><A href="../../index.html">Home</A></P> <P><A href="../../code/">Code Library</A></P> <P><A href="../../hobbies.html">Hobbies</A></P> <P><A href="../../images/Gallerie.html">Photogallerie</A></P> </DIV> <DIV class="bottom"> <P><EM>Wed. 31st Jan. 2007</EM> Autor: <A href="mailto:goesta@smekal.at">Goesta Smekal</A></P> <P><A href="/gpg-public-key">GPG Key</A> Fingerprint: AD9C F48E E419 11D1 894F 31A5 2C02 85F9 8259 AB93</P> </DIV> </BODY> </HTML>