---
name: "check_gearman"
section: "8"
platform: "linux"
package: "mod-gearman-tools"
version: "1.5.5-1+b8"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/check_gearman"
---

# check\_gearman(8)

Nagios service check to monitor the gearman job server

## NAME

check\_gearman - Nagios 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\>

  \]

### 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. - 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

## SEE ALSO

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