Skip to content

Check ipmi-sensor

Overview

The check calls ipmitool sensor list to fetch detailed sensor information. Running this check just makes sense against or on hardware using an IPMI interface. Needs sudo.

Tested on:

  • Supermicro BMC
  • HPE iLO

Known Issues and Limitations:

  • Discrete sensors support is not implemented.

Fact Sheet

Fact Value
Check Plugin Download https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/ipmi-sensor
Check Interval Recommendation Every 15 minutes
Can be called without parameters Yes
Compiled for Windows No
Requirements command-line tool ipmitool

Help

usage: ipmi-sensor [-h] [-V] [--authtype {NONE,PASSWORD,MD2,MD5,OEM}]
                   [-H HOSTNAME] [--interface {lan,lanplus}]
                   [--password PASSWORD] [--port PORT]
                   [--privlevel {CALLBACK,USER,OPERATOR,ADMINISTRATOR}]
                   [--test TEST] [--username USERNAME]

Checks IPMI sensor information in detail.

options:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  --authtype {NONE,PASSWORD,MD2,MD5,OEM}
                        Specify an authentication type to use during IPMIv1.5
                        lan session activation. Supported types are NONE,
                        PASSWORD, MD2, MD5, or OEM.
  -H, --hostname HOSTNAME
                        Remote server address, can be IP address or hostname.
                        This option is required for lan and lanplus
                        interfaces.
  --interface {lan,lanplus}
                        Selects IPMI interface to use. Supported types are
                        "lan" (= IPMI v1.5) or "lanplus" (= IPMI v2.0).
  --password PASSWORD   Remote server password.
  --port PORT           Remote server UDP port to connect to. Default: 623
  --privlevel {CALLBACK,USER,OPERATOR,ADMINISTRATOR}
                        Force session privilege level. Can be CALLBACK, USER,
                        OPERATOR, ADMINISTRATOR. Default: USER
  --test TEST           For unit tests. Needs "path-to-stdout-file,path-to-
                        stderr-file,expected-retc".
  --username USERNAME   Remote server username, default is NULL user.

Usage Examples

./ipmi-sensor --privlevel USER --interface lanplus --hostname 10.100.184.29 --username 'user' --password 'pa$$word'

Output:

Checked 60 sensors, all are ok.

States

  • CRIT, if sensor value is non-recoverable (very worse).
  • CRIT, if sensor value is above/below critical threshold given by IPMI.
  • WARN, if sensor value is above/below IPMI non-critical threshold.
  • UNKNOWN on ipmitool not found or errors running ipmitool.

Perfdata / Metrics

Depends on your hardware - as an example:

  • 1.05V_PCH
  • 1.2V_BMC
  • 1.5V_PCH
  • 12V
  • 3.3VCC
  • 3.3VSB
  • 5VCC
  • 5VSB
  • CPU_Temp
  • DIMMA1_Temp
  • DIMMA2_Temp
  • DIMMB1_Temp
  • DIMMB2_Temp
  • DIMMC1_Temp
  • DIMMC2_Temp
  • DIMMD1_Temp
  • DIMMD2_Temp
  • FAN1
  • FAN2
  • FAN3
  • FAN4
  • PCH_Temp
  • Peripheral_Temp
  • System_Temp
  • VBAT
  • Vcpu
  • VcpuVRM_Temp
  • VDIMMAB
  • VDIMMCD
  • VmemABVRM_Temp
  • VmemCDVRM_Temp

Credits, License