sys.sensors

Retrieves IPMI sensor readings, including temperatures, voltages, and fan speeds. Readings are collected with ipmiutil or ipmitool, and decimal values are supported. This method is only available when using RVC version 3.4.0 or later.

JSON-RPC Request

{"jsonrpc":"2.0","id":1,"method":"sys.sensors"}

JSON-RPC Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "status": "<status>",
        "anomalous_sensors": ["<sensor_name>"],
        "sensor_readings": [
            {
                "name": "<sensor_name>",
                "status": "<sensor_status>",
                "reading": "<reading>",
                "unit": "<unit>"
            }
        ]
    }
}

Response parameters

Parameter	Type	Description
`status`	String	The overall sensor status. `nominal` when no anomalies are detected.
`anomalous_sensors`	Array	The names of the sensors reporting a status other than OK. Empty when all sensors are nominal.
`sensor_readings`	Array	The individual sensor readings.
`sensor_readings[].name`	String	The sensor name.
`sensor_readings[].status`	String	The sensor status, such as `OK`, `Absent`, or `NotAvailable`.
`sensor_readings[].reading`	Number	The sensor reading, which can be a decimal value. `null` when the sensor is absent or unavailable.
`sensor_readings[].unit`	String	The unit of measurement, such as `C`, `RPM`, or `Volts`. `null` when `reading` is `null`.

RVC CLI Example

rvc sys sensors

Response

 Name              Status               Reading Unit
----------------------------------------------------------
 12V               OK                     12.13 Volts
 3.3V AUX          OK                      3.27 Volts
 3.3VCC            OK                      3.25 Volts
 5V Dual           OK                      4.89 Volts
 5VCC              OK                      4.87 Volts
 CPU Temp          OK                        43 C
 Chassis Intru     OK                      0x00 
 DIMMA1 Temp       OK                        36 C
 DIMMA2 Temp       NS                        -- 
 DIMMB1 Temp       OK                        36 C
 DIMMB2 Temp       NS                        -- 
 FAN1              OK                     3,300 RPM
 FAN2              NS                        -- 
 FAN3              NS                        -- 
 Peripheral Temp   OK                        37 C
 System Temp       OK                        35 C
 VBAT              OK                      3.04 Volts
 VCCP              OK                      0.82 Volts
 VDIMM             OK                      1.33 Volts

 Status: nominal