Skip to content

Check redfish-sensor

Overview

Checks the state of the Chassis collection containing resources that represent the physical aspects of the infrastructure. A Chassis is roughly defined as a physical view of a computer system as seen by a human. A single Chassis resource can house sensors, fans, and other components.

Tested on:

  • DELL iDRAC
  • DMTF Simulator

Hints:

  • A check takes up to 10 seconds. Increasing runtime timout to 30 seconds is recommended.
  • This check runs with both http and https. It just uses GET requests.
  • No additional Python Redfish modules need to be installed.

Fact Sheet

Fact Value
Check Plugin Download https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/redfish-sensor
Check Interval Recommendation Every 5 minutes
Can be called without parameters Yes
Compiled for Windows No

Help

usage: redfish-sensor [-h] [-V] [--always-ok] [--insecure] [--no-proxy]
                      [--password PASSWORD] [--timeout TIMEOUT] [--url URL]
                      [--username USERNAME]

Checks the state of the Chassis collection containing resources that represent
the physical aspects of the infrastructure. A Chassis is roughly defined as a
physical view of a computer system as seen by a human. A single Chassis
resource can house sensors, fans, and other components.

options:
  -h, --help           show this help message and exit
  -V, --version        show program's version number and exit
  --always-ok          Always returns OK.
  --insecure           This option explicitly allows to perform "insecure" SSL
                       connections. Default: False
  --no-proxy           Do not use a proxy. Default: False
  --password PASSWORD  Redfish API password.
  --timeout TIMEOUT    Network timeout in seconds. Default: 8 (seconds)
  --url URL            Redfish API URL. Default: https://localhost:5000
  --username USERNAME  Redfish API username.

Usage Examples

./redfish-sensor --url https://bmc --username redfish-monitoring --password 'mypassword'

Output:

Everything is ok, checked sensors on 1 member.

Member: Contoso 3500RX, Power: On, LED: Lit, SKU: 8675309, SerNo: 437XR1138R2, PartNumber: 224071-J23

Sensor                             ! Location    ! Reading ! Unit ! Value ! State 
-----------------------------------+-------------+---------+------+-------+-------
Ambient Temperature                ! Room        ! 22.5    ! Cel  ! [OK]  ! [OK]  
CPU #1 Fan Speed                   ! CPU         ! 80      ! %    ! [OK]  ! [OK]  
CPU #2 Fan Speed                   ! CPU         ! 60      ! %    ! [OK]  ! [OK]  
CPU #1 Temperature                 ! CPU         ! 37      ! Cel  ! [OK]  ! [OK]  
DIMM #1 Temperature                ! Memory      ! 44      ! Cel  ! [OK]  ! [OK]  
DIMM #2 Temperature                ! Memory      ! 44      ! Cel  ! [OK]  ! [OK]  
DIMM #3 Temperature                ! Memory      ! 44      ! Cel  ! [OK]  ! [OK]  
Fan Bay #1 Exhaust Temperature     ! Exhaust     ! 40.5    ! Cel  ! [OK]  ! [OK]  
Chassis Fan #1                     ! Chassis     ! 45      ! %    ! [OK]  ! [OK]  
Chassis Fan #2                     ! Chassis     ! 45      ! %    ! [OK]  ! [OK]  
Front Panel Intake Temperature     ! Intake      ! 24.8    ! Cel  ! [OK]  ! [OK]  
Power Supply #1 Energy             ! PowerSupply ! 7855    ! kW.h ! [OK]  ! [OK]  
Power Supply #1 Frequency          ! PowerSupply ! 60.1    ! Hz   ! [OK]  ! [OK]  
Power Supply #1 Input Current      ! PowerSupply ! 8.92    ! A    ! [OK]  ! [OK]  
Power Supply #1 Input Power        ! PowerSupply ! 374     ! W    ! [OK]  ! [OK]  
Power Supply #1 Input Voltage      ! PowerSupply ! 119.27  ! V    ! [OK]  ! [OK]  
Power Supply #1 12V Output Voltage ! PowerSupply ! 12.08   ! V    ! [OK]  ! [OK]  
Power Supply #1 12V Output Current ! Chassis     ! 2.79    ! A    ! [OK]  ! [OK]  
Power Supply #1 3V Output Voltage  ! PowerSupply ! 3.32    ! V    ! [OK]  ! [OK]  
Power Supply #1 3V Output Current  ! PowerSupply ! 8.92    ! A    ! [OK]  ! [OK]  
Power Supply #1 5V Output Voltage  ! PowerSupply ! 5.04    ! V    ! [OK]  ! [OK]  
Power Supply #1 5V Output Current  ! PowerSupply ! 3.41    ! A    ! [OK]  ! [OK]  
Total Energy                       ! Chassis     ! 325675  ! kW.h ! [OK]  ! [OK]  
Power reading for the Chassis      ! Chassis     ! 374     ! W    ! [OK]  ! [OK]

Redundancy            ! Mode ! State 
----------------------+------+-------
BaseBoard System Fans ! N+m  ! [OK]

States

  • CRIT if an enabled sensor health rollup state is equal to "Critical".
  • CRIT if an enabled sensor health state is equal to "Critical".
  • CRIT if sensor value is above/below critical threshold given by Redfish (Thresholds_UpperCritical and Thresholds_LowerCritical).
  • WARN if an enabled sensor health rollup state is equal to "Warning".
  • WARN if an enabled sensor health state is equal to "Warning".
  • WARN if sensor value is above/below Redfish non-critical threshold (Thresholds_UpperCaution and Thresholds_LowerCaution).

Perfdata / Metrics

Depends on your hardware - as an example:

  • Chassis_Chassis_Fan_1
  • Chassis_Chassis_Fan_2
  • Chassis_Power_reading_for_the_Chassis
  • Chassis_Power_Supply_1_12V_Output_Current
  • Chassis_Total_Energy
  • CPU_CPU_1_Fan_Speed
  • CPU_CPU_1_Temperature
  • CPU_CPU_2_Fan_Speed
  • Exhaust_Fan_Bay_1_Exhaust_Temperature
  • Intake_Front_Panel_Intake_Temperature
  • Memory_DIMM_1_Temperature
  • Memory_DIMM_2_Temperature
  • Memory_DIMM_3_Temperature
  • PowerSupply_Power_Supply_1_12V_Output_Voltage
  • PowerSupply_Power_Supply_1_3V_Output_Current
  • PowerSupply_Power_Supply_1_3V_Output_Voltage
  • PowerSupply_Power_Supply_1_5V_Output_Current
  • PowerSupply_Power_Supply_1_5V_Output_Voltage
  • PowerSupply_Power_Supply_1_Energy
  • PowerSupply_Power_Supply_1_Frequency
  • PowerSupply_Power_Supply_1_Input_Current
  • PowerSupply_Power_Supply_1_Input_Power
  • PowerSupply_Power_Supply_1_Input_Voltage
  • Room_Ambient_Temperature

Credits, License