If you are using the current version of Cumulus NetQ, the content on this page may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

Networkwide Inventory

Use the UI or CLI to monitor your network’s inventory of switches, hosts, NICs, and DPUs. The inventory includes a count for each device and information about the hardware and software components on individual switches, such as the operating system, motherboard, ASIC, microprocessor, disk, memory, fan, and power supply information.

Networkwide Inventory Commands

Several forms of this command are available based on the inventory component you’d like to view. See the command line reference for additional options, definitions, and examples.

netq show inventory (brief | asic | board | cpu | disk | memory | os)

View Networkwide Inventory in the UI

The NetQ header displays the number of devices in your network that are 'fresh' or reachable.

To view the quantity of devices in your network, search for the “Inventory | Devices” card in the global search field. The medium-sized card displays the total number of devices in the network. Hover your cursor over the chart to view the number and percentage of switches, hosts, NICS, and DPUs that comprise your network.

medium inventory card displaying 8 total devices

Expand to the large card to view the distribution of ASIC vendors, OS versions, NetQ Agent versions, and platforms deployed across all switches in your network. You can hover over and select any of the segments in the distribution chart to highlight and filter data, including:

  • Name or value of the component type, such as the version number or status
  • Total number of switches with a particular type of component deployed compared to the total number of switches
  • Percentage of the selected type compared to all component types

Expand the Inventory/Devices card to full-screen to view comprehensive inventory information for all switches, hosts, DPUs, and NICs in your network in a table where you can filter and export data by selecting the icons above the table:

full-screen inventory/devices card displaying a list of switches

You can right-click the hostname of a given switch to open a monitoring dashboard for that switch in a new tab.