check_nut_plus

DESCRIPTION

This manual page documents the check_nut_plus command.

check_nut_plus is a program to generate an nrpe(8) suitable output of upsc(8), in short a nagios plugin for uninterruptable power supplies (UPS).

FEATURES

• Watch and evaluate every value upsc(8) can report.

• The kind of comparison can be specified by OPERATOR.

• Multiple and combined comparison can be specified.

OPTIONS

CHECK DESCIPTION

• check_nut-plus -d DEVICE -v CHECK_DESC [ -v CHECK_DESC ... ]

• DEVICE : a device description upsc(8) would accept.

• CHECK_DESC := UPSCKEY '=' SEVERITY OPERATOR VALUE [ ':' SEVERITY OPERATOR VALUE ] ...

• UPSCKEY : key string as listed by upsc(8), see 'man upsc'

• SEVERITY := { 'w' | 'c' }

  • 'w': warning

  • 'c': critical errors

• OPERATOR := { '>=' | '>' | '<' | '<=' | '==' | '=' | '<>' | '!=' | '~' | '!~' }

  • '>=': numerical comparison, reported value is greater or equal than VALUE

  • '>' : numerical comparison, reported value is greater than VALUE

  • '<=': numerical comparison, reported value is less or equal than VALUE

  • '<' : numerical comparison, reported value is less than VALUE

  • '=' : numerical comparison, reported value is equal to VALUE

  • '<>': numerical comparison, reported value is not equal to VALUE

  • '==': string comparison, reported value is identical to VALUE

  • '!=': string comparison, reported value is not identical to VALUE

  • '~' : regex match, reported value matches the perl regular expression given by VALUE

  • '!~': regex match, reported value does not match the perl regular expression given by VALUE

    For perl regular expressions see 'man perlre'.

ENVIRONMENT

None

Examples

• Example 1. classic

  command[check_ups_load]=/usr/lib/nagios/plugins/check_nut_plus \
   -d ups17@localhost  -v "ups.load=w>90:c>=98"
  		  

  raise warning if the value reported by "ups.load" is greater than "90" and raise critical error if it is "greater or equal than "98"

• Example 2. observe a fixed value

  command[check_ups_Ubat]=/usr/lib/nagios/plugins/check_nut_plus \
   -d ups@localhost  -v "battery.voltage=c!=27.0"
            

  raise critical error if the value reported by "battery.voltage" it not equal to 27.0

• Example 3. observe multiple fixed strings

  command[check_ups_model]=/usr/lib/nagios/plugins/check_nut_plus \
   -d myups  -v "device.mfr=c!=MGE UPS SYSTEMS" -v "device.model=c!=Evolution 1150" \
   -v "device.serial=w!=AV4H4301K"
            

  raise critical error if "device.mfr" or "device.model" are not the specified ones. raise warning if "device.serial" has changed so you can see if someone has been tinkering ;-)

• Example 4. window discrimitation

  command[check_ups_Uin]=/usr/lib/nagios/plugins/check_nut_plus \
   -d otherups@somehost  -v "input.voltage=w>=238:c>=240:w<=225:c<=220"
            

  critical error on input.voltage >=240 or c<=220 no error on input.voltage < 238 and > 220 warning otherwise

FILES

debian/changelog Debian changelog file.

SEE ALSO

perlre(1), upsc(8), http://www.networkupstools.org/, nrpe(8)

BUGS

Sure...

AUTHOR

This manual page was written by LiHAS <support@lihas.de> for the check_nut_plus software and may be used by others. It has been loosely derived from check_ups by Luca Bertoncello <lucabert@lucabert.de>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts.

DISTRIBUTION

The newest version of check_nut_plus can be obtained from http://ftp.lihas.de/debian

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; Version 2. This guarantees your right to use, modify, and redistribute check_nut_plus under certain conditions.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details (it is in the COPYING file of the check_nut_plus distribution).