Skip to main content

Check supervisord programs status Nagios plugin

Project description

nagios-check-supervisord is a Nagios-plugin that check supervisord ( programs status


  • Obtain your copy of source code from git repository: git clone Or download latest release from
  • Run python ./ install from repository source tree or unpacked archive under root user. Or use pip: pip install nagios-check-supervisord.


  • 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!!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 comma separated list of programs to check.

--stopped-state option allow set Nagios status for stopped programs.

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

nagios-check-supervisord support connection to supervisord XML-RPC interface through HTTP and Unix Domain Socket.


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.


Project Website:

Author: Alexei Andrushievich <>

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 0.6.1
Filename, size File type Python version Upload date Hashes
Filename, size nagios_check_supervisord-0.6.1-py2.py3-none-any.whl (34.4 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size nagios-check-supervisord-0.6.1.tar.gz (18.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page