Difference between revisions of "Subagent:lm-sensors"

From NetXMS Wiki
Jump to navigation Jump to search
(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 ...")
 
(Replaced content with "Information moved to documentation: https://www.netxms.org/documentation/adminguide/hardware-monitoring.html")
Line 1: Line 1:
{{DISPLAYTITLE:lm-sensors Subagent}}
Information moved to documentation:
This subagent can be used to read hardware status using lm_sensors package.


= Pre-requirements =
https://www.netxms.org/documentation/adminguide/hardware-monitoring.html
Package lm_sensors should installed and configured properly. Output of [http://www.lm-sensors.org/wiki/man/sensors sensors] command should produce meaningful output.
Example:
<syntaxhighlight lang="ini">
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) 
</syntaxhighlight>
 
= Provided Parameters =
 
When loaded, lm_sensors subagent adds the following parameters to agent:
 
{| class="wikitable" style="width: 70%"
|-
! 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:
 
{| class="wikitable"
|-
! Parameter !! Format !! Description !! Default value
|-
| UseFahrenheit || Boolean || If set to "yes", all temperature reading will be converted to fahrenheit || no
|-
| ConfigFile || String || Path to [http://www.lm-sensors.org/wiki/man/sensors.conf sensors.conf] || none, use system default (usually /etc/sensors3.conf)
|-
|}
 
== Configuration Example ==
 
<syntaxhighlight lang="ini">
MasterServers = netxms.demo
SubAgent = lmsensors.nsm
 
*LMSENSORS
UseFahrenheit = yes
ConfigFile = /etc/sensors.netxms.conf
</syntaxhighlight>
 
= Sample usage =
(based on output of "sensors" from Pre-requirements section)
 
<syntaxhighlight lang="ini">
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
</syntaxhighlight>

Revision as of 17:58, 24 November 2017