Return to README CVS log

Up to [local] / nagios / check_hw_sensors

Annotation of nagios/check_hw_sensors/README, Revision 1.4

1.1       andrew      1: check_hw_sensors plugin for Nagios monitors sysctl hw.sensors on OpenBSD
1.4     ! andrew      2:     check_hw_sensors [-i] (-f [<FILENAME>]|(-s <hw.sensors id> [-w limit] [-c limit]))
1.1       andrew      3:
                      4: Usage:
1.4     ! andrew      5:     -i, --ignore-status
        !             6:         Don't check the status of sensors that report it.
1.1       andrew      7:     -f, --filename=FILE
                      8:         FILE to load checks from (defaults to /etc/sensorsd.conf)
                      9:     -s, --sensor=ID
                     10:         ID of a single sensor.  "-s 0" means hw.sensors.0.
                     11:     -w, --warning=RANGE or single ENTRY
                     12:         Exit with WARNING status if outside of RANGE or if != ENTRY
1.2       andrew     13:     -c, --critical=RANGE or single ENTRY
1.1       andrew     14:         Exit with CRITICAL status if outside of RANGE or if != ENTRY
                     15:
1.2       andrew     16: FILE is in the same format as sensorsd.conf(5) plus some additional
                     17: entries.  These additional entries in the file are ignored by
                     18: sensorsd(8).
1.1       andrew     19:
                     20: check_hw_sensors understands the following entries:
                     21:
1.4     ! andrew     22:     low, high, crit, warn, crit.low, crit.high, warn.low, warn.high,
        !            23:     ignore, status
1.1       andrew     24:
                     25: An ENTRY depends on the type.  The descriptions in sensorsd.conf(5)
                     26: can be used when appropriate, or you can use the following:
                     27:
                     28:     volts_dc, fanrpm or raw - Anything that includes digits.
                     29:     Both the value of the check and the value of the sensor
                     30:     response that are not either a digit or period are stripped
                     31:     and then the two resultant values are compared.
                     32:
                     33:     temp - Can be as above, but if the entry has an F in it,
                     34:     it compares farenheit, otherwise it uses celcius.
                     35:
                     36:     indicator or drive - does a case sensitive match of each
                     37:     entry in the comma separated list and if it does not match
                     38:     any of the entries, it matches the status.
                     39:
                     40: The entries 'crit' or 'warn' (or the -c or -w on the command line)
                     41: may be a RANGE or a comma separated list of acceptable values.
                     42: The comma separated list of values contains a list of things that
                     43: will NOT cause the status.  This is possibly counterintuitive, but
                     44: you are more likely to know good values than bad values.
                     45:
                     46: A RANGE is a low ENTRY and a high ENTRY separated by a colon (:).
                     47: It can also be low: or :high with the other side left blank to only
                     48: make the single check..
                     49:
1.4     ! andrew     50: An entry marked "ignore" will cause that sensor to be skipped.
        !            51: Generally used with status checking of all sensors to ignore sensors you
        !            52: don't care about or that report incorrectly.
        !            53:
        !            54: If you are using --ignore-status, you can still check the status of
        !            55: individual sensors with a status entry.
        !            56:
        !            57: check_hw_sensors (nagios-plugins 1.4.2) 1.17
1.1       andrew     58: The nagios plugins come with ABSOLUTELY NO WARRANTY. You may redistribute
                     59: copies of the plugins under the terms of the GNU General Public License.
                     60: For more information about these matters, see the file named COPYING.
1.4     ! andrew     61:
        !            62: $RedRiver$