PANTAW COLLECTOR · HARDWARE

fan collector

Observe kernel-exposed fan speed facts.

Source and collected facts

Direct read-only fan input inspection under /sys/class/hwmon.

  • hwmon and chip name
  • fan channel and label
  • speed in RPM

Observation contract

Valid RPM readings produce SUCCESS; incomplete labels produce PARTIAL; absent or unreadable fan inputs produce UNAVAILABLE.

Relevant ReasonCode values: FAN_OBSERVED, FAN_PARTIAL, HARDWARE_SENSOR_UNAVAILABLE

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

Graceful unavailability and limits

Many server controllers do not expose fan telemetry through standard hwmon paths.

Permissions and privacy

Permissions. Read access to the relevant hwmon files is required.

Privacy. Fan labels can identify chassis layout; avoid publishing node-specific readings.

Sanitized example

{
  "source": "fan",
  "status": "SUCCESS",
  "severity": "INFO",
  "reason_code": "FAN_OBSERVED",
  "target": "fan:1",
  "metadata": {"chip_name":"platform-controller","fan":"fan1","rpm":1450}
}

Synthetic example. It is not production node data.