/ 
Check-supervisorctl-0.2.1
/ Monitoring::Sneck::Checks::supervisorctl

NAME

Monitoring::Sneck::Checks::supervisorctl - checks supervisorctl status, and optionally the configs, through Check::supervisorctl

VERSION

Version 0.2.0

SYNOPSIS

supervisor|perl:supervisorctl
supervisor|perl:supervisorctl -c
supervisor|perl:supervisorctl -c -f /etc/supervisor/conf.d -i foo -d bar -s stopped=1
supervisor|perl:supervisorctl -c -R -l

DESCRIPTION

A Monitoring::Sneck::Checks check, for running Check::supervisorctl in process from sneck, or through sneck_check. It is only of use if Monitoring::Sneck::Checks is installed, which this distribution does not require.

It takes the same options as check_supervisorctl and works out the status the same way, see Check::supervisorctl. 'supervisorctl status' is ran through run_command, so it is stopped if the check times out, as are the commands for -R, -l, and -L. If it can not be ran, or returns anything that is not a item and its status, such as when it can not talk to supervisord, that is UNKNOWN by default, changeable via -s status_error=$value.

The status line has the counts of the items in each status, followed by the same lines check_supervisorctl prints. Perfdata is the count for each status, the count of ignored items, and if -c is given, the counts of configs not running and running items missing a config. With -R, the counts of items restarted and failed to restart are added, and with -l or -L, the counts of configs added and failed to add.

OPTIONS

- -c :: Check the configs as well.

- -f <config_dir> :: The directory to look for configs under if -c is set. Default :: /usr/local/etc/supervisor/conf.d Default Linux :: /etc/supervisor/conf.d

- -d <ignore_config> :: A config to ignore. May be given more than once.

- -i <ignore> :: A item from status to ignore. May be given more than once.

- -s <status=value> :: Maps a status to a exit value. May be given more than once. See check_supervisorctl for what may be mapped.

- -R :: Restart items that are stopped, exited, fatal, or backoff. See check_supervisorctl.

- -l :: Add configs that are not running, the same as -L, for use with -R. Requires -R and -c.

- -L :: Add configs that are not running via reread and add. Requires -c.

- -p <supervisorctl> :: The supervisorctl to run. Default :: supervisorctl

METHODS

check

Does the check.

AUTHOR

Zane C. Bowers-Hadley, <vvelox at vvelox.net>

LICENSE AND COPYRIGHT

This software is Copyright (c) 2026 by Zane C. Bowers-Hadley.

This is free software, licensed under:

The GNU General Public License, Version 3, June 2007