Man page - check_gearman(8)
Packages contas this manual
apt-get install mod-gearman-tools
Manual
| CHECK_GEARMAN(8) | System Administration Utilities | CHECK_GEARMAN(8) |
NAME
check_gearman - Naemon service check to monitor the gearman job server
DESCRIPTION
usage:
check_gearman [ -H=<hostname>[:port] ]
- [ -t=<timeout>
- ]
- [ -w=<jobs warning level>
- ] default: 10
- [ -c=<jobs critical level>
- ] default: 100
- [ -W=<worker warning level>
- ] default: 25
- [ -C=<worker critical level>
- ] default: 50
- [ -q=<queue>
- ]
- [ -x=<crit on zero worker>
- ] default: 0
to send a test job:
- [ -u=<unique job id>
- ] default: check
- [ -s=<send text>
- ]
- [ -e=<expect text>
- ]
- [ -a
- send async ] will ignore -e
- [ -h
- print help ]
- [ -v
- verbose output ]
- [ -V
- print version ]
- - You may set thresholds to 0 to disable them. - You may use -x to enable critical exit if there is no worker for specified queue. - Thresholds are only for server checks, worker checks are availability only
perfdata format when checking job server:
- 'queue waiting'=current waiting jobs;warn;crit;0 'queue running'=current running jobs 'queue worker'=current num worker;warn;crit;0
Note: set your pnp RRD_STORAGE_TYPE to MULTIPLE to support changeing numbers of queues.
- see http://docs.pnp4nagios.org/de/pnp-0.6/tpl_custom for detailed information
perfdata format when checking mod gearman worker:
- worker=10 jobs=1508c
Note: Job thresholds are per queue not totals.
EXAMPLES
Check job server:
%>./check_gearman -H localhost -q host check_gearman OK - 0 jobs running and 0 jobs waiting. Version: 0.14
Check worker:
%> ./check_gearman -H <job server hostname> -q worker_<worker hostname> -t 10 -s check check_gearman OK - host has 5 worker and is working on 0 jobs %> ./check_gearman -H <job server hostname> -q perfdata -t 10 -x check_gearman CRITICAL - Queue perfdata has 155 jobs without any worker. |'perfdata_waiting'=155;10;100;0 'perfdata_running'=0 'perfdata_worker'=0;25;50;0
Check result worker: %> ./check_gearman -H <job server hostname> -q check_results -t 10 -s check OK - result worker running on host. Sending 14.9 jobs/s (avg duration:0.040ms). Version: 4.0.3|worker=3;;;0;3 avg_submit_duration=0.000040s;;;0;0.000429 jobs=2388c errors=0c
SEE ALSO
The Mod Gearman documentation is available in /usr/share/doc/mod-gearman/README.html
| January 2026 | check_gearman 5.2.2 |