Return to README CVS log

Up to [local] / nagios / check_hw_sensors

Annotation of nagios/check_hw_sensors/README, Revision 1.5

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:
1.5     ! andrew     28:     fanrpm, volts_dc, amps, watthour, amphour, integer (raw), percent,
        !            29:     lux or timedelta - Anything that includes digits.  Both the value of
        !            30:     the check and the value of the sensor response that are not either a
        !            31:     digit or period are stripped and then the two resultant values are
        !            32:     compared.
1.1       andrew     33:
                     34:     temp - Can be as above, but if the entry has an F in it,
                     35:     it compares farenheit, otherwise it uses celcius.
                     36:
                     37:     indicator or drive - does a case sensitive match of each
                     38:     entry in the comma separated list and if it does not match
1.5     ! andrew     39:     any of the entries, it sets the status.
1.1       andrew     40:
                     41: The entries 'crit' or 'warn' (or the -c or -w on the command line)
                     42: may be a RANGE or a comma separated list of acceptable values.
                     43: The comma separated list of values contains a list of things that
                     44: will NOT cause the status.  This is possibly counterintuitive, but
                     45: you are more likely to know good values than bad values.
                     46:
                     47: A RANGE is a low ENTRY and a high ENTRY separated by a colon (:).
                     48: It can also be low: or :high with the other side left blank to only
                     49: make the single check..
                     50:
1.4       andrew     51: An entry marked "ignore" will cause that sensor to be skipped.
1.5     ! andrew     52: Generally used with state checking of all sensors to ignore sensors you
1.4       andrew     53: don't care about or that report incorrectly.
                     54:
                     55: If you are using --ignore-status, you can still check the status of
                     56: individual sensors with a status entry.
                     57:
1.5     ! andrew     58: check_hw_sensors (nagios-plugins 1.4) 1.20
1.1       andrew     59: The nagios plugins come with ABSOLUTELY NO WARRANTY. You may redistribute
                     60: copies of the plugins under the terms of the GNU General Public License.
                     61: For more information about these matters, see the file named COPYING.
1.4       andrew     62:
                     63: $RedRiver$