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.

Filename, size & hash SHA256 hash help File type Python version Upload date
nagios_check_supervisord-0.6.1-py2.py3-none-any.whl (34.4 kB) Copy SHA256 hash SHA256 Wheel 2.7
nagios-check-supervisord-0.6.1.tar.gz (18.7 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page