Skip to main content

Check supervisord programs status Nagios plugin

Project description

GitHub Coveralls License Version Supported Python version Package format Python wheel support Package status

nagios-check-supervisord is a Nagios-plugin that check supervisord (http://supervisord.org/) programs status

Installation

  • Obtain your copy of source code from the git repository: $ git clone https://github.com/vint21h/nagios-check-supervisord.git. Or download the latest release from https://github.com/vint21h/nagios-check-supervisord/tags/.
  • Run $ python ./setup.py install from the repository source tree or unpacked archive. Or use pip: $ pip install nagios-check-supervisord.

Configuration

  • Read and understand Nagios documentation.
  • Create Nagios command and service definitions like this:
# "check_supervisord" command
define command
{
    command_name check_supervisord
    command_line $USER1$/check_supervisord -s $ARG1$ -p $ARG2$ -P $ARG3$ -u $ARG4$ -S $ARG5$
}

# "check_supervisord" service for "myprog" program
define service
{
    use                 local-service
    host_name           localhost
    service_description My program state
    check_command       check_supervisord!127.0.0.1!9001!myprog!username!password
}

Without --programs option script check all programs from supervisord response and return priority-based global status:

  • critical
  • warning
  • unknown
  • ok

Also, --programs option can take a comma-separated list of programs to check.

--stopped-state-exit-code option allows set Nagios status for stopped programs.

--network-errors-exit-code option allows set Nagios status for checks network errors.

--no-programs-defined-exit-code option allows set Nagios status for not configured/found programs in supervisord response.

nagios-check-supervisord support connection to supervisord XML-RPC interface through HTTP and Unix Domain Socket. To install nagios-check-supervisord with Unix Domain Socket: $ pip install nagios-check-supervisord[unix-socket-support]

Licensing

nagios-check-supervisord 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 3 of the License, or (at your option) any later version. For complete license text see COPYING file.

Contacts

Project Website: https://github.com/vint21h/nagios-check-supervisord/

Author: Alexei Andrushievich <vint21h@vint21h.pp.ua>

For other authors list see AUTHORS file.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nagios-check-supervisord, version 2.1.0
Filename, size File type Python version Upload date Hashes
Filename, size nagios_check_supervisord-2.1.0-py2.py3-none-any.whl (34.8 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size nagios-check-supervisord-2.1.0.zip (29.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page