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 ( programs status


  • Obtain your copy of source code from the git repository: $ git clone Or download the latest release from
  • Run $ python ./ install from the repository source tree or unpacked archive. 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 a comma-separated list of programs to check.

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

--starting-state-exit-code option allows set Nagios status for starting 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]


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.

Source Distribution (29.3 kB view hashes)

Uploaded source

Built Distribution

Supported by

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