Man page - check_gearman(8)

Packages contas this manual

Manual

CHECK_GEARMAN(8) System Administration Utilities CHECK_GEARMAN(8)

check_gearman - Naemon service check to monitor the gearman job server

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

[ -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

'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

worker=10 jobs=1508c

Note: Job thresholds are per queue not totals.

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

The Mod Gearman documentation is available in /usr/share/doc/mod-gearman/README.html

January 2026 check_gearman 5.2.2