Plugin:IPMI

IPMI plugin
Type:	read
Callbacks:	config, init, read, shutdown
Status:	supported
First version:	4.4
Copyright:	2008–2009 Florian octo Forster 2008 Peter Holik 2009 Bruno Prémont
License:	GPLv2
Manpage:	collectd.conf(5)
List of Plugins

The IPMI plugin uses the OpenIPMI library to read hardware sensors from servers using the Intelligent Platform Management Interface (IPMI). IPMI is very common with server hardware but usually not available in consumer hardware.

It might be reasonable to start with no specific configuration for sensors and look up the exact names after suitable sensor data has been logged since the strings needed aren't exactly ipmitool sdr names.

Synopsis

<Plugin "ipmi">
    Sensor "some_sensor"
    Sensor "another_one"
    IgnoreSelected false
    NotifySensorAdd false
    NotifySensorRemove true
    NotifySensorNotPresent false
    SELEnabled false
    SELClearEvent false
</Plugin>

Parameters

Name	Description	Comment
Interval	The interval within which to retrieve information about sensors in seconds	Interval option is supported by collectd and is defined in <LoadPlugin> block. No additional functionality should be developed in ipmi plugin to support this option.
Sensor	Selects sensors to collect information.	Depends on ignoreSelected.
IgnoreSelected	If TRUE, selects all sensors except those defined in Sensor. Else all sensors from the list of Sensor will be selected.	If no configuration if given, the ipmi plugin will collect data from all sensors found.
NotifySensorAdd	Enables or disables notification to be send when sensor appears.	If a sensor appears after initialization time of a minute a notification is sent.
NotifySensorRemove	Enables or disables notification to be send when sensor disappears.	If a sensor disappears a notification is sent.
NotifySensorNotPresent	Enables or disables notification to be send when sensor has been (un)plugged.	If you have for example dual power supply and one of them is (un)plugged then a notification is sent.
SELEnabled	Enables or disables subscription for SEL events.	If system event log (SEL) is enabled, plugin will listen for sensor threshold and discrete events. When event is received the notification is sent.
SELClearEvent	Enables or Disables clearing the event after successful handling.	If SEL clear event is enabled, plugin will delete event from SEL list after it is received and successfully handled. In this case other tools that are subscribed for SEL events will receive an empty event.

Metrics

Technology/Category	Metric/Feature Name	Date Type	Format Example	Collectd Release	Collectd Plugin	Description	Dependencies	Limitations	Comments
IPMI	Fan Speed	Char & Int	None	5.8	ipmi	Reads multiple fan speed			Gets Metric from SDR.
IPMI	Air Flow	Char & Int	None	5.8	ipmi	Reads systemair flow data of system chassis			Gets Metric from SDR.
IPMI	Power Supply	Char & Int	None	5.8	ipmi	Read the power supply for the CPU			Gets Metric from SDR.
IPMI	Thermal Control	Char & Int	None	5.8	ipmi	Reads the Thermal Control percentage for CPU			Gets Metric from SDR.
IPMI	Temperature	Char & Int	None	5.8	ipmi	Reads temperature of different compenents in the base board			Gets Metric from SDR.
IPMI	Voltage	Char & Int	None	5.8	ipmi	Reads voltage on system board			Gets Metric from SDR.

Example graphs

Dependencies

• OpenIPMI library

See Also

• IPMI plugin high level design document