PANTAW COLLECTOR · HARDWARE

thermal collector

Normalize temperature observations from thermal zones and hwmon.

Source and collected facts

Direct read-only sysfs reads from /sys/class/thermal and /sys/class/hwmon.

source type and source name
sensor label
temperature in millidegrees Celsius
normalized Celsius value

Observation contract

Valid temperatures produce SUCCESS; incomplete sensor metadata produces PARTIAL; no usable thermal exposure produces UNAVAILABLE.

Relevant ReasonCode values: THERMAL_OBSERVED, THERMAL_PARTIAL, HARDWARE_SENSOR_UNAVAILABLE

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

Graceful unavailability and limits

Firmware and kernel drivers decide which zones exist and whether values are accurate.

Permissions and privacy

Permissions. Read access to thermal and hwmon sysfs attributes is required.

Privacy. Thermal readings are operational data and should not be tied publicly to a real host.

Sanitized example

{
  "source": "thermal",
  "status": "SUCCESS",
  "severity": "INFO",
  "reason_code": "THERMAL_OBSERVED",
  "target": "thermal-zone:0",
  "metadata": {"source_type":"thermal_zone","label":"package","temperature_celsius":43.0}
}

Synthetic example. It is not production node data.