check_hwgroup

                                        
Check hwgroup environmental devices

                    

        
        

            
            

                

    

    
check_hwgroup.py


Checks the hwgroup environmental devices.


The old perl implementation kept for historical reasons.


Installation


Installation is just simple. You need Python 2.7 to run this.


nagiosplugin Module


You need the Python nagiosplugin package. More information can be found on



Extract the package, go into the directory and type


$ wget https://pypi.python.org/packages/source/n/nagiosplugin/nagiosplugin-1.2.1.tar.gz#md5=d81c724525e8e8b290d17046109e71d2
$ cd nagiosplugin-1.2.1
# python setup.py install


check_hwgroup


Move the check_hwgroup.py script to your favorite ICINGA resource directory, e.g.


# cp check_hwgroup.py /usr/local/icinga/libexec


Usage


Get help


check_hwgroup.py -h|--help


Get the program version


check_hwgroup.py -V|--version


Options


short | long        | type    | default    | description
------+-------------+---------+------------+----------------------------------
-v    | --verbose   | N/A     | N/A        | be verbose (specify up to 3 times
      |             |         |            | to increase verbosity level)
-H    | --host      | string  | (required) | the hostname or ipaddress
      |             |         |            | of the hwgroup device
-C    | --community | string  | public     | the SNMP community
      |             |         |            | of the hwgroup device
-P    | --port      | integer | 161        | the port
      |             |         |            | of the hwgroup device
-w    | --warning   | float   | (required) | warning threshold
-c    | --critical  | float   | (required) | critical threshold
-S    | --sensor    | integer | (none)     | the sensor to check
-I    | --contact   | integer | (none)     | the dry contact to check
-O    | --output    | integer | (none)     | the relay output to check


Exactly one of -S, -I, -O must be given.


Supported devices



Examples


    

  • host:      192.168.144.120
    • 

  • port:      161
    • 

  • community: public
    • 



Fetch a sensor value and check whether it's OK, WARNING or CRITICAL


$ ./check_hwgroup.py -H 192.168.144.120 -S 17946 -w 30 -c 35
POSEIDON 2250 SNMP SUPERVISOR V1.0.13 OK - Sensor 240 is 25.8 | 'Sensor 240'=25.8;30.0;35.0
$ echo $?
0

$ ./check_hwgroup.py -H 192.168.144.120 -S 17946 -w 25.7 -c 35
POSEIDON 2250 SNMP SUPERVISOR V1.0.13 WARNING - Sensor 240 is 25.8 (outside range 0:25.7) | 'Sensor 240'=25.8;25.7;35.0
$ echo $?
1

$ ./check_hwgroup.py -H 192.168.144.120 -S 17946 -w 25.7 -c 25.7
POSEIDON 2250 SNMP SUPERVISOR V1.0.13 CRITICAL - Sensor 240 is 25.8 (outside range 0:25.7) | 'Sensor 240'=25.8;25.7;25.7
$ echo $?
2


Frequently occurred user errors


Wrong host/port/community


$ ./check_hwgroup.py -H 192.168.144.121 -S 17946 -w 30 -c 35 -P 162 -C apple
ERROR: SNMP error: No SNMP response received before timeout
$ echo $?
3


Wrong sensor


$ ./check_hwgroup.py -H 192.168.144.120 -S 17947 -w 30 -c 35
ERROR: Sensor ID (17947) not found
$ echo $?
3


Where to buy


Product can be found here:
NETWAYS Shop


Bugs and repository


For chorus of praise or complaints you can go here:



Native git access: git://git.netways.org/plugins/check_hwgroup.git