Hardware Monitoring
NetXMS can monitor hardware health including temperatures, fan speeds, voltages, and power supply status through various protocols and interfaces.
Overview
Hardware monitoring data sources in NetXMS:
-
SNMP — most network equipment and servers expose hardware sensors via SNMP
-
Agent subagents — platform-specific hardware access
-
Device drivers — vendor-specific hardware monitoring
SNMP-Based Hardware Monitoring
Many devices expose hardware health information through SNMP MIBs:
Entity MIB (ENTITY-MIB)
The Entity MIB provides physical entity information (chassis, modules, ports):
| OID | Description |
|---|---|
|
Physical entity description |
|
Entity class (chassis, module, port, sensor, etc.) |
|
Entity name |
Entity Sensor MIB (ENTITY-SENSOR-MIB)
Provides sensor readings for temperature, voltage, current, and power:
| OID | Description |
|---|---|
|
Sensor type (temperature, voltage, current, power, etc.) |
|
Current sensor reading |
|
Operational status (ok, unavailable, nonoperational) |
Vendor-Specific MIBs
Many vendors provide additional hardware monitoring MIBs:
-
Cisco — CISCO-ENVMON-MIB for environment monitoring
-
HP/HPE — CPQHLTH-MIB for ProLiant health
-
Dell — DELL-RAC-MIB for iDRAC monitoring
-
APC — PowerNet-MIB for UPS and PDU monitoring
See MIB Management for loading vendor MIBs.
Agent-Based Hardware Monitoring
lm-sensors Subagent (Linux)
The lmsensors subagent reads hardware sensors via the lm_sensors library (libsensors).
SubAgent = lmsensors
[LMSENSORS]
UseFahrenheit = no
ConfigFile = /etc/custom-sensors.conf
Parameters in the [LMSENSORS] section:
| Parameter | Default | Description |
|---|---|---|
|
|
Convert temperature readings to Fahrenheit |
|
(empty) |
Path to custom |
The subagent exposes a single metric that can read any sensor value:
LMSensors.Value(chip,label)
The chip and label arguments correspond to the output of the sensors command. Examples:
LMSensors.Value(coretemp-isa-0001,Core 1) LMSensors.Value(w83627dhg-isa-0290,AVCC) LMSensors.Value(nct6776-isa-0290,fan1)
Supported sensor types: temperature, voltage, fan speed, power, energy, current, CPU VID.
The lm_sensors package must be installed and configured on the monitored system. Run sensors-detect first to identify available sensors.
|
DS18x20 Temperature Sensor Subagent (Linux)
The ds18x20 subagent reads Dallas/Maxim DS18x20 1-Wire temperature sensors via the Linux kernel 1-Wire driver (/sys/bus/w1/devices/).
SubAgent = ds18x20
[DS18X20]
Sensor = outdoor:28-0000045ab123
Sensor = indoor:28-0000045cd456
The Sensor parameter maps an alias to a 1-Wire device ID. Can be repeated.
| Parameter | Description |
|---|---|
|
Temperature in Celsius from the named sensor |
|
Temperature using raw 1-Wire device ID (e.g. |
| List | Description |
|---|---|
|
Names of all configured (aliased) sensors |
Raspberry Pi Subagent
The rpi subagent provides GPIO access and DHT22 sensor readings on Raspberry Pi systems.
SubAgent = rpi
[RPI]
InputPins = 17,27
OutputPins = 22,23
| Parameter | Default | Description |
|---|---|---|
|
Comma-separated GPIO pin numbers to configure as INPUT |
|
|
Comma-separated GPIO pin numbers to configure as OUTPUT |
|
|
|
Disable DHT22 sensor data collection |
Metrics:
| Parameter | Description |
|---|---|
|
State of GPIO pin: 1 (HIGH) or 0 (LOW) |
|
Relative humidity (%) from DHT22 sensor on GPIO pin 4 |
|
Temperature from DHT22 sensor on GPIO pin 4 |
|
Raspberry Pi CPU temperature (from thermal zone) |
Actions:
| Action | Description |
|---|---|
|
Set GPIO pin state. Arguments: pin number, state (1=HIGH, 0=LOW) |
The DHT22 sensor is hardwired to GPIO pin 4 and polled every 1.5 seconds.
GPS Receiver Subagent
The gps subagent reads a GPS receiver attached to a serial port.
Its NMEA parser recognizes GPGGA, GPGSA, GPGSV, GPRMC, and GPVTG sentences.
It exposes the receiver’s position, fix status, speed, and satellite information as agent metrics.
Load and configure the subagent in nxagentd.conf, then restart the agent:
SubAgent = gps
[GPS]
Device = /dev/ttyUSB0,4800,8,N,1
UERE = 32
On Windows, use a Windows serial-port name such as COM1: in the Device value.
The agent process needs permission to open the device.
| Parameter | Default | Description |
|---|---|---|
|
Required |
Serial configuration in |
|
|
User Equivalent Range Error in meters, used to calculate the reported location accuracy as the integer part of |
After startup, the reader waits 30 seconds before reading sentences. It reads continuously while serial input is available, with a 2-second serial read timeout; after a read or open failure it retries after 30 seconds. Parsed values remain in memory between reads, so a successful metric request alone does not prove that the receiver is still sending data.
During each status poll, if the node’s location type is not Manual, the server reads GPS.LocationData from the node’s agent.
When the quality indicator and the fix are both non-zero, the server sets the node location from it, with location type Automatic from GPS receiver.
A manually set location is preserved.
The node location is used on geographical maps (see Geographical Maps).
GPS Metrics
Provided by the gps subagent for a serial GPS receiver producing NMEA sentences.
Metrics return the latest parsed values and do not initiate a read from the receiver.
Old values remain available after serial communication stops; check GPS.Fix, GPS.QualityIndicator, and the timestamp in GPS.LocationData before relying on a position.
GPS.Direction
Ground track angle in degrees relative to true north.
Data Type |
Float |
Platforms |
Windows, UNIX-like systems |
GPS.Elevation
Antenna altitude above or below mean sea level in meters.
Data Type |
Float |
Platforms |
Windows, UNIX-like systems |
GPS.Fix
Operating mode: 1 = no fix, 2 = 2D fix, 3 = 3D fix.
Data Type |
Integer |
Platforms |
Windows, UNIX-like systems |
GPS.HDOP
Horizontal dilution of precision reported by the NMEA parser.
Data Type |
Float |
Platforms |
Windows, UNIX-like systems |
GPS.Latitude
Latitude in decimal degrees; negative values are south of the equator.
Data Type |
Float |
Platforms |
Windows, UNIX-like systems |
GPS.LatitudeText
Latitude as text in degrees, minutes, and seconds with the hemisphere letter, for example 56°56'51.000"N.
Data Type |
String |
Platforms |
Windows, UNIX-like systems |
GPS.Location
Formatted latitude and longitude separated by a space.
Data Type |
String |
Platforms |
Windows, UNIX-like systems |
GPS.LocationData
Comma-separated fields: quality indicator, fix, latitude, longitude, accuracy in meters, elevation in meters, speed in km/h, direction in degrees, HDOP, and UNIX timestamp.
Accuracy is the integer part of HDOP * UERE.
The timestamp is agent time when a supported NMEA sentence was parsed, including satellite or velocity sentences that do not update the coordinates.
It is not the time of the last valid position fix.
Data Type |
String |
Platforms |
Windows, UNIX-like systems |
GPS.Longitude
Longitude in decimal degrees; negative values are west of Greenwich.
Data Type |
Float |
Platforms |
Windows, UNIX-like systems |
GPS.LongitudeText
Longitude as text in degrees, minutes, and seconds with the hemisphere letter, for example 24°06'21.000"E.
Data Type |
String |
Platforms |
Windows, UNIX-like systems |
GPS.QualityIndicator
Position quality value maintained by the NMEA parser. A value of 0 indicates an invalid position. GGA data supplies its quality field; RMC data can set this value to 2 for an active position or 0 for a void position.
Data Type |
Integer |
Platforms |
Windows, UNIX-like systems |
GPS.Satellites.InUse
Number of satellites used for the position fix.
Data Type |
Integer |
Platforms |
Windows, UNIX-like systems |
GPS.Satellites.InView
Number of satellites in view.
Data Type |
Integer |
Platforms |
Windows, UNIX-like systems |
GPS.Speed
Speed over the ground in kilometers per hour.
Data Type |
Float |
Platforms |
Windows, UNIX-like systems |
GPS Troubleshooting
-
Subagent does not initialize — check that
[GPS]containsDevice. The log reportsGPS receiver device not specifiedwhen it is missing. -
No position or an old position — check serial permissions, speed and framing, and whether the receiver sends the supported
GPNMEA sentences. Allow the initial 30-second reader delay. Review fix status, position quality, and the timestamp fromGPS.LocationDatatogether; those fields also remain unchanged if input stops. -
Serial errors — enable agent debug tag
gps; level 1 reports the selected configuration, level 7 includes port reopen failures, and level 8 includes read failures.
Windows Hardware (WMI)
On Windows, hardware information is available through the WMI subagent. See OS monitoring for WMI details including:
-
ACPI thermal zone temperatures
-
Hardware network adapter details
-
Security product detection (antivirus, firewall, antispyware)
-
Generic WMI queries for any hardware class
RAID and Storage Health
RAID Controller Monitoring
Monitor RAID array health through vendor-specific tools and external metrics:
ExternalMetric = RAID.Status:/opt/MegaRAID/storcli64 /c0/v0 show | grep State | awk '{print $3}'
ExternalMetric = RAID.DiskErrors:/opt/MegaRAID/storcli64 /c0/e252/s0 show | grep 'Media Error' | awk '{print $4}'
Disk SMART Monitoring
The agent provides SMART monitoring through the PhysicalDisk.* metrics. These metrics require the smartctl utility (smartmontools) on the monitored host.
Commonly used metrics include:
-
PhysicalDisk.SmartStatus(device)— overall SMART health status -
PhysicalDisk.Temperature(device)— disk temperature -
PhysicalDisk.SmartAttr(device, attribute)— value of a specific SMART attribute -
PhysicalDisk.PowerOnTime(device)andPhysicalDisk.PowerCycles(device)— usage counters -
PhysicalDisk.Model(device)andPhysicalDisk.SerialNumber(device)— device identification
Use the PhysicalDisk.Devices list or table to enumerate available disks.
See Physical Disk Metrics for the full metric reference.
If you need smartctl-specific attributes not covered by the native metrics, define an ExternalMetric as a fallback:
ExternalMetric = Disk.ReallocatedSectors(*):smartctl -A /dev/$1 | grep Reallocated_Sector | awk '{print $10}'
For each ExternalMetric definition the agent automatically provides a companion <name>.ExitCode metric (e.g. RAID.Status.ExitCode) returning the exit code of the command, which can be monitored to detect tool failures.
Power Supply Monitoring
For server power supply redundancy monitoring:
-
SNMP tables on server management controllers report PSU status (present, failed, redundancy lost)
-
UPS monitoring for external power protection (see UPS Monitoring)
Hardware Information Metrics
The NetXMS agent provides hardware inventory metrics via SMBIOS/DMI data on Linux, Windows, FreeBSD, and Solaris systems (a subset is available on AIX). These metrics are available as DCIs for hardware asset tracking and inventory. The server also collects the component list during configuration polls and generates events when it changes; see Hardware and Software Inventory.
Hardware parameters are sourced from SMBIOS/DMI data, available on Linux, Windows, FreeBSD, and Solaris (a subset on AIX).
On Solaris, the full SMBIOS metric set is available on x86 only; SPARC systems expose only Hardware.System.Manufacturer and Hardware.System.Product.
Use the corresponding Hardware.* list or table to enumerate available devices.
System Information
Hardware.System.MachineId
Unique machine identifier.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris, AIX |
Hardware.System.Manufacturer
System manufacturer.
Data Type |
String |
Platforms |
Linux, Windows, macOS, FreeBSD, Solaris, AIX |
Hardware.System.Product
Product model.
Data Type |
String |
Platforms |
Linux, Windows, macOS, FreeBSD, Solaris, AIX |
Hardware.System.ProductCode
Product code.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
Baseboard
Hardware.Baseboard.Manufacturer
Baseboard manufacturer.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
Hardware.Baseboard.Product
Baseboard product identifier.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
Battery
All battery metrics take a 0-based battery index as argument.
Hardware.Battery.Capacity(index)
Battery capacity rating (mWh).
Data Type |
Unsigned Integer |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Battery index (0-based) |
Hardware.Battery.Chemistry(index)
Battery chemistry type.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Battery index (0-based) |
Hardware.Battery.Location(index)
Physical location.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Battery index (0-based) |
Hardware.Battery.ManufactureDate(index)
Production date.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Battery index (0-based) |
Hardware.Battery.Manufacturer(index)
Battery manufacturer.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Battery index (0-based) |
Hardware.Battery.Name(index)
Battery name identifier.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Battery index (0-based) |
Memory Device
All memory device metrics take a 0-based device index as argument.
Hardware.MemoryDevice.Bank(index)
Memory bank location.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Memory device index (0-based) |
Hardware.MemoryDevice.ConfiguredSpeed(index)
Configured speed (MHz).
Data Type |
Unsigned Integer |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Memory device index (0-based) |
Hardware.MemoryDevice.FormFactor(index)
Physical form factor.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Memory device index (0-based) |
Hardware.MemoryDevice.Location(index)
Installation location.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Memory device index (0-based) |
Hardware.MemoryDevice.Manufacturer(index)
Memory manufacturer.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Memory device index (0-based) |
Hardware.MemoryDevice.MaxSpeed(index)
Maximum supported speed (MHz).
Data Type |
Unsigned Integer |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Memory device index (0-based) |
Hardware.MemoryDevice.PartNumber(index)
Part number.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Memory device index (0-based) |
Hardware.MemoryDevice.SerialNumber(index)
Serial number.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Memory device index (0-based) |
Processor
All processor metrics take a 0-based processor index as argument.
Hardware.Processor.Cores(index)
Physical core count.
Data Type |
Unsigned Integer |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Processor index (0-based) |
Hardware.Processor.CurrentSpeed(index)
Operating frequency (MHz).
Data Type |
Unsigned Integer |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Processor index (0-based) |
Hardware.Processor.Family(index)
Processor family.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Processor index (0-based) |
Hardware.Processor.Manufacturer(index)
Processor vendor.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Processor index (0-based) |
Hardware.Processor.MaxSpeed(index)
Maximum frequency (MHz).
Data Type |
Unsigned Integer |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Processor index (0-based) |
Hardware.Processor.PartNumber(index)
Part number.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Processor index (0-based) |
Hardware.Processor.SerialNumber(index)
Serial number.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Processor index (0-based) |
Hardware.Processor.Socket(index)
Socket type.
Data Type |
String |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Processor index (0-based) |
Hardware.Processor.Threads(index)
Thread count.
Data Type |
Unsigned Integer |
Platforms |
Linux, Windows, FreeBSD, Solaris |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Processor index (0-based) |
Storage Device
All storage device metrics take a 0-based device index as argument.
Hardware.StorageDevice.BusType(index)
Bus type identifier.
Data Type |
String |
Platforms |
Windows |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Storage device index (0-based) |
Hardware.StorageDevice.IsRemovable(index)
Removable device flag (1=yes, 0=no).
Data Type |
Integer |
Platforms |
Windows |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Storage device index (0-based) |
Hardware.StorageDevice.Manufacturer(index)
Manufacturer.
Data Type |
String |
Platforms |
Windows |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Storage device index (0-based) |
Hardware.StorageDevice.Product(index)
Product name.
Data Type |
String |
Platforms |
Windows |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Storage device index (0-based) |
Hardware.StorageDevice.Revision(index)
Firmware revision.
Data Type |
String |
Platforms |
Windows |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Storage device index (0-based) |
Hardware.StorageDevice.SerialNumber(index)
Serial number.
Data Type |
String |
Platforms |
Windows |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Storage device index (0-based) |
Hardware.StorageDevice.Size(index)
Size in bytes.
Data Type |
Unsigned Integer 64 |
Platforms |
Windows |
| Argument | Type | Description |
|---|---|---|
index |
Integer |
Storage device index (0-based) |
Thresholds for Hardware Metrics
Recommended threshold examples:
| Metric | Warning | Critical |
|---|---|---|
CPU temperature |
>75°C |
>85°C |
Ambient temperature |
>30°C |
>40°C |
Fan speed |
<2000 RPM |
<1000 RPM |
Voltage (deviation) |
>5% from nominal |
>10% from nominal |
Adjust thresholds based on hardware specifications and environmental conditions.
See Thresholds for configuration details.