README.md

   1 Nagios plugin: check_elvis_status
   2 =================================
   3
   4 Check [Elvis DAM](http://www.elvisdam.com/) status via admin /server-status json data.
   5
   6 This plugins allows you monitor number and boolean values from server-status json (specified with `-u` option).
   7 Numbers may be expressed with size qualifiers (TB, GB, MB).
   8
   9 It expression is taken via `-e` option, the warning and critical tresholds are configurable with `-w` and `-c`
  10 options respectively. Additionally `-i` option allows you inverse the comparision logic.
  11
  12 Requires: php 5.2, [php-json](http://php.net/json) (if using php < 5.2, use [json pecl](http://pecl.php.net/package/json))
  13
  14 Examples
  15 ========
  16
  17 Check for API Operations count:
  18
  19     ./check_elvis_status -u elvis.json -e '->securityStatus->apiOperationsToday' -m 'API ops' -w 3000 -c 5000
  20     ELVIS_STATUS: CRITICAL: API ops: 5329
  21
  22     ./check_elvis_status -u elvis.json -e '->securityStatus->apiOperationsToday' -m 'API ops' -w 5000 -c 15000
  23     ELVIS_STATUS: WARNING: API ops: 5329
  24
  25     ./check_elvis_status -u elvis.json -e '->securityStatus->apiOperationsToday' -m 'API ops' -w 6000 -c 15000
  26     ELVIS_STATUS: OK: API ops: 5329
  27
  28
  29 Check processing queue monitoring if >300 warning, if >500 critical
  30
  31      ./check_elvis_status.php -u elvis.json -e '->mediaStatus->waitingProcessingRequests' -m 'waitingProcessingRequests' -w 300 -c 500
  32     ELVIS_STATUS: OK: waitingProcessingRequests: 0
  33
  34 Check if proccessing servers are seen by Elvis:
  35
  36     ./check_elvis_status.php -u elvis.json -e '->mediaStatus->operationalNodes' -m operationalNodes -v -i -c 3
  37     EVAL: return $json->mediaStatus->operationalNodes;
  38     ELVIS_STATUS: OK: operationalNodes: 3
  39
  40 Check if Processing Servers are Connected & status ready.
  41 This one converts boolean value to integer to be able to make comparision :)
  42
  43     ./check_elvis_status.php -u elvis.json -e '->mediaStatus->mediaNodesStatus[0]->ready+0' -m 'ready' -c 1 -i
  44     ELVIS_STATUS: OK: ready: 1
  45     ./check_elvis_status.php -u elvis.json -e '->mediaStatus->mediaNodesStatus[0]->ready+0' -m 'ready' -c 1 -i
  46     ELVIS_STATUS: CRITICAL: ready: 0
  47
  48 If you want the same check to give WARNING instead of CRITICAL, setup warning option instead:
  49
  50     ./check_elvis_status.php -u elvis.json -e '->mediaStatus->mediaNodesStatus[0]->ready+0' -m 'ready' -w 1 -i
  51     ELVIS_STATUS: OK: ready: 1
  52     ./check_elvis_status.php -u elvis.json -e '->mediaStatus->mediaNodesStatus[0]->ready+0' -m 'ready' -w 1 -i
  53     ELVIS_STATUS: WARNING: ready: 0