PANTAW COLLECTOR · STORAGE

block_device collector

Inventory Linux block devices and partitions.

Source and collected facts

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

  • device name and major/minor number
  • size and logical block size
  • read-only, removable and partition flags
  • model and vendor where exposed

Observation contract

Complete device facts produce SUCCESS; missing optional identity fields produce PARTIAL; unavailable sysfs inventory produces UNAVAILABLE.

Relevant ReasonCode values: BLOCK_DEVICE_OBSERVED, BLOCK_DEVICE_PARTIAL, INTERNAL_ERROR

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

Graceful unavailability and limits

Virtual devices and containers expose only their visible sysfs view. Size is derived from kernel sectors.

Permissions and privacy

Permissions. Read access to the relevant sysfs attributes is required.

Privacy. Model and topology can fingerprint storage; serial numbers are not part of this snapshot.

Sanitized example

{
  "source": "block_device",
  "status": "SUCCESS",
  "severity": "INFO",
  "reason_code": "BLOCK_DEVICE_OBSERVED",
  "target": "device:vda",
  "metadata": {"name":"vda","size_bytes":107374182400,"read_only":false,"is_partition":false}
}

Synthetic example. It is not production node data.