|
|
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>
| |