lm-sensors Subagent

From NetXMS Wiki
Revision as of 12:21, 28 June 2012 by Victor (talk | contribs) (Created page with "{{DISPLAYTITLE:lm-sensors Subagent}} This subagent can be used to read hardware status using lm_sensors package. = Pre-requirements = Package lm_sensors should installed and ...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This subagent can be used to read hardware status using lm_sensors package.

Pre-requirements

Package lm_sensors should installed and configured properly. Output of sensors command should produce meaningful output. Example:

alk@b08s02ur:~$ sensors
w83627dhg-isa-0290
Adapter: ISA adapter
Vcore:       +1.14 V  (min =  +0.00 V, max =  +1.74 V)   
in1:         +1.61 V  (min =  +0.05 V, max =  +0.01 V)   ALARM
AVCC:        +3.31 V  (min =  +2.98 V, max =  +3.63 V)   
VCC:         +3.31 V  (min =  +2.98 V, max =  +3.63 V)   
in4:         +1.79 V  (min =  +1.29 V, max =  +0.05 V)   ALARM
in5:         +1.26 V  (min =  +0.05 V, max =  +1.67 V)   
in6:         +0.10 V  (min =  +0.26 V, max =  +0.08 V)   ALARM
3VSB:        +3.30 V  (min =  +2.98 V, max =  +3.63 V)   
Vbat:        +3.18 V  (min =  +2.70 V, max =  +3.30 V)   
fan1:       3308 RPM  (min = 1188 RPM, div = 8)
fan2:       6250 RPM  (min = 84375 RPM, div = 8)  ALARM
fan3:          0 RPM  (min = 5273 RPM, div = 128)  ALARM
fan4:          0 RPM  (min = 10546 RPM, div = 128)  ALARM
fan5:          0 RPM  (min = 10546 RPM, div = 128)  ALARM
temp1:       +39.0°C  (high =  +4.0°C, hyst =  +1.0°C)  ALARM  sensor = diode
temp2:       +17.0°C  (high = +80.0°C, hyst = +75.0°C)  sensor = diode
temp3:      +124.5°C  (high = +80.0°C, hyst = +75.0°C)  ALARM  sensor = thermistor
cpu0_vid:   +2.050 V

coretemp-isa-0000
Adapter: ISA adapter
Core 0:      +37.0°C  (high = +76.0°C, crit = +100.0°C)  

coretemp-isa-0001
Adapter: ISA adapter
Core 1:      +37.0°C  (high = +76.0°C, crit = +100.0°C)

Provided Parameters

When loaded, lm_sensors subagent adds the following parameters to agent:

Parameter Description
LMSensors.Value("chip", "label") Current value returned by hardware sensor

Configuration file

All configuration parameters related to lm_sensors subagent should be placed into *LMSENSORS section of agent's configuration file. The following configuration parameters are supported:

Parameter Format Description Default value
UseFahrenheit Boolean If set to "yes", all temperature reading will be converted to fahrenheit no
ConfigFile String Path to sensors.conf none, use system default (usually /etc/sensors3.conf)

Configuration Example

MasterServers = netxms.demo
SubAgent = lmsensors.nsm

*LMSENSORS
UseFahrenheit = yes
ConfigFile = /etc/sensors.netxms.conf

Sample usage

(based on output of "sensors" from Pre-requirements section)

alk@b08s02ur:~$ nxget netxms.demo 'LMSensors.Value(coretemp-isa-0001,Core 1)'
38.000000
alk@b08s02ur:~$ nxget netxms.demo 'LMSensors.Value(w83627dhg-isa-0290,AVCC)'
3.312000