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.

Monitor Network Inventory

With NetQ, a network administrator can monitor both the switch hardware and its operating system for misconfigurations or misbehaving services. The Devices Inventory card workflow provides a view into the switches and hosts installed in your network and their various hardware and software components. The workflow contains a small card with a count of each device type in your network, a medium card displaying the operating systems running on each set of devices, large cards with component information statistics, and full-screen cards displaying tables with attributes of all switches and all hosts in your network.

The Devices Inventory card workflow helps answer questions such as:

  • What switches do I have in the network?
  • What is the distribution of ASICs across my network?
  • Do all switches have valid licenses?
  • Are NetQ agents running on all of my switches?

For monitoring inventory and performance on a switch-by-switch basis, refer to Monitor Switches.

Devices Inventory Card Workflow Summary

The small Devices Inventory card displays:

Item Description
Indicates data is for device inventory
Total number of switches in inventory during the designated time period
Total number of hosts in inventory during the designated time period

The medium Devices Inventory card displays:

Item Description
Indicates data is for device inventory
Title Inventory | Devices
Total number of switches in inventory during the designated time period
Total number of hosts in inventory during the designated time period
Charts Distribution of operating systems deployed on switches and hosts, respectively

The large Devices Inventory card has one tab.

The Switches tab displays:

Item Description
Time period Always Now for inventory by default
Indicates data is for device inventory
Title Inventory | Devices
Total number of switches in inventory during the designated time period
Link to full screen listing of all switches
Component Switch components monitored-ASIC, Operating System (OS), Cumulus Linux license, NetQ Agent version, and Platform
Distribution charts Distribution of switch components across the network
Unique Number of unique items of each component type. For example, for License, you might have CL 2.7.2 and CL 2.7.4, giving you a unique count of two.

The full screen Devices Inventory card provides tabs for all switches and all hosts.

Item Description
Title Inventory | Devices | Switches
Closes full screen card and returns to workbench
Time period Time period does not apply to the Inventory cards. This is always Default Time.
Displays data refresh status. Click to pause data refresh. Click to resume data refresh. Current refresh rate is visible by hovering over icon.
Results Number of results found for the selected tab
All Switches and All Hosts tabs Displays all monitored switches and hosts in your network. By default, the device list is sorted by hostname. These tabs provide the following additional data about each device:
  • Agent
    • State: Indicates communication state of the NetQ Agent on a given device. Values include Fresh (heard from recently) and Rotten (not heard from recently).
    • Version: Software version number of the NetQ Agent on a given device. This should match the version number of the NetQ software loaded on your server or appliance; for example, 2.1.0.
  • ASIC
    • Core BW: Maximum sustained/rated bandwidth. Example values include 2.0 T and 720 G.
    • Model: Chip family. Example values include Tomahawk, Trident, and Spectrum.
    • Model Id: Identifier of networking ASIC model. Example values include BCM56960 and BCM56854.
    • Ports: Indicates port configuration of the switch. Example values include 32 x 100G-QSFP28, 48 x 10G-SFP+, and 6 x 40G-QSFP+.
    • Vendor: Manufacturer of the chip. Example values include Broadcom and Mellanox.
  • CPU
    • Arch: Microprocessor architecture type. Values include x86_64 (Intel), ARMv7 (AMD), and PowerPC.
    • Max Freq: Highest rated frequency for CPU. Example values include 2.40 GHz and 1.74 GHz.
    • Model: Chip family. Example values include Intel Atom C2538 and Intel Atom C2338.
    • Nos: Number of cores. Example values include 2, 4, and 8.
  • Disk Total Size: Total amount of storage space in physical disks (not total available). Example values: 10 GB, 20 GB, 30 GB.
  • License State: Indicator of validity. Values include ok and bad.
  • Memory Size: Total amount of local RAM. Example values include 8192 MB and 2048 MB.
  • OS
    • Vendor: Operating System manufacturer. Values include Cumulus Networks, RedHat, Ubuntu, and CentOS.
    • Version: Software version number of the OS. Example values include 3.7.3, 2.5.x, 16.04, 7.1.
    • Version Id: Identifier of the OS version. For Cumulus, this is the same as the Version (3.7.x).
  • Platform
    • Date: Date and time the platform was manufactured. Example values include 7/12/18 and 10/29/2015.
    • MAC: System MAC address. Example value: 17:01:AB:EE:C3:F5.
    • Model: Manufacturer's model name. Examples values include AS7712-32X and S4048-ON.
    • Number: Manufacturer part number. Examples values include FP3ZZ7632014A, 0J09D3.
    • Revision: Release version of the platform
    • Series: Manufacturer serial number. Example values include D2060B2F044919GD000060, CN046MRJCES0085E0004.
    • Vendor: Manufacturer of the platform. Example values include Cumulus Express, Dell, EdgeCore, Lenovo, Mellanox.
  • Time: Date and time the data was collected from device.

View the Number of Each Device Type in Your Network

You can view the number of switches and hosts deployed in your network. As you grow your network this can be useful for validating that devices have been added as scheduled.

To view the quantity of devices in your network, open the small Devices Inventory card.

Chassis are not monitored in this release, so an N/A (not applicable) value is displayed for these devices, even if you have chassis in your network.

View Which Operating Systems Are Running on Your Network Devices

You can view the distribution of operating systems running on your switches and hosts. This is useful for verifying which versions of the OS are deployed and for upgrade planning. It also provides a view into the relative dependence on a given OS in your network.

To view the OS distribution, open the medium Devices Inventory card if it is not already on your workbench.

View Switch Components

To view switch components, open the large Devices Inventory card. By default the Switches tab is shown displaying the total number of switches, ASIC vendor, OS versions, license status, NetQ Agent versions, and specific platforms deployed on all of your switches.

Highlight a Selected Component Type

You can hover over any of the segments in a component distribution chart to highlight a specific type of the given component. When you hover, a tooltip appears displaying:

  • the name or value of the component type, such as the version number or status

  • the total number of switches with that type of component deployed compared to the total number of switches

  • percentage of this type with respect to all component types.

Additionally, sympathetic highlighting is used to show the related component types relevant to the highlighted segment and the number of unique component types associated with this type (shown in blue here).

Focus on a Selected Component Type

To dig deeper on a particular component type, you can filter the card data by that type. In this procedure, the result of filtering on the OS is shown.

To view component type data:

  1. Click a segment of the component distribution charts.

  2. Select the first option from the popup, Filter <component name>. The card data is filtered to show only the components associated with selected component type. A filter tag appears next to the total number of switches indicating the filter criteria.

  3. Hover over the segments to view the related components.

  4. To return to the full complement of components, click the in the filter tag.

While the Device Inventory cards provide a network-wide view, you may want to see more detail about your switch inventory. This can be found in the Switches Inventory card workflow. To open that workflow, click the Switch Inventory button at the top right of the Switches card.

View All Switches

You can view all stored attributes for all switches in your network. To view all switch details, open the full screen Devices Inventory card and click the All Switches tab in the navigation panel.

To return to your workbench, click in the top right corner of the card.

View All Hosts

You can view all stored attributes for all hosts in your network. To view all hosts details, open the full screen Devices Inventory card and click the All Hosts tab in the navigation panel.

To return to your workbench, click in the top right corner of the card.