Monitoring Plugins standards
Find a file
Aksel Sjögren 39c162e594
Fix check_dhcp tests
* try to use "/usr/sbin/ip" before "ifconfig" since the latter is
  obsolete on Linux to figure out interface to listen for DHCP messages.
  But keeping ifconfig method just in case.
  Without this, tests fail on boxes without ifconfig AND the correct
  interface named ethX.

* amend possible failure responses, as check_dhcp might get a DHCPOFFER,
  but from an unexpected address - which happens if the box running
  tests are on a network with a DHCP server.
2021-04-30 11:14:10 +02:00
.github Attempt to fix check_users 2021-04-30 09:57:02 +02:00
build-aux Update bundled libtool files 2013-09-05 00:03:00 +02:00
config_test Ficing C++ style comments 2007-03-08 06:12:36 +00:00
doc Prepare the release docu for 2024 when we release 2.4 2020-12-09 22:54:38 +01:00
gl [check_disk] add support to display inodes usage in perfdata 2018-12-08 22:44:42 +01:00
lib Merge pull request #1567 from vdanjean/master 2019-02-19 21:49:13 +01:00
m4 Merge branch 'master' into feature_check_curl 2019-09-07 11:27:19 +02:00
perlmods update perl module to 0.39 2015-04-11 13:08:45 +02:00
pkg Capitalize "Monitoring Plugins" 2014-01-21 16:19:20 +01:00
plugins Fix conditional tests for check_http, check_curl 2021-04-30 11:13:59 +02:00
plugins-root Fix check_dhcp tests 2021-04-30 11:14:10 +02:00
plugins-scripts check_mailq: restore accidentially removed options 2020-12-08 16:24:10 +01:00
po small fix and we see CURLOPT_SSL_CTX_FUNCTION does not work on Centos 6? 2018-10-22 16:30:31 +02:00
tap Clean up last commit - remove the __STDC_VERSION__ check in tap.h 2009-01-15 01:03:00 -05:00
tools test: Add proxy tests via proxy 2018-11-06 12:33:24 +01:00
.gitignore cleanup gitignore 2018-10-24 09:59:59 +02:00
ABOUT-NLS Updating gettext files from coreutils-6.9. mkinstalldirs needs to be in 2007-05-12 00:49:26 +00:00
acinclude.m4 Removing CVS/SVN tags and replacing with git-based versioning 2008-11-23 05:38:47 +00:00
ACKNOWLEDGEMENTS removed embedded uriparser library, added --with-uriparser configure option 2018-10-22 16:30:31 +02:00
AUTHORS Update AUTHORS 2016-03-24 07:31:19 +01:00
autogen.sh Removing CVS/SVN tags and replacing with git-based versioning 2008-11-23 05:38:47 +00:00
CODING Project rename initial commit. 2014-01-19 14:18:47 -05:00
config.rpath make dist failing without config.rpath in top level. File copied 2007-01-30 09:56:47 +00:00
configure.ac New version number for git 2020-12-09 22:48:44 +01:00
COPYING Update the COPYING file to the GPLv3 2010-07-27 23:06:23 +02:00
FAQ FAQ: Remove outdated (RPM/DEB-related) questions 2014-10-15 13:56:13 +02:00
Makefile.am tests: enable plugins-root tests 2018-12-04 09:48:45 +01:00
mkinstalldirs Adding more required files from gettext 2006-05-19 21:30:59 +00:00
NEWS New version in NEWS 2020-12-09 22:52:08 +01:00
NP-VERSION-GEN New version number for git 2020-12-09 22:48:44 +01:00
NPTest.pm tests: rework test parameters 2018-12-04 15:20:19 +01:00
opttest.pl Initial revision 2002-02-28 06:42:51 +00:00
README Update README 2020-10-02 01:48:46 +05:30
README.md Add symlink: README.md -> README 2013-09-20 17:00:40 +02:00
REQUIREMENTS fixed whitespaces in REQUIREMENTS for check_curl to fit the rest of the requrirements 2019-09-07 14:21:14 +02:00
ROADMAP some minor fixes 2004-12-03 17:48:53 +00:00
SUPPORT Project rename initial commit. 2014-01-19 14:18:47 -05:00
test.pl.in Use "C" locale when running test suite 2014-07-21 22:20:57 +02:00
THANKS.in Updating contributors 2020-12-09 22:09:38 +01:00

Monitoring Plugins

  • For instructions on installing these plugins for use with your monitoring system, see below. In addition, generic instructions for the GNU toolchain can be found in the INSTALL file.

  • For major changes between releases, read the NEWS file.

  • For information on detailed changes that have been made or plugins that have been added, read the ChangeLog file.

  • Some plugins require that you have additional programs or libraries installed on your system before they can be used. Plugins that are dependent on other programs/libraries that are missing are usually not compiled. Read the REQUIREMENTS file for more information.

  • Individual plugins are self-documenting. All plugins that comply with the basic guidelines for development will provide detailed help when invoked with the -h or --help options.

You can check the latest plugins at:

Send an email to help@monitoring-plugins.org for assistance. Please include the OS type and version that you are using. Also, run the plugin with the -vvv option and provide the resulting version information. Of course, there may be additional diagnostic information required as well. Use good judgment.

Send an email to devel@monitoring-plugins.org for developer discussions.

For patch submissions and bug reports, please use the appropriate resources at:

Installation Instructions

  1. If you are using the Git tree, you will need m4, gettext, automake, and autoconf. To start out, run:

    ./tools/setup
    

    For more detail, see the developer guidelines at https://www.monitoring-plugins.org/doc/guidelines.html.

  2. Run the configure script to initialize variables and create a Makefile, etc.

    ./configure --prefix=BASEDIRECTORY --with-cgiurl=SOMEURL
    

    Replace BASEDIRECTORY with the path of the directory under which your monitoring system is installed (default is /usr/local), and replace SOMEURL with the path used to access the monitoring system CGIs with a web browser (default is /nagios/cgi-bin).

  3. Compile the plugins with the following command:

    make
    
  4. Install the compiled plugins and plugin scripts with the following command:

    make install
    

    The installation procedure will attempt to place the plugins in a libexec/ subdirectory in the base directory you specified with the --prefix argument to the configure script.

  5. There are some plugins that require setuid. If you run make install as a non-root user, they will not be installed. To install, switch to root and run:

    make install-root
    

That's it! If you have any problems or questions, feel free to send an email to help@monitoring-plugins.org.

License Notice

You can redistribute and/or modify this software under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version; with the additional exemption that compiling, linking, and/or using OpenSSL is allowed.

This software 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 COPYING file for the complete text of the GNU General Public License, version 3.