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.

Hosts

The NetQ Agent monitors the following on Linux hosts:

  • netlink
  • Layer 2: LLDP and VLAN-aware bridge
  • Layer 3: IPv4, IPv6
  • systemctl for services

Using NetQ on a Linux host is the same as using it on a Cumulus Linux switch. For example, if you want to check LLDP neighbor information for a given host, run netq show lldp and specify the hostname:

cumulus@host:~$ netq server01 show lldp
Matching lldp records:
Hostname          Interface                 Peer Hostname     Peer Interface            Last Changed
----------------- ------------------------- ----------------- ------------------------- -------------------------
server01          eth0                      oob-mgmt-switch   swp2                      Mon Dec  2 21:22:55 2024
server01          eth1                      leaf01            swp1                      Mon Dec  2 21:22:55 2024
server01          eth2                      leaf02            swp1                      Mon Dec  2 21:22:55 2024

Then, to see LLDP from the switch perspective run the same command, specifying the hostname of the switch:

cumulus@switch:~$ netq leaf01 show lldp
Matching lldp records:
Hostname          Interface                 Peer Hostname     Peer Interface            Last Changed
----------------- ------------------------- ----------------- ------------------------- -------------------------
leaf01            eth0                      oob-mgmt-switch   swp10                     Mon Dec  2 20:54:07 2024
leaf01            swp1                      server01          mac:48:b0:2d:22:00:2d     Mon Dec  2 20:54:07 2024
leaf01            swp2                      server02          mac:48:b0:2d:46:72:25     Mon Dec  2 20:54:07 2024
leaf01            swp3                      server03          mac:48:b0:2d:48:f3:9e     Mon Dec  2 20:54:07 2024
leaf01            swp49                     leaf02            swp49                     Mon Dec  2 20:54:07 2024
leaf01            swp50                     leaf02            swp50                     Mon Dec  2 20:54:07 2024
leaf01            swp52                     spine02           swp1                      Mon Dec  2 20:54:07 2024
leaf01            swp53                     spine03           swp1                      Mon Dec  2 20:54:07 2024
leaf01            swp54                     spine04           swp1                      Mon Dec  2 20:54:07 2024

To view the routing table for a server, run netq show ip routes:

cumulus@host:~$ netq server01 show ip routes
Matching routes records:
Origin VRF             Prefix                         Hostname          Nexthops                            Protocol     Last Changed
------ --------------- ------------------------------ ----------------- ----------------------------------- ------------ -------------------------
false  default         0.0.0.0/0                      server01          192.168.200.1: eth0                 boot         Tue Oct  8 15:53:27 2024
false  default         0.0.0.0/0                      server01          192.168.200.1: eth0                 dhcp         Mon Dec  2 21:22:57 2024
false  default         10.0.0.0/8                     server01          10.1.10.1: uplink                   boot         Mon Dec  2 21:22:57 2024
true   default         10.1.10.0/24                   server01          uplink                              kernel       Mon Dec  2 21:22:57 2024
true   default         10.1.10.101/32                 server01          uplink                              kernel       Mon Dec  2 21:22:57 2024
false  default         10.188.0.0/16                  server01          192.168.200.1: eth0                 boot         Mon Dec  2 21:22:57 2024
true   default         192.168.200.0/24               server01          eth0                                kernel       Mon Dec  2 21:22:57 2024
false  default         192.168.200.1/32               server01          eth0                                dhcp         Mon Dec  2 21:22:57 2024
true   default         192.168.200.31/32              server01          eth0                                kernel       Mon Dec  2 21:22:57 2024