PANTAW COLLECTOR · STORAGE

nvme collector

Inventory NVMe controllers exposed by the Linux kernel.

Source and collected facts

Direct read-only sysfs inspection under /sys/class/nvme; nvme-cli is not required by this collector.

  • controller name
  • model and firmware revision
  • controller state
  • transport and address

Observation contract

Complete controller inventory produces SUCCESS; missing optional identity or transport fields produce PARTIAL; absent or inaccessible sysfs produces UNAVAILABLE.

Relevant ReasonCode values: NVME_OBSERVED, NVME_PARTIAL, INTERNAL_ERROR

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

Graceful unavailability and limits

This release inventories controllers but does not claim full NVMe health-log telemetry.

Permissions and privacy

Permissions. Read access to NVMe sysfs attributes is required.

Privacy. Controller model, firmware and address can fingerprint hardware topology.

Sanitized example

{
  "source": "nvme",
  "status": "SUCCESS",
  "severity": "INFO",
  "reason_code": "NVME_OBSERVED",
  "target": "controller:nvme0",
  "metadata": {"controller":"nvme0","model":"Example NVMe","firmware_revision":"1.0","state":"live"}
}

Synthetic example. It is not production node data.