PANTAW COLLECTOR · STORAGE

filesystem collector

Inventory mounted filesystems and their capacity facts.

Source and collected facts

Direct read-only parsing of /proc/self/mountinfo plus standard filesystem statistics.

  • mount and parent identifiers
  • device, root and mount point
  • filesystem and mount options
  • total, free, available and used bytes
  • inode totals and availability

Observation contract

Each usable mount produces a deterministic observation; missing statistics may make it PARTIAL, while an unreadable mount inventory is UNAVAILABLE.

Relevant ReasonCode values: FILESYSTEM_OBSERVED, FILESYSTEM_PARTIAL, INTERNAL_ERROR

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

Graceful unavailability and limits

Namespaces and permissions determine which mounts are visible. Transient mounts may disappear during collection.

Permissions and privacy

Permissions. The runtime must read mountinfo and stat visible mount points.

Privacy. Mount points and source names can reveal application layout; protect audit access.

Sanitized example

{
  "source": "filesystem",
  "status": "SUCCESS",
  "severity": "INFO",
  "reason_code": "FILESYSTEM_OBSERVED",
  "target": "mount:root",
  "metadata": {"filesystem_type":"ext4","total_bytes":536870912000,"mount_options":["rw"]}
}

Synthetic example. It is not production node data.