PANTAW COLLECTOR · HARDWARE

hwmon collector

Collect generic kernel hwmon sensor values with normalized units.

Source and collected facts

Direct read-only sysfs inspection under /sys/class/hwmon.

  • chip and sensor names
  • labels and sensor types
  • raw and normalized values
  • measurement units

Observation contract

Usable sensors produce SUCCESS; incomplete labels or values may be PARTIAL; absent or unreadable facilities produce UNAVAILABLE.

Relevant ReasonCode values: HARDWARE_SENSOR_OBSERVED, HARDWARE_SENSOR_PARTIAL, HARDWARE_SENSOR_UNAVAILABLE

All collectors use structured ObservationStatus values and retain unavailable optional fields explicitly.

Graceful unavailability and limits

Sensor exposure depends on kernel modules, firmware, virtualization and hardware.

Permissions and privacy

Permissions. The runtime account needs read access to the exposed hwmon attributes.

Privacy. Sensor and chip labels may reveal hardware design but do not require serial-number collection.

Sanitized example

{
  "source": "hwmon",
  "status": "SUCCESS",
  "severity": "INFO",
  "reason_code": "HARDWARE_SENSOR_OBSERVED",
  "target": "hwmon:temp1",
  "metadata": {"chip_name":"coretemp","sensor":"temp1","normalized_value":42.5,"unit":"celsius"}
}

Synthetic example. It is not production node data.