From 5705e8b4cfea851be6dbdd0b5d407fa2d40020110cecbd0171301f3563b3e7ec Mon Sep 17 00:00:00 2001 From: Lars Vogdt Date: Wed, 30 Jul 2014 19:20:49 +0000 Subject: [PATCH] osc copypac from project:server:monitoring package:nagios-plugins-sentry3 revision:1 OBS-URL: https://build.opensuse.org/package/show/server:monitoring/monitoring-plugins-sentry3?expand=0&rev=1 --- .gitattributes | 23 + .gitignore | 1 + LICENSE | 340 ++++++++ check_sentry3 | 774 ++++++++++++++++++ ...try3-fix_output_with_missing_sensors.patch | 33 + gauge_single_rrd_one_chart_per_rra.php | 103 +++ nagios-plugins-sentry3.changes | 6 + nagios-plugins-sentry3.spec | 68 ++ 8 files changed, 1348 insertions(+) create mode 100644 .gitattributes create mode 100644 .gitignore create mode 100644 LICENSE create mode 100644 check_sentry3 create mode 100644 check_sentry3-fix_output_with_missing_sensors.patch create mode 100644 gauge_single_rrd_one_chart_per_rra.php create mode 100644 nagios-plugins-sentry3.changes create mode 100644 nagios-plugins-sentry3.spec diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..9b03811 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,23 @@ +## Default LFS +*.7z filter=lfs diff=lfs merge=lfs -text +*.bsp filter=lfs diff=lfs merge=lfs -text +*.bz2 filter=lfs diff=lfs merge=lfs -text +*.gem filter=lfs diff=lfs merge=lfs -text +*.gz filter=lfs diff=lfs merge=lfs -text +*.jar filter=lfs diff=lfs merge=lfs -text +*.lz filter=lfs diff=lfs merge=lfs -text +*.lzma filter=lfs diff=lfs merge=lfs -text +*.obscpio filter=lfs diff=lfs merge=lfs -text +*.oxt filter=lfs diff=lfs merge=lfs -text +*.pdf filter=lfs diff=lfs merge=lfs -text +*.png filter=lfs diff=lfs merge=lfs -text +*.rpm filter=lfs diff=lfs merge=lfs -text +*.tbz filter=lfs diff=lfs merge=lfs -text +*.tbz2 filter=lfs diff=lfs merge=lfs -text +*.tgz filter=lfs diff=lfs merge=lfs -text +*.ttf filter=lfs diff=lfs merge=lfs -text +*.txz filter=lfs diff=lfs merge=lfs -text +*.whl filter=lfs diff=lfs merge=lfs -text +*.xz filter=lfs diff=lfs merge=lfs -text +*.zip filter=lfs diff=lfs merge=lfs -text +*.zst filter=lfs diff=lfs merge=lfs -text diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..57affb6 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +.osc diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..3b07b23 --- /dev/null +++ b/LICENSE @@ -0,0 +1,340 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc. + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Library General +Public License instead of this License. diff --git a/check_sentry3 b/check_sentry3 new file mode 100644 index 0000000..0f8ead2 --- /dev/null +++ b/check_sentry3 @@ -0,0 +1,774 @@ +#!/usr/bin/perl +# +# check_sentry3 - Nagios(r) network traffic monitor plugin +# Copyright (C) 2012 Peter Harrison / www.linuxhomenetworking.com +# +# This Nagios check monitors Servertech devices that use the Sentry3 MIB. +# It checks the following: +# 1) Environmental temperature (Auto-detects all sensors) +# 2) Environmental humidity (Auto-detects all sensors) +# 3) Input power (Auto-detects all input feeds) +# +# Prerequisite Perl modules: +# +# Net::SNMP +# Nagios::Plugin +# +# Though Net::SNMP may be installable using package systems such as yum or apt, +# Nagios::Plugin may have to be done by hand like this: +# +# $ perl -MCPAN -e 'install Nagios::Plugin' +# +################################################################################ +# Modification History +################################################################################ +# +# Put first modification description below here: +# +################################################################################ +# Legal stuff... +################################################################################ +# +# Send us bug reports, questions and comments about this plugin. +# Latest version of this software: http://www.nagiosexchange.org +# +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation; either version 2 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307 +# +################################################################################ +# Let the coding begin ... +################################################################################ + + + use Getopt::Long; + &Getopt::Long::config('bundling'); + use strict; + use Nagios::Plugin; + use Net::SNMP; + + # Run the program + &main(); + exit; + + +sub main{ + + my $get_help = 0; + my $get_morehelp = 0; + my %cmd_flags = (); + + # SNMP Specific + my %snmp_vars = (); + my %snmp_results = (); + $snmp_vars{port} = 161; + $snmp_vars{version} = 2; + $snmp_vars{community} = "public"; + + # Define the OIDs we are interested in + my %oids = (); + + # + # Important stuff below, do not erase as it is good information: + # + #$oids{temp_value} = "Sentry3-MIB::tempHumidSensorTempValue"; + #$oids{humid_value} = "Sentry3-MIB::tempHumidSensorHumidValue"; + #$oids{power_value} = "Sentry3-MIB::infeedLoadValue"; + # + # I originally used the MIB, but wanted after convertint to Net-SNMP + # I had to use the oids. This is how I got them. + # + # /usr/bin/snmpwalk -v 2c -c public 66.214.208.171 enterprise > file1.txt + # /usr/bin/snmpwalk -v 2c -On -c public 66.214.208.171 enterprise > file2.txt + + $oids{temp_value} = ".1.3.6.1.4.1.1718.3.2.5.1.6"; + $oids{humid_value} = ".1.3.6.1.4.1.1718.3.2.5.1.10"; + $oids{power_value} = ".1.3.6.1.4.1.1718.3.2.2.1.7"; + + # Verify that we have the correct options listed + GetOptions( + "c|critical-level=s" => \$cmd_flags{crit_level}, + "w|warning-level=s" => \$cmd_flags{warn_level}, + "d|temperature" => \$cmd_flags{do_temp}, + "e|humidity" => \$cmd_flags{do_humid}, + "f|power" => \$cmd_flags{do_power}, + "b|celcius" => \$cmd_flags{celcius}, + "B|fahrenheit" => \$cmd_flags{fahrenheit}, + "h|help" => \$get_help, + "m|morehelp" => \$get_morehelp, + "H|hostname=s" => \$snmp_vars{hostname}, + "p|port=i" => \$snmp_vars{port}, + "C|community=s" => \$snmp_vars{community}, + "s|username=s" => \$snmp_vars{username}, + "v|version=i" => \$snmp_vars{version}, + "T|authpassword=s" => \$snmp_vars{authpassword}, + "t|authprotocol=s" => \$snmp_vars{authprotocol}, + "X|privpassword=s" => \$snmp_vars{privpassword}, + "x|privprotocol=s" => \$snmp_vars{privprotocol} + ); + + # Test for file validity and Help + if($get_help){&usage();} + if($get_morehelp){&moreusage();} + if(!$snmp_vars{hostname}){&usage();} + + + # usage notes + if ( + ( ! defined $cmd_flags{crit_level} ) || + ( ! defined $cmd_flags{warn_level} ) + ) {&nagios_exit("Critical Level or Warning Level not specified on the command line","UNKNOWN");} + + # usage notes (Specific to temperature) + if ( + (( ! defined $cmd_flags{celcius} ) && + ( ! defined $cmd_flags{fahrenheit} )) && + defined $cmd_flags{do_temp} + ) {&nagios_exit("Temperature mode defined, but don't know whether to use Celcius or Fahrenheit mode","UNKNOWN");} + + # Define what to do + if(defined $cmd_flags{do_temp}){ + $cmd_flags{do_power} = 0; + $cmd_flags{do_humid} = 0; + } + elsif(defined $cmd_flags{do_humid}){ + $cmd_flags{do_temp} = 0; + $cmd_flags{do_power} = 0; + } + elsif(defined $cmd_flags{do_power}){ + $cmd_flags{do_temp} = 0; + $cmd_flags{do_humid} = 0; + } + + &nagios_report(\%cmd_flags,\%snmp_vars,\%oids); + +} + +sub nagios_report { + + # Passing multiple arrays into subroutine + my %cmd_flags = %{$_[0]}; + my %snmp_vars = %{$_[1]}; + my %oids = %{$_[2]}; + + my %poll_results = (); + my @nagios_value = ""; + my $np = 0; + my $np_threshold = 0; + my $temp_uom = ""; + my $count = -1; + my $message = ""; + + # Get all the OID values + my ($poll_pointer) = &get_data(\%cmd_flags,\%snmp_vars,\%oids); + + # Get the results + %poll_results = %$poll_pointer; + + # Create the object, we are going to be adding data to it multiple times + if ($cmd_flags{do_temp}){ + $np = Nagios::Plugin->new(shortname => "SERVERTECH_TEMPERATURE"); + } + elsif ($cmd_flags{do_humid}){ + $np = Nagios::Plugin->new(shortname => "SERVERTECH_HUMIDITY"); + } + elsif ($cmd_flags{do_power}){ + $np = Nagios::Plugin->new(shortname => "SERVERTECH_AMPS"); + } + + foreach my $key (sort keys(%poll_results)){ + + # Increment count + $count +=1; + + # Define the values we are going to test against + $nagios_value[$count] = sprintf("%.2f",$poll_results{$key}); + + # Process the value + if ($cmd_flags{do_temp}){ + + # Set up the thresholds we are interested in + $np_threshold = $np->set_thresholds( + warning => $cmd_flags{warn_level} , + critical => $cmd_flags{crit_level} ); + + # Determine the Unit of Measure + if ($cmd_flags{celcius}){$temp_uom = "C";}else{$temp_uom = "F";} + + # Define the performance data + $np->add_perfdata( + label => "Temperature" . sprintf("%d",$count + 1), + value => $nagios_value[$count], + threshold => $np_threshold, + uom => $temp_uom + ); + + # Update $message + $message .= "Temperature" . sprintf("%d @ ", $count + 1) . sprintf("%.2f",$nagios_value[$count]) . $temp_uom . ", "; + } + elsif ($cmd_flags{do_humid}){ + + # Set up the thresholds we are interested in + $np_threshold = $np->set_thresholds( + warning => $cmd_flags{warn_level} , + critical => $cmd_flags{crit_level} ); + + # Define the performance data + $np->add_perfdata( + label => "Humidity" . sprintf("%d",$count + 1), + value => $nagios_value[$count], + threshold => $np_threshold, + uom => "%" + ); + + # Update $message + $message .= "Humidity" . sprintf("%d @ ", $count + 1) . sprintf("%.2f",$nagios_value[$count]) . "%, "; + } + elsif ($cmd_flags{do_power}){ + + # Set up the thresholds we are interested in + $np_threshold = $np->set_thresholds( + warning => $cmd_flags{warn_level} , + critical => $cmd_flags{crit_level} ); + + # Define the performance data + $np->add_perfdata( + label => "Input" . sprintf("%d",$count + 1), + value => $nagios_value[$count], + threshold => $np_threshold, + uom => "A" + ); + + # Update $message + $message .= "Input" . sprintf("%d @ ", $count + 1) . sprintf("%.2f",$nagios_value[$count]) . "A, "; + } + } + + # Remove trailing comma from $message + $message =~ s/\,+\s+$//g; + + # Process and exit + $np->nagios_exit( + return_code => $np->check_threshold(check => \@nagios_value), message => $message + ); + +} + +sub get_data { + + # Passing multiple arrays into subroutine + my %cmd_flags = %{$_[0]}; + my %snmp_vars = %{$_[1]}; + my %oids = %{$_[2]}; + + # Initialize variables + my %walk_results = (); + my $walk_pointer = undef; + my $session = undef; + my $oid_to_walk = ""; # Used for getting individual sensor statuses + my $session; + my $error; + + + # Poll specific OID for a value + if($cmd_flags{do_temp}){ + $oid_to_walk = $oids{temp_value}; + } + elsif ($cmd_flags{do_humid}){ + $oid_to_walk = $oids{humid_value}; + } + elsif ($cmd_flags{do_power}){ + $oid_to_walk = $oids{power_value}; + } + + ################################################################ + + # Do SNMP bulk query and put results in %walk_results array + # after running the analyse_walk routine + + # Get SNMP Session pointer + $session = &get_snmp_session_blocking(\%snmp_vars); + + # Define what to do when the query is done + my $result = $session->get_bulk_request( + -varbindlist => [ $oid_to_walk ], + -callback => [ \&analyse_walk, \%walk_results, $oid_to_walk ], + -maxrepetitions => 10, + ); + + # If we get no result then exit and DIE! + if (!defined $result) { + &nagios_exit($session->error(),"UNKNOWN"); + } + + # Now initiate the SNMP message exchange. + snmp_dispatcher(); + $session->close(); + + ################################################################ + + # Go through the results in sorted order and adjust values + foreach my $key (sort keys(%walk_results)){ + + # Temperatures are recorded in tenths of a degree + if($cmd_flags{do_temp}){ + $walk_results{$key} = $walk_results{$key}/10; + } + # Current is recorded in hundredths of an amp + elsif($cmd_flags{do_power}){ + $walk_results{$key} = $walk_results{$key}/100; + } + } + + # Return all the results + return(\%walk_results); +} + + +sub analyse_walk{ + + # Purpose: Analyses the results of the walk + + my ($session, $table, $oid_to_walk) = @_; + + # Define variables used in this routine + my $next = undef; + + # Define a pointer to the get hash reference for the VarBindList values (snmpget results) + my $list = $session->var_bind_list(); + + # If there is an error say so! Then DIE! + if (!defined $session) { + &nagios_exit($session->error(),"UNKNOWN"); + } + + # Get the array of the ObjectNames (OIDs) in the VarBindList + my @names = $session->var_bind_names(); + + # Loop through each of the OIDs in the response and assign + # the key/value pairs to the reference that was passed with + # the callback. Make sure that we are still in the table + # before assigning the key/values. + + foreach $next (@names) { + if (!is_child_oid($oid_to_walk, $next)) { + return; # Table is done. + } + $table->{$next} = $list->{$next}; + } + + # Table is not done, send another request, starting at the last + # OBJECT IDENTIFIER in the response. No need to include the + # calback argument, the same callback that was specified for the + # original request will be used. + + my $result = $session->get_bulk_request( + -varbindlist => [ $next ], + -maxrepetitions => 10, + ); + + + # If we get no result then exit and DIE! + if (!defined $result) { + &nagios_exit($session->error(),"UNKNOWN"); + } + + return; +} + +sub is_child_oid{ + + my ($oid_tree,$oid_child) = @_; + + my $count = 0; + my $return_ok = 1; + + my @tree_array = split('\.',$oid_tree); + my @child_array = split('\.',$oid_child); + + # Compare $oid_tree and $oid_child. + # If any octet in $oid_tree doesn't match the same octet in $oid_child then exit with "0" (Fail) + + foreach my $temp (@tree_array){ + if ($tree_array[$count] != $child_array[$count]){$return_ok = 0; last;} + $count +=1; + } + + return ($return_ok); +} + +sub get_snmp_session_blocking { + + # Passing multiple arrays into subroutine + my %snmp_vars = %{$_[0]}; + + # Define the SNMP session variable + my $session; + my $error; + + # + # Check for missing options + # + + # Check missing host name + if (!$snmp_vars{hostname}){ + &nagios_exit("Missing host address!","UNKNOWN"); + } + + # Make some variables lower case + if ($snmp_vars{privprotocol}){$snmp_vars{privprotocol} = lc($snmp_vars{privprotocol});} + if ($snmp_vars{authprotocol}){$snmp_vars{authprotocol} = lc($snmp_vars{authprotocol});} + + # Check SNMP version compatibility (Versions 1 & 2) + if ( $snmp_vars{version} =~ /[12]/ ) { + ( $session, $error ) = Net::SNMP->session( + -hostname => $snmp_vars{hostname}, + -community => $snmp_vars{community}, + -port => $snmp_vars{port}, + -nonblocking => 1, + -translate => [-octetstring => 0], + -version => $snmp_vars{version} + ); + + } # / SNMP version 1 or 2 + + # Check SNMP version compatibility (version 3) + elsif ( $snmp_vars{version} =~ /3/ ) { + + # AuthPriv mode + if($snmp_vars{privpassword}){ + + ($session, $error) = Net::SNMP->session( + -username => $snmp_vars{username}, + -authpassword => $snmp_vars{authpassword}, + -authprotocol => $snmp_vars{authprotocol}, + -privpassword => $snmp_vars{privpassword}, + -privprotocol => $snmp_vars{privprotocol}, + -hostname => $snmp_vars{hostname}, + -port => $snmp_vars{port}, + -nonblocking => 1, + -translate => [-octetstring => 0], + -version => $snmp_vars{version} + ); + + } # /AuthPriv mode + + # AuthNoPriv options + else{ + + # AuthNoPriv mode + if($snmp_vars{authprotocol}){ + + ($session, $error) = Net::SNMP->session( + -username => $snmp_vars{username}, + -authpassword => $snmp_vars{authpassword}, + -authprotocol => $snmp_vars{authprotocol}, + -hostname => $snmp_vars{hostname}, + -port => $snmp_vars{port}, + -nonblocking => 1, + -translate => [-octetstring => 0], + -version => $snmp_vars{version} + ); + + } # /AuthNoPriv mode + + + # noAuthNoPriv mode + else{ + + ($session, $error) = Net::SNMP->session( + -username => $snmp_vars{username}, + -authpassword => $snmp_vars{authpassword}, + -hostname => $snmp_vars{hostname}, + -port => $snmp_vars{port}, + -nonblocking => 1, + -translate => [-octetstring => 0], + -version => $snmp_vars{version} + ); + + } # /noAuthNoPriv mode + + } # /AuthNoPriv options + + } # /SNMP version 3 + + # Some other version of SNMP + else { + &nagios_exit("Unknown SNMP v" . $snmp_vars{version},"UNKNOWN"); + }; + + # Things failed, so DIE! + if ( !defined($session) ) { + &nagios_exit($error,"UNKNOWN"); + }; + + # Return the session pointer + return($session); +} + + +sub nagios_exit { + + my ($message, $status) = @_; + + $status = uc($status); + $message = $status . ": " . $message; + + if ($status eq "UNKNOWN"){ + my $np = Nagios::Plugin->new(shortname => "UNKNOWN"); + $np->nagios_exit(UNKNOWN, $message); + } + elsif ($status eq "WARNING"){ + my $np = Nagios::Plugin->new(shortname => "WARNING"); + $np->nagios_exit( WARNING, $message ) + } + elsif ($status eq "CRITICAL"){ + my $np = Nagios::Plugin->new(shortname => "CRITICAL"); + $np->nagios_exit( CRITICAL, $message ) + } +} + +sub usage { + +print STDERR << "EOF"; + + This program is a Nagios check the monitors servertech devices + using the Sentry3.mib MIB + + It checks the following: + 1) Environmental temperature (Auto-detects all sensors) + 2) Environmental humidity (Auto-detects all sensors) + 3) Input power (Auto-detects all input feeds) + + Prerequisite Perl modules: + + Net::SNMP + Nagios::Plugin + + Though Net::SNMP may be installable using package systems such as yum or apt, + Nagios::Plugin may have to be done by hand like this: + + # perl -MCPAN -e 'install Nagios::Plugin' + # perl -MCPAN -e 'install Net::SNMP' + + + + + + usage: $0 [--help] + + -h, --help + This help message + + -m, --morehelp + Detailed help on how to edit Nagios / Icinga configuration files to get this + check working for you + + -H, --hostname STRING or IPADDRESS + Host to query via SNMP + + -C, --community STRING + SNMP Community (Default = "public") + + -v, --version INTEGER + SNMP version (Default = 2) + + -p, --port INTEGER + SNMP UDP port (Default = 161) + + -s, --username + Set the securityName used for authenticated SNMPv3 communication. + + -T, --authpassword + Set the SNMPv3 authentication pass phrase used for authenticated SNMPv3 communication. + + -t, --authprotocol + Set the authentication protocol (MD5 or SHA) used for authenticated SNMPv3 + communication. + + -X, --privpassword + Set the privacy pass phrase used for encrypted SNMPv3 communication. + + -x, --privprotocol + Set the privacy protocol (DES or AES) used for encrypted SNMPv3 communication. + + -e, --humidity + Used if you are tracking humidity + + -f, --power + Used if you are tracking power + + -d, --temperature + Used if you are tracking temperature + + -B, --fahrenheit + Used with --temperature + + -b, --celcius + Used with --temperature + + -c, --critical-level STRING + Critical level to use + + -w, --warning-level STRING + Warning level to use + +EOF + + exit(); + +} + +sub moreusage { + +print STDERR << "EOF"; + + # Without PNP4Nagios ######################################################################## + Sample SNMPv2 commands + to add to your Nagios / Icinga command file + ############################################################################################# + + define command{ + command_name check_sentry3_amps + command_line \$USER1\$/check_sentry3 --hostname \$HOSTADDRESS\$ --power --community \$ARG1\$ --warning \$ARG2\$ --critical \$ARG3\$ + } + + define command{ + command_name check_sentry3_temp + command_line \$USER1\$/check_sentry3 --hostname \$HOSTADDRESS\$ --temp --community \$ARG1\$ --warning \$ARG2\$ --critical \$ARG3\$ \$ARG4\$ + } + + define command{ + command_name check_sentry3_humid + command_line \$USER1\$/check_sentry3 --hostname \$HOSTADDRESS\$ --humid --community \$ARG1\$ --warning \$ARG2\$ --critical \$ARG3\$ + } + + # Without PNP4Nagios ######################################################################## + Sample SNMPv2 checks + to add to the Nagios / Icinga file where your checks are located + + Note: Servertechs often have multiple sensors of the same type. With this check Nagios / + Icinga will alarm when any of the temperature, power or humidity thresholds is exceeded on + any of the specified type of sensor. This check automatically detects the number of sensors. + ############################################################################################# + + # Servertech (AMPS) + define service{ + use local-service ; Name of service template to use + host_name servertech-cdu + service_description AMPS + check_command check_sentry3_amps!public!16!18 + } + + # Servertech (HUMIDITY) + define service{ + use local-service ; Name of service template to use + host_name servertech-cdu + service_description HUMIDITY + check_command check_sentry3_humid!public!10:!75 + } + + # Servertech (TEMPERATURE) + define service{ + use local-service ; Name of service template to use + host_name servertech-cdu + service_description TEMPERATURE + check_command check_sentry3_temp!public!35:!85!--fahrenheit + } + + # With PNP4Nagios ########################################################################### + Sample SNMPv2 commands + to add to your Nagios / Icinga command file + ############################################################################################# + + define command{ + command_name check_sentry3_amps + command_line \$USER1\$/check_sentry3 --hostname \$HOSTADDRESS\$ --power --community \$ARG2\$ --warning \$ARG3\$ --critical \$ARG4\$ + } + + define command{ + command_name check_sentry3_temp + command_line \$USER1\$/check_sentry3 --hostname \$HOSTADDRESS\$ --temp --community \$ARG2\$ --warning \$ARG3\$ --critical \$ARG4\$ \$ARG5\$ + } + + define command{ + command_name check_sentry3_humid + command_line \$USER1\$/check_sentry3 --hostname \$HOSTADDRESS\$ --humid --community \$ARG2\$ --warning \$ARG3\$ --critical \$ARG4\$ + } + + # With PNP4Nagios ########################################################################### + Sample SNMPv2 checks + to add to the Nagios / Icinga file where your checks are located + ############################################################################################# + + Note: + Servertechs often have multiple sensors of the same type. With this check Nagios / + Icinga will alarm when any of the temperature, power or humidity thresholds is exceeded on + any of the specified type of sensor. This check automatically detects the number of sensors. + + Note: + You will have to create separate configuration files in the PNP4Nagios "etc/check_commands" + directory. Use the sample files that exist there as a guide. Create these configuration files: + + 1) check_sentry3_amps.cfg + 2) check_sentry3_humid.cfg + 3) check_sentry3_temp.cfg + + Make sure the following directives are applied in each file + + CUSTOM_TEMPLATE = 1 + DATATYPE = GAUGE + RRD_STORAGE_TYPE = SINGLE + Note: + PNP4Nagios chart template file gauge_single_rrd_one_chart_per_rra.php must be placed in + your "pnp4nagios/share/templates/" directory + + Note: + If your charts are not displayed it could be due to the fact that PNP4Nagios did not + create a correctly configured .rrd and .xml file (AMPS, HUMIDITY,TEMPERATURE) in the + "pnp4nagios/var/perfdata/\$HOSTNAME\$/ directory because you restarted Nagios / Icinga + before you created the .cfg files above. The .rrd and .xml file for your check may have + to be deleted so that PNP4Nagios can recreate it automatically. + + ############################################################################################# + + # Servertech test (AMPS) + define service{ + use local-service,srv-pnp ; Name of service template to use + host_name servertech-cdu + service_description AMPS + check_command check_sentry3_amps!default_single_rra_per_chart!public!16!18 + } + + # Servertech test (HUMIDITY) + define service{ + use local-service,srv-pnp ; Name of service template to use + host_name servertech-cdu + service_description HUMIDITY + check_command check_sentry3_humid!gauge_single_rrd_one_chart_per_rra!public!10:!75 + } + + # Servertech test (TEMPERATURE) + define service{ + use local-service,srv-pnp ; Name of service template to use + host_name servertech-cdu + service_description TEMPERATURE + check_command check_sentry3_temp!gauge_single_rrd_one_chart_per_rra!public!35:!85!--fahrenheit + } + +EOF + + exit(); + +} diff --git a/check_sentry3-fix_output_with_missing_sensors.patch b/check_sentry3-fix_output_with_missing_sensors.patch new file mode 100644 index 0000000..ecc3f93 --- /dev/null +++ b/check_sentry3-fix_output_with_missing_sensors.patch @@ -0,0 +1,33 @@ +--- check_sentry3.orig 2014-04-25 14:43:32.870837097 +0200 ++++ check_sentry3 2014-04-25 14:44:50.387659839 +0200 +@@ -193,7 +193,20 @@ + $count +=1; + + # Define the values we are going to test against +- $nagios_value[$count] = sprintf("%.2f",$poll_results{$key}); ++ #$nagios_value[$count] = sprintf("%.2f",$poll_results{$key}); ++ # Do this after "$count +=1" so we can correctly index results to exact sensors. ++ # If only humidity sensor "1" and "3" are plugged in don't show result for "2". ++ # e.g "SERVERTECH_HUMIDITY WARNING - Humidity1 @ 39.00%, Humidity3 @ 41.00% ++ # | Humidity1=39.00%;30;85 Humidity3=41.00%;30;85". ++ # This also prevents perf data shifting to a new key if you add a sensor. ++ if ($poll_results{$key} >= 0){ ++ $nagios_value[$count] = sprintf("%.2f",$poll_results{$key}); ++ } else { ++ # Don't add negative numbers to @nagios_value that cause Nagios::Plugin::Range ++ # (via check_threshold) test to fail. ++ # Also don't add empty sensor data to the perf hashes. ++ next; ++ } + + # Process the value + if ($cmd_flags{do_temp}){ +@@ -255,6 +268,8 @@ + } + } + ++ # remove undefs now that $message has sensor postions set by $nagios_value[$count] ++ @nagios_value = grep defined, @nagios_value; + # Remove trailing comma from $message + $message =~ s/\,+\s+$//g; + diff --git a/gauge_single_rrd_one_chart_per_rra.php b/gauge_single_rrd_one_chart_per_rra.php new file mode 100644 index 0000000..93a1d8a --- /dev/null +++ b/gauge_single_rrd_one_chart_per_rra.php @@ -0,0 +1,103 @@ + diff --git a/nagios-plugins-sentry3.changes b/nagios-plugins-sentry3.changes new file mode 100644 index 0000000..182babe --- /dev/null +++ b/nagios-plugins-sentry3.changes @@ -0,0 +1,6 @@ +------------------------------------------------------------------- +Fri Apr 25 12:48:52 UTC 2014 - lars@linux-schulserver.de + +- initial version (using 2012 as version number, as this is the + only number I found in the source: the year) + diff --git a/nagios-plugins-sentry3.spec b/nagios-plugins-sentry3.spec new file mode 100644 index 0000000..1ca1cee --- /dev/null +++ b/nagios-plugins-sentry3.spec @@ -0,0 +1,68 @@ +# +# spec file for package nagios-plugins-sentry3 +# +# Copyright (c) 2014 SUSE LINUX Products GmbH, Nuernberg, Germany. +# +# All modifications and additions to the file contributed by third parties +# remain the property of their copyright owners, unless otherwise agreed +# upon. The license for this file, and modifications and additions to the +# file, is the same license as for the pristine package itself (unless the +# license for the pristine package is not an Open Source License, in which +# case the license is the MIT License). An "Open Source License" is a +# license that conforms to the Open Source Definition (Version 1.9) +# published by the Open Source Initiative. + +# Please submit bugfixes or comments via http://bugs.opensuse.org/ +# + +Name: nagios-plugins-sentry3 +Version: 2012 +Release: 0 +License: GPL-2.0+ +Summary: Monitor Servertech devices that use the Sentry3 MIB +Url: http://www.linuxhomenetworking.com/ +Group: System/Monitoring +Requires: perl(Nagios::Plugin) >= 0.36 +Requires: perl(Net::SNMP) +Source0: check_sentry3 +Source1: gauge_single_rrd_one_chart_per_rra.php +Source2: LICENSE +Patch0: check_sentry3-fix_output_with_missing_sensors.patch +BuildArch: noarch +BuildRequires: nagios-rpm-macros +BuildRoot: %{_tmppath}/%{name}-%{version}-build + +%description +This Nagios check monitors Servertech devices that use the Sentry3 MIB. + +It checks the following: + +1) Environmental temperature (Auto-detects all sensors) +2) Environmental humidity (Auto-detects all sensors) +3) Input power (Auto-detects all input feeds) + + +%prep +%setup -q -T -c %{name} +install -m755 %{SOURCE0} . +%patch0 -p0 +install -m644 %{SOURCE2} . + +%build +# +%install +install -Dm755 check_sentry3 %{buildroot}/%{nagios_plugindir}/check_sentry3 +install -Dm644 %{SOURCE1} %{buildroot}/%{pnp4nagios_templatedir}/gauge_single_rrd_one_chart_per_rra.php + +%files +%defattr(-,root,root) +%doc LICENSE +# avoid build dependecy of nagios - own the dirs +%dir %{nagios_libdir} +%dir %{nagios_plugindir} +%dir %{pnp4nagios_datadir} +%dir %{pnp4nagios_templatedir} +%{nagios_plugindir}/check_sentry3 +%{pnp4nagios_templatedir}/gauge_single_rrd_one_chart_per_rra.php + +%changelog