Skip to main content
Version: Stable

Hardware Labels

When a node is registered, the data is stored in the inventory with default labels and values relative to the node hardware.

This data is used for easy identification and selection via a MachineSelector.

The following labels are set up automatically:

LabelDescription
elemental.cattle.io/TotalMemoryThe total RAM memory in the node, expressed in bytes
elemental.cattle.io/CpuTotalCoresTotal CPU cores
elemental.cattle.io/CpuTotalThreadsTotal CPU threads
elemental.cattle.io/CpuVendorCPU vendor
elemental.cattle.io/CpuModelCPU model
elemental.cattle.io/GpuModelGPU model (Only available if the node has an identifiable GPU)
elemental.cattle.io/GpuVendorGPU vendor (Only available if the node has an identifiable GPU)
elemental.cattle.io/NetNumberInterfacesNumber of network interfaces in the system
elemental.cattle.io/NetIfaceX-NameNetwork interface name
elemental.cattle.io/NetIfaceX-VirtualWhether the Network Interface is a virtual one
elemental.cattle.io/BlockTotalNumber of block devices in the system (includes DVD and USB drives)
elemental.cattle.io/BlockDeviceX-NameDevice name of the block device (i.e. sda, sr0, vda, etc...)
elemental.cattle.io/BlockDeviceX-RemovableWhether this block device is removable (i.e. DVD)
elemental.cattle.io/BlockDeviceX-SizeTotal space in this block device, expressed in bytes
elemental.cattle.io/BlockDeviceX-DriveTypeDrive type of this block device, see table below
elemental.cattle.io/BlockDeviceX-ControllerTypeController type for this block device connection, see table below
info

On both BlockDeviceX and NetIfaceX the X indicates a number, as there could be more than one device. Numbers are just for enumeration purposes and have no relation with the underlying hardware.

Block device drive types

TypeDescription
HDDHard disk drive
FDDFloppy disk drive
ODDOptical disk drive
SSDSolid-state drive
virtualvirtual drive i.e. loop devices
Unknownunknown drive type

Block device controller types

TypeDescription
IDEIntegrated Drive Electronics
SCSISmall computer system interface
NVMeNon-volatile Memory Express
MMCMulti-media controller (used for mobile phone storage devices)
virtioVirtualized storage controller/driver
looploop device
Unknownunknown controller type