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