show

netq show adaptive-routing config

显示正在运行自适应路由和 RoCE 设置的交换机列表。此命令的第二种形式显示自适应路由是否在接口级别运行。

语法

netq [<hostname>] show adaptive-routing config global 
    [between <text-time> and <text-endtime>] 
    [around <text-time>]
    [json]
netq [<hostname>] show adaptive-routing config interface 
    [<text-ifname>] 
    [between <text-time> and <text-endtime>] 
    [around <text-time>] 
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
NA<text-ifname>仅显示此名称的接口的结果
between<text-time> 和 <text-endtime>仅显示在这些时间拍摄的快照之间的结果
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括
  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

cumulus@switch:~$ netq show adaptive-routing config global

Matching arconfig records:
Hostname          Is AR   Is RoCE  RoCE Mode Last Updated
                  Enabled Enabled
----------------- ------- -------- --------- --------------------------
torc-11           False   True     Lossy     Wed Oct 25 13:11:23 2023
torc-12           True    True     Lossless  Tue Oct 24 15:32:33 2023
cumulus@switch:~$ netq show adaptive-routing config interface

Matching arconfig records:
Hostname          Interface Is AR   Link Util  Link Util  Last Updated
                            Enabled Threshold  Threshold
                                    Disabled
----------------- --------- ------- ---------- ---------- --------------------------
torc-11           swp1      True    True       70         Tue Oct 24 15:32:33 2023
torc-11           swp2      False   True       60         Wed Oct 25 13:07:21 2023
torc-12           swp2      True    True       70         Tue Oct 24 15:32:33 2023
torc-12           swp1      True    True       70         Tue Oct 24 15:32:33 2023


netq show address-history

显示 IPv4 或 IPv6 地址在过去 24 小时内在您的网络结构中存在的位置。输出显示

  • 地址上次更改的时间
  • 地址所在的交换机或主机名
  • 地址所在的接口
  • 地址前缀和掩码
  • 关联的 VRF

默认情况下,输出中的每一行都是按 VLAN 排序的线程(或组)。

语法

netq [<hostname>] show address-history
    <text-prefix>
    [ifname <text-ifname>]
    [vrf <text-vrf>]
    [diff]
    [between <text-time> and <text-endtime>]
    [listby <text-list-by>]
    [json]

必需参数

参数描述
NA<text-prefix>显示具有此前缀的交换机和主机的结果

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
ifname<text-ifname>仅显示此名称的接口的结果
vrf<text-vrf>仅显示此名称的 VRF 的结果
diffNA仅显示与每次更改关联的差异
between<text-time> 和 <text-endtime>仅显示在这些时间拍摄的快照之间的结果
listby<text-list-by>按指定的属性显示结果。属性包括接口名称、VRF 名称和主机名。
jsonNA以 JSON 格式显示输出

当使用 between 选项输入时间值时,您必须包含数值度量单位

  • d: 天
  • h: 小时
  • m: 分钟
  • s: 秒
  • now
您可以输入开始时间 (text-time) 和结束时间 (text-endtime) 值,最近的时间在前,最旧的时间在后,反之亦然。这些值不必具有相同的度量单位。

用法示例

显示过去 24 小时的地址历史记录

cumulus@switch:~$ netq show address-history 10.10.10.3
Matching addresshistory records:
Last Changed              Hostname          Ifname       Prefix                         Mask     Vrf
------------------------- ----------------- ------------ ------------------------------ -------- ---------------
Mon Nov 23 22:28:42 2020  leaf03            lo           10.10.10.3                     32       default

以下示例显示 IP 地址的完整更改时间顺序。插入符号 (^) 表示前一行中的值未更改。

cumulus@switch:~$ netq show address-history 10.1.10.2/24

Matching addresshistory records:
Last Changed              Hostname          Ifname       Prefix                         Mask     Vrf
------------------------- ----------------- ------------ ------------------------------ -------- ---------------
Tue Sep 29 15:35:21 2020  leaf03            vlan10       10.1.10.2                      24       RED
Tue Sep 29 15:35:24 2020  leaf01            vlan10       10.1.10.2                      24       RED
Tue Sep 29 17:24:59 2020  leaf03            vlan10       10.1.10.2                      24       RED
Tue Sep 29 17:24:59 2020  leaf01            vlan10       10.1.10.2                      24       RED
Tue Sep 29 17:25:05 2020  leaf03            vlan10       10.1.10.2                      24       RED
Tue Sep 29 17:25:05 2020  leaf01            vlan10       10.1.10.2                      24       RED
Tue Sep 29 17:25:07 2020  leaf03            vlan10       10.1.10.2                      24       RED
Tue Sep 29 17:25:08 2020  leaf01            vlan10       10.1.10.2                      24       RED

按 VRF 分组显示更改

cumulus@switch:~$ netq show address-history 10.1.10.104 listby vrf
Matching addresshistory records:
Last Changed              Hostname          Ifname       Prefix                         Mask     Vrf
------------------------- ----------------- ------------ ------------------------------ -------- ---------------
Tue Nov 24 19:51:11 2020  server04          uplink       10.1.10.104                    24       default

以下示例显示从现在到两小时前的 IP 地址的历史记录。插入符号 (^) 表示前一行中的值未更改。

cumulus@switch:~$ netq show address-history 10.1.10.2/24 between 2h and now

Matching addresshistory records:
Last Changed              Hostname          Ifname       Prefix                         Mask     Vrf
------------------------- ----------------- ------------ ------------------------------ -------- ---------------
Tue Sep 29 15:35:21 2020  leaf03            vlan10       10.1.10.2                      24       RED
Tue Sep 29 15:35:24 2020  leaf01            vlan10       10.1.10.2                      24       RED
Tue Sep 29 17:24:59 2020  leaf03            vlan10       10.1.10.2                      24       RED
Tue Sep 29 17:24:59 2020  leaf01            vlan10       10.1.10.2                      24       RED
Tue Sep 29 17:25:05 2020  leaf03            vlan10       10.1.10.2                      24       RED
Tue Sep 29 17:25:05 2020  leaf01            vlan10       10.1.10.2                      24       RED
Tue Sep 29 17:25:07 2020  leaf03            vlan10       10.1.10.2                      24       RED
Tue Sep 29 17:25:08 2020  leaf01            vlan10       10.1.10.2                      24       RED
  • netq show mac-history

netq show agents

显示在您的网络结构中运行 NetQ Agent 的所有节点或特定节点的基本配置、运行状况和连接状态。此命令为您提供了一种简便的方法来查看是否有任何 NetQ Agent 或其节点断电、是否难以与遥测服务器通信,或者 Agent 是否正在运行不同的软件版本。

输出显示

  • 每个节点最近是否已通信(最近 120 秒)
  • 每个节点是否与 NetQ 设备或虚拟机时间同步
  • 节点上当前运行的 NetQ Agent 软件版本
  • 节点已运行多长时间
  • NetQ Agent 已运行多长时间
  • NetQ Agent 上次重新初始化的时间
  • 上述任何项目上次发生更改的时间

语法

netq [<hostname>] show agents
    [fresh | dead | rotten | opta]
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>过滤输出以查看此名称的交换机或主机的状态
freshNA过滤输出以查找 NetQ Agent 与设备或 VM 正常通信的设备
deadNA过滤输出以查找用户已停用 NetQ Agent 的设备
rottenNA过滤输出以查找 NetQ Agent 在过去两分钟内未与设备或 VM 通信的设备
optaNA过滤输出以查找安装在设备或 VM 上的 NetQ Agent
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括
  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示所有网络节点上的 Agent 状态

cumulus@switch:~$ netq show agents
Matching agents records:
Hostname          Status           NTP Sync Version                              Sys Uptime                Agent Uptime              Reinitialize Time          Last Changed
----------------- ---------------- -------- ------------------------------------ ------------------------- ------------------------- -------------------------- -------------------------
exit-1            Fresh            yes      4.12.0-cl4u48~1719858419.3db6af0a5   Mon Jul  1 19:29:33 2024  Mon Jul  1 20:11:31 2024  Mon Jul  8 18:33:15 2024   Tue Jul  9 15:13:14 2024
exit-2            Fresh            yes      4.12.0-cl4u48~1719858419.3db6af0a5   Mon Jul  1 19:29:34 2024  Mon Jul  1 20:11:52 2024  Mon Jul  8 18:33:12 2024   Tue Jul  9 15:13:17 2024
firewall-1        Fresh            yes      4.12.0-cl4u48~1719858419.3db6af0a5   Mon Jul  1 19:29:32 2024  Mon Jul  1 20:12:13 2024  Mon Jul  8 18:33:07 2024   Tue Jul  9 15:13:02 2024
firewall-2        Fresh            yes      4.12.0-cl4u48~1719858419.3db6af0a5   Mon Jul  1 19:29:32 2024  Mon Jul  1 20:12:42 2024  Mon Jul  8 18:33:13 2024   Tue Jul  9 15:13:05 2024
hostd-11          Fresh            yes      4.12.0-ub18.04u48~1719859179.3db6af0 Mon Jul  1 20:01:50 2024  Mon Jul  1 20:12:59 2024  Mon Jul  8 18:33:15 2024   Tue Jul  9 15:13:02 2024
hostd-21          Fresh            yes      4.12.0-ub18.04u48~1719859179.3db6af0 Mon Jul  1 20:02:50 2024  Mon Jul  1 20:13:15 2024  Mon Jul  8 18:32:52 2024   Tue Jul  9 15:13:11 2024
hosts-11          Fresh            yes      4.12.0-ub18.04u48~1719859179.3db6af0 Mon Jul  1 20:03:47 2024  Mon Jul  1 20:13:31 2024  Mon Jul  8 18:33:16 2024   Tue Jul  9 15:13:21 2024
hosts-13          Fresh            yes      4.12.0-ub18.04u48~1719859179.3db6af0 Mon Jul  1 20:04:48 2024  Mon Jul  1 20:13:46 2024  Mon Jul  8 18:33:18 2024   Tue Jul  9 15:13:08 2024
hosts-21          Fresh            yes      4.12.0-ub18.04u48~1719859179.3db6af0 Mon Jul  1 20:05:54 2024  Mon Jul  1 20:13:59 2024  Mon Jul  8 18:33:21 2024   Tue Jul  9 15:13:20 2024
...

显示处于腐烂状态的所有设备

cumulus@switch:~$ netq show agents rotten
Matching agents records:
Hostname          Status           NTP Sync Version                              Sys Uptime                Agent Uptime              Reinitialize Time          Last Changed
----------------- ---------------- -------- ------------------------------------ ------------------------- ------------------------- -------------------------- -------------------------
fw1               Rotten           no       3.2.0-cl4u30~1601403318.104fb9ed     Fri Oct  2 20:36:33 2020  Mon Nov  2 19:49:21 2020  Mon Nov  2 19:49:21 2020   Fri Nov 20 18:48:53 2020
fw2               Rotten           no       3.2.0-cl4u30~1601403318.104fb9ed     Fri Oct  2 20:36:32 2020  Mon
  • netq show unit-tests agent
  • netq show events
  • netq check agents
  • netq config add agent
  • netq config del agent

netq show bgp

显示当前或过去一段时间内,您的网络结构中所有节点或特定节点上所有 BGP 会话或单个会话的运行状况。输出提供

  • 给定节点的邻居节点
  • 该节点和邻居使用的路由表 (VRF)
  • 分配给节点的自治系统编号 (ASN)
  • 每个邻居节点的对等 ASN
  • 会话建立时接收到的 IPv4/IPv6/EVPN 地址前缀
  • 上述任何项目上次发生更改的时间

如果您有节点实施虚拟路由和转发 (VRF),则可以根据相关的路由表请求状态。VRF 通常在多租户部署中配置,以为每个租户维护单独的域。

语法

netq [<hostname>] show bgp
    [<bgp-session>|asn <number-asn>]
    [vrf <vrf>]
    [established|failed]
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
NA<bgp-session>仅显示此特定 BGP 会话的结果(例如,5468354)
asn<number-asn>仅显示使用此 ASN 的节点的结果(例如,65013)
vrf<vrf>仅显示在此 VRF 上运行的会话的结果(例如,default、mgmt 或 vrf10)
establishedNA仅显示已建立的 BGP 会话
failedNA仅显示失败的 BGP 会话
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示所有网络节点上的 BGP 会话。此示例显示每个节点、其邻居、VRF、ASN、对等 ASN、接收地址 IPv4/IPv6/EVPN 前缀以及上次更改的时间。

cumulus@switch:~$ netq show bgp
Matching bgp records:
Hostname          Neighbor                     VRF             ASN        Peer ASN   PfxRx        Last Changed
----------------- ---------------------------- --------------- ---------- ---------- ------------ -------------------------
border01          swp51(spine01)               default         65132      65199      7/-/74       Fri Oct  2 22:39:00 2020
border01          peerlink.4094(border02)      default         65132      65132      12/-/-       Fri Oct  2 22:39:00 2020
border01          swp54(spine04)               default         65132      65199      7/-/74       Fri Oct  2 22:39:00 2020
border01          swp53(spine03)               default         65132      65199      7/-/74       Fri Oct  2 22:39:00 2020
border01          swp52(spine02)               default         65132      65199      7/-/74       Fri Oct  2 22:39:00 2020
border02          swp52(spine02)               default         65132      65199      7/-/75       Fri Oct  2 22:39:00 2020
border02          peerlink.4094(border01)      default         65132      65132      12/-/-       Fri Oct  2 22:39:00 2020
border02          swp54(spine04)               default         65132      65199      7/-/75       Fri Oct  2 22:39:00 2020
border02          swp53(spine03)               default         65132      65199      7/-/75       Fri Oct  2 22:39:00 2020
border02          swp51(spine01)               default         65132      65199      7/-/75       Fri Oct  2 22:39:00 2020
leaf01            peerlink.4094(leaf02)        default         65101      65101      12/-/-       Fri Oct  2 22:39:00 2020
leaf01            swp54(spine04)               default         65101      65199      7/-/37       Fri Oct  2 22:39:00 2020
leaf01            swp53(spine03)               default         65101      65199      7/-/37       Fri Oct  2 22:39:00 2020
leaf01            swp52(spine02)               default         65101      65199      7/-/37       Fri Oct  2 22:39:00 2020
...

查看运行具有给定 ASN 的 BGP 的节点的状态

cumulus@switch:~$ netq show bgp asn 65101
Matching bgp records:
Hostname          Neighbor                     VRF             ASN        Peer ASN   PfxRx        Last Changed
----------------- ---------------------------- --------------- ---------- ---------- ------------ -------------------------
leaf01            peerlink.4094(leaf02)        default         65101      65101      12/-/-       Fri Oct  2 22:39:00 2020
leaf01            swp54(spine04)               default         65101      65199      7/-/37       Fri Oct  2 22:39:00 2020
leaf01            swp53(spine03)               default         65101      65199      7/-/37       Fri Oct  2 22:39:00 2020
leaf01            swp52(spine02)               default         65101      65199      7/-/37       Fri Oct  2 22:39:00 2020
leaf01            swp51(spine01)               default         65101      65199      7/-/37       Fri Oct  2 22:39:00 2020
leaf02            swp53(spine03)               default         65101      65199      7/-/36       Fri Oct  2 22:39:00 2020
leaf02            swp52(spine02)               default         65101      65199      7/-/36       Fri Oct  2 22:39:00 2020
leaf02            peerlink.4094(leaf01)        default         65101      65101      12/-/-       Fri Oct  2 22:39:00 2020
leaf02            swp54(spine04)               default         65101      65199      7/-/36       Fri Oct  2 22:39:00 2020
leaf02            swp51(spine01)               default         65101      65199      7/-/36       Fri Oct  2 22:39:00 2020
  • netq show unit-tests bgp
  • netq show events
  • netq check bgp

netq show check-filter

显示当前应用于 netq check 命令的过滤器。有关抑制与 netq check 命令关联的测试的更多信息,请参阅验证检查

使用此命令显示检查过滤器 ID,添加过滤器到 netq check 命令时必须指定该 ID。

语法

netq show check-filter 
    [check_filter_id <text-check-filter-id>|check_name <text-check-name-anchor>] 
    [show-check-catalog | check_name <text-check-name-anchor> show-check-catalog | check_name <text-check-name-anchor> show-reason-catalog ] 
    [json] 

必需参数

选项

选项描述
check_filter_id<text-check-filter-id>仅显示具有给定 ID 的过滤器
check_name<text-check-name-anchor>仅显示给定验证测试的过滤器(例如,EVPN、BGP 等)
show-check-catalogNA显示检查类型的条件
show-reason-catalogNA显示与验证测试错误和警告关联的解释
jsonNA以 JSON 格式显示输出

用法示例

cumulus@switch:~$ netq show check-filter
Matching config_check records:
Check Filter ID      Check Name           Test Name            Scope                                                        Active Suppress Until
-------------------- -------------------- -------------------- ------------------------------------------------------------ ------ --------------------
roce_3               roce                 RoCE Classification  [{"Reason":"Invalid traffic-class mapping for switch-priority 4.Expected 0 Got 3"}]          
True   Sun May  4 09:20:54 2025   
  • netq add check-filter
  • netq check
  • netq del check-filter

netq show cl-btrfs-info

显示在给定设备或网络范围内所有已安装 BTRFS 和 Cumulus Linux 3.x 的设备上有关磁盘利用率的状态。输出提供每个设备的以下信息

  • 当前分配的磁盘百分比
  • 剩余空间量(未分配)
  • 最大数据块的大小
  • 数据块未使用的空间量
  • 磁盘是否需要重新平衡
  • 上述任何项目上次发生更改的时间

有关何时执行建议的重新平衡的详细信息,请参阅何时重新平衡 BTRFS 分区

语法

netq [<hostname>] show cl-btrfs-info
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
around<text-time>

指示磁盘利用率信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示磁盘利用率信息

cumulus@switch:~$ netq show cl-btrfs-info
Matching btrfs_info records:
Hostname          Device Allocated     Unallocated Space    Largest Chunk Size   Unused Data Chunks S Rebalance Recommende Last Changed
                                                                                 pace                 d
----------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------------
leaf01            37.79 %              3.58 GB              588.5 MB             771.91 MB            yes                  Wed Sep 16 21:25:17 2020

查找建议重新平衡列。如果该列中的值显示为,则强烈建议您重新平衡 BTRFS 分区。如果显示为,则您可以查看输出中的其他值,以确定您是否接近需要重新平衡,并在稍后返回查看此数据。

  • netq show cl-ssd-util

netq show cl-manifest

显示给定设备或网络范围内所有设备支持的 Cumulus Linux OS 版本。输出提供每个设备的以下信息

  • 操作系统支持的 ASIC 供应商
  • 操作系统支持的 CPU 架构
  • 与指示的 ASIC 和 CPU 关联的 Cumulus Linux 版本

    运行 Cumulus Linux 4.4.5 及更早版本的交换机支持此命令。

语法

netq [<hostname>] show cl-manifest
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
jsonNA以 JSON 格式显示输出

用法示例

cumulus@switch:~$ netq show cl-manifest

Matching manifest records:
Hostname          ASIC Vendor          CPU Arch             Manifest Version
----------------- -------------------- -------------------- --------------------
border01          vx                   x86_64               3.7.6.1
border01          vx                   x86_64               3.7.10
border01          vx                   x86_64               3.7.11
border01          vx                   x86_64               3.6.2.1
...
fw1               vx                   x86_64               3.7.6.1
fw1               vx                   x86_64               3.7.10
fw1               vx                   x86_64               3.7.11
fw1               vx                   x86_64               3.6.2.1
...
leaf01            vx                   x86_64               4.1.0
leaf01            vx                   x86_64               4.0.0
leaf01            vx                   x86_64               3.6.2
leaf01            vx                   x86_64               3.7.2
...
leaf02            vx                   x86_64               3.7.6.1
leaf02            vx                   x86_64               3.7.10
leaf02            vx                   x86_64               3.7.11
leaf02            vx                   x86_64               3.6.2.1
...
  • netq show recommended-pkg-version

netq show cl-resource

显示给定设备或网络范围内所有设备使用的传入和传出 ACL 以及转发资源量。输出提供每个设备的以下信息

  • 对于 ACL 资源
    • 入口和出口 IPv4/IPv6 过滤器和 mangle 的计数和百分比
    • 入口 802.1x 过滤器的计数和百分比
    • 入口镜像的计数和百分比
    • 区域的计数和百分比
    • 入口 PBR IPv4/IPv6 过滤器的计数和百分比
    • 18b、32b 和 52b 规则键的计数和百分比
    • 第 4 层端口范围检查器的计数和百分比
    • 上述任何项目上次发生更改的时间
  • 对于转发资源
    • MAC 地址条目的计数和百分比
    • ECMP 下一跳的计数和百分比
    • IPv4/IPv6 主机和路由条目的计数和百分比
    • 多播路由的数量
    • 上述任何项目上次发生更改的时间

语法

此命令有两种形式

netq [<hostname>] show cl-resource acl
    [ingress | egress]
    [around <text-time>]
    [json]

netq [<hostname>] show cl-resource forwarding
    [around <text-time>]
    [json]

必需参数

参数描述
aclNA显示 ACL 的结果
forwardingNA显示转发资源的结果

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
ingressNA仅显示传入 ACL 的结果
egressNA仅显示传出 ACL 的结果
around<text-time>

指示磁盘利用率信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示所有已配置交换机的 ACL 资源

cumulus@switch:~$ netq show cl-resource acl
Matching cl_resource records:
Hostname          In IPv4 filter       In IPv4 Mangle       In IPv6 filter       In IPv6 Mangle       In 8021x filter      In Mirror            In PBR IPv4 filter   In PBR IPv6 filter   Eg IPv4 filter       Eg IPv4 Mangle       Eg IPv6 filter       Eg IPv6 Mangle       ACL Regions          18B Rules Key        32B Rules Key        54B Rules Key        L4 Port range Checke Last Updated
                                                                                                                                                                                                                                                                                                                                                                  rs
----------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- ------------------------
act-5712-09       40,512(7%)           0,0(0%)              30,768(3%)           0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              32,256(12%)          0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              2,24(8%)             Tue Aug 18 20:20:39 2020
mlx-2700-04       0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              0,0(0%)              4,400(1%)            2,2256(0%)           0,1024(0%)           2,1024(0%)           0,0(0%)              Tue Aug 18 20:19:08 2020

显示所有已配置交换机的转发资源

cumulus@noc-pr:~$ netq show cl-resource forwarding
Matching cl_resource records:
Hostname          IPv4 host entries    IPv6 host entries    IPv4 route entries   IPv6 route entries   ECMP nexthops        MAC entries          Total Mcast Routes   Last Updated
----------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- ------------------------
act-5712-09       0,16384(0%)          0,0(0%)              0,131072(0%)         23,20480(0%)         0,16330(0%)          0,32768(0%)          0,8192(0%)           Tue Aug 18 20:20:39 2020
mlx-2700-04       0,32768(0%)          0,16384(0%)          0,65536(0%)          4,28672(0%)          0,4101(0%)           0,40960(0%)          0,1000(0%)           Tue Aug 18 20:19:08 2020

显示 spine02 交换机使用的转发资源

cumulus@switch:~$ netq spine02 show cl-resource forwarding
Matching cl_resource records:
Hostname          IPv4 host entries    IPv6 host entries    IPv4 route entries   IPv6 route entries   ECMP nexthops        MAC entries          Total Mcast Routes   Last Updated
----------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- ------------------------
spine02           9,16384(0%)          0,0(0%)              290,131072(0%)       173,20480(0%)        54,16330(0%)         26,32768(0%)         0,8192(0%)           Mon Jan 13 03:34:11 2020
  • netq show recommended-pkg-version
  • netq show cl-manifest

netq show cl-ssd-util

显示给定设备或网络范围内所有设备的 3ME3 固态驱动器 (SSD) 的利用率。这些主要在本地部署中找到。随着时间的推移跟踪 SSD 利用率使您能够在收到事件通知之前看到驱动器的任何下降趋势或不稳定性。输出提供每个驱动器的以下信息

  • 驱动器剩余的 PE 周期百分比
  • 此驱动器当前使用的 PE 周期计数
  • 此驱动器支持的 PE 周期总数
  • 驱动器型号信息
  • 上述任何项目上次发生更改的时间

语法

netq [<hostname>] show cl-ssd-util
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
around<text-time>

指示磁盘利用率信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

cumulus@switch:~$ netq spine02 show cl-ssd-util
Hostname        Remaining PE Cycle (%)  Current PE Cycles executed      Total PE Cycles supported       SSD Model               Last Changed
spine02         80                      576                             2880                            M.2 (S42) 3ME3          Thu Oct 31 00:15:06 2019
  • netq show cl-btrfs-info

netq show dom

显示给定设备上任何数字光模块 (DOM) 的性能下降或完全中断。此命令有多种形式:一种用于激光功率和电流,一种用于温度和电压,两种用于误码率 (BER)。

误码率命令只能在运行 Cumulus Linux 5.4.0 或更高版本的 Spectrum 交换机上运行。

语法

netq [<hostname>] show dom type (laser_rx_power|laser_output_power|laser_bias_current)
    [interface <text-dom-port-anchor>]
    [channel_id <text-channel-id>]
    [around <text-time>]
    [json]

netq [<hostname>] show dom type (module_temp|module_voltage)
    [interface <text-dom-port-anchor>]
    [around <text-time>]
    [json]

netq <hostname> show dom ber 
    [json]

netq <hostname> show dom ber device
    [json]

必需参数

参数描述
laser_rx_powerNA显示收发器输入功率 (mW) 在 DOM 上的当前值和阈值事件
laser_output_powerNA显示激光输出功率 (mW) 在 DOM 上的当前值和阈值事件
laser_bias_currentNA显示激光偏置电流 (mA) 在 DOM 上的当前值和阈值事件
module_tempNA显示 DOM 上的温度 (°C) 的当前值和阈值事件
module_voltageNA显示收发器电压 (V) 在 DOM 上的当前值和阈值事件

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
interface<text-dom-port-anchor>仅显示此端口名称的接口的结果
channel_id<text-channel-id>仅显示此 ID 通道的激光结果
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示给定设备上 DOM 的模块温度

cumulus@switch:~$ netq spine01 show dom type module_temp
Matching dom records:
Hostname          Interface  type                 high_alarm_threshold low_alarm_threshold  high_warning_thresho low_warning_threshol value                Last Updated
                                                                                            ld                   d
----------------- ---------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- ------------------------
spine01           swp53s0    module_temperature   {‘degree_c’: 85,     {‘degree_c’: -10,    {‘degree_c’: 70,     {‘degree_c’: 0,      {‘degree_c’: 32,     Wed Jul  1 15:25:56 2020
                                                  ‘degree_f’: 185}     ‘degree_f’: 14}      ‘degree_f’: 158}     ‘degree_f’: 32}      ‘degree_f’: 89.6}
spine01           swp35      module_temperature   {‘degree_c’: 75,     {‘degree_c’: -5,     {‘degree_c’: 70,     {‘degree_c’: 0,      {‘degree_c’: 27.82,  Wed Jul  1 15:25:56 2020
                                                  ‘degree_f’: 167}     ‘degree_f’: 23}      ‘degree_f’: 158}     ‘degree_f’: 32}      ‘degree_f’: 82.08}
spine01           swp55      module_temperature   {‘degree_c’: 75,     {‘degree_c’: -5,     {‘degree_c’: 70,     {‘degree_c’: 0,      {‘degree_c’: 26.29,  Wed Jul  1 15:25:56 2020
                                                  ‘degree_f’: 167}     ‘degree_f’: 23}      ‘degree_f’: 158}     ‘degree_f’: 32}      ‘degree_f’: 79.32}
spine01           swp9       module_temperature   {‘degree_c’: 78,     {‘degree_c’: -13,    {‘degree_c’: 73,     {‘degree_c’: -8,     {‘degree_c’: 25.57,  Wed Jul  1 15:25:56 2020
                                                  ‘degree_f’: 172.4}   ‘degree_f’: 8.6}     ‘degree_f’: 163.4}   ‘degree_f’: 17.6}    ‘degree_f’: 78.02}
spine01           swp56      module_temperature   {‘degree_c’: 78,     {‘degree_c’: -10,    {‘degree_c’: 75,     {‘degree_c’: -5,     {‘degree_c’: 29.43,  Wed Jul  1 15:25:56 2020
                                                  ‘degree_f’: 172.4}   ‘degree_f’: 14}      ‘degree_f’: 167}     ‘degree_f’: 23}      ‘degree_f’: 84.97}
spine01           swp53s2    module_temperature   {‘degree_c’: 85,     {‘degree_c’: -10,    {‘degree_c’: 70,     {‘degree_c’: 0,      {‘degree_c’: 32,     Wed Jul  1 15:25:55 2020
                                                  ‘degree_f’: 185}     ‘degree_f’: 14}      ‘degree_f’: 158}     ‘degree_f’: 32}      ‘degree_f’: 89.6}
...

显示给定设备上所有接口的误码率。如果此命令的输出显示为灰色,则表示 NetQ Agent 处于腐烂状态。

cumulus@switch:~$ netq spine01 show dom ber

ifname  speed raw ber   eff. ber  symbol err. active fec fc0 hist  ethernet phy mgr. advanced status timestamp
        gb/s                                                       protocol state    opcode
                                                                   active
------- ----- --------- --------- ----------- ---------- --------- -------- -------- --------------- ---------------
swp1    400   6e-08     1.5e-254  0           Standard_R 5         400G     Active   0               Tue Jul  9 16:1
                                              S-FEC - (5                                             8:27 2024
                                              44_514)
swp7    200   1.5e-254  1.5e-254  0           Standard_R N/A       200G     Active   0               Tue Jul  9 16:1
                                              S-FEC - (5                                             8:27 2024
                                              44_514)
swp8    200   1.5e-254  1.5e-254  0           Standard_R N/A       200G     Active   0               Tue Jul  9 16:1
                                              S-FEC - (5                                             8:27 2024
                                              44_514)
swp9    200   1.5e-254  1.5e-254  0           Standard_R N/A       200G     Active   0               Tue Jul  9 16:1
                                              S-FEC - (5                                             8:27 2024
                                              44_514)
swp10   200   1.5e-254  1.5e-254  0           Standard_R N/A       200G     Active   0               Tue Jul  9 16:1
                                              S-FEC - (5                                             8:27 2024
                                              44_514)
swp11   200   1.5e-254  1.5e-254  0           Standard_R N/A       200G     Active   0               Tue Jul  9 16:1
                                              S-FEC - (5                                             8:27 2024
                                              44_514)
swp12   200   1.5e-254  1.5e-254  0           Standard_R N/A       200G     Active   0               Tue Jul  9 16:1
                                              S-FEC - (5                                             8:27 2024
                                              44_514)
swp13   25    1.5e-254  1.5e-254  0           No FEC     N/A       25G      Active   0               Tue Jul  9 16:1
                                                                                                     8:27 2024
swp14   100   1.5e-254  1.5e-254  0           Standard_R N/A       100G     Active   0               Tue Jul  9 16:1
                                              S-FEC - (5                                             8:27 2024
cumulus@switch:~$ netq spine01 show dom ber device
ifname  module type            cable len module sn module pn   module tmp        time last  device id                      device fw ver.  timestamp
                               .(m)                                              clear(min)
------- ---------------------- --------- --------- ----------- ----------------- ---------- ------------------------------ --------------- ---------------
swp1    Optical Module (separa 0         MT2234JT0 MMS1V00-WM  49                299.3      663e9bebb78a3a66f1d5560350351d 34.2014.960     Tue Jul  9 16:4
        ted)                             0061                                               2de8300b4a0264bea2541d6c68c1f9                 9:13 2024
                                                                                            bec0
swp7    Passive copper cable   1         MT1926VS0 MCP1650-H00 0                 298.5      663e9bebb78a3a66f1d5560350351d 34.2014.960     Tue Jul  9 16:4
                                         5127      AE30                                     2de8300b4a0264bea2541d6c68c1f9                 9:13 2024
                                                                                            bec0
swp8    Passive copper cable   2         MT1927VS0 MCP1650-V00 0                 298.5      663e9bebb78a3a66f1d5560350351d 34.2014.960     Tue Jul  9 16:4
                                         1221      2E26                                     2de8300b4a0264bea2541d6c68c1f9                 9:13 2024
                                                                                            bec0
swp9    Passive copper cable   2         MT2047VS0 MCP1650-H00 0                 298.5      663e9bebb78a3a66f1d5560350351d 34.2014.960     Tue Jul  9 16:4
                                         5432      2E26                                     2de8300b4a0264bea2541d6c68c1f9                 9:13 2024
                                                                                            bec0
swp10   Passive copper cable   2         MT2047VS0 MCP1650-H00 0                 298.5      663e9bebb78a3a66f1d5560350351d 34.2014.960     Tue Jul  9 16:4
                                         4393      2E26                                     2de8300b4a0264bea2541d6c68c1f9                 9:13 2024
                                                                                            bec0
swp11   Passive copper cable   2         MT2236VB8 MCP1650-V00 0                 298.5      663e9bebb78a3a66f1d5560350351d 34.2014.960     Tue Jul  9 16:4
                                         2266      2E26                                     2de8300b4a0264bea2541d6c68c1f9                 9:13 2024
                                                                                            bec0
swp12   Passive copper cable   2         MT1927VS0 MCP1650-V00 0                 298.5      663e9bebb78a3a66f1d5560350351d 34.2014.960     Tue Jul  9 16:4
                                         1325      2E26                                     2de8300b4a0264bea2541d6c68c1f9                 9:13 2024
                                                                                            bec0
swp13   Passive copper cable   3         MT2047VS0 MCP1650-V00 0                 1585.8     663e9bebb78a3a66f1d5560350351d 34.2014.960     Tue Jul  9 16:4
                                         3757      3E26                                     2de8300b4a0264bea2541d6c68c1f9                 9:13 2024
                                                                                            bec0
swp14   Passive copper cable   3         MT2047VS0 MCP1650-V00 0                 1585.7     663e9bebb78a3a66f1d5560350351d 34.2014.960     Tue Jul  9 16:4


netq show ecmp

显示等价多路径 (ECMP) 路由数据。

语法

netq [<hostname>] show ecmp
    [group-id <text-group-id>]
    [between <text-time> and <text-endtime>]
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
group-id<text-group-id>仅显示具有此 ID 的 ECMP 组的结果
between<text-time> 和 <text-endtime>

仅显示这两个时间之间的结果。时间必须包含数值度量单位

  • w: 周
  • d: 天
  • h: 小时
  • m: 分钟
  • s: 秒
  • now

您可以输入开始时间 (text-time) 和结束时间 (text-endtime) 值,最近的时间在前,最旧的时间在后,反之亦然。这些值不必具有相同的度量单位。

around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

cumulus@switch:~$ netq show ecmp
Matching ecmp_info records:
Hostname          Group Id Imbalance Agg. Traffic Paths                     Start Time                 End Time
----------------- -------- --------- ------------ ------------------------- -------------------------- --------------------------
nvidia-cl-test-l1 42       0 %       0 b/s        port: swp43s0: (index:108 Wed Feb 28 02:54:00 2024   Wed Feb 28 02:57:00 2024
                                                  , hal-port:32) - 0 b/s,
                                                  port: swp43s1: (index:109
                                                  , hal-port:34) - 0 b/s,
                                                  port: swp44s0: (index:110
                                                  , hal-port:36) - 0 b/s,
                                                  port: swp44s1: (index:111
                                                  , hal-port:38) - 0 b/s,
                                                  port: swp42s0: (index:106
                                                  , hal-port:40) - 0 b/s,
                                                  port: swp42s1: (index:107
                                                  , hal-port:42) - 0 b/s,
                                                  port: swp41s0: (index:104
                                                  , hal-port:44) - 0 b/s,
                                                  port: swp41s1: (index:105
                                                  , hal-port:46) - 0 b/s,
                                                  port: swp47s0: (index:116
                                                  , hal-port:48) - 0 b/s,
                                                  port: swp47s1: (index:117
                                                  , hal-port:50) - 0 b/s,
                                                  port: swp48s0: (index:118
                                                  , hal-port:52) - 0 b/s,
                                                  port: swp48s1: (index:119
                                                  , hal-port:54) - 0 b/s,
                                                  port: swp46s0: (index:114
                                                  , hal-port:56) - 0 b/s,
                                                  port: swp46s1: (index:115
                                                  , hal-port:58) - 0 b/s,
                                                  port: swp45s0: (index:112
                                                  , hal-port:60) - 0 b/s,
                                                  port: swp45s1: (index:113
                                                  , hal-port:62) - 0 b/s
nvidia-cl-test-l1 42       0 %       0 b/s        port: swp43s0: (index:108 Wed Feb 28 02:51:00 2024   Wed Feb 28 02:54:00 2024
                                                  , hal-port:32) - 0 b/s,
                                                  port: swp43s1: (index:109
                                                  , hal-port:34) - 0 b/s,
                                                  port: swp44s0: (index:110
                                                  , hal-port:36) - 0 b/s,
                                                  port: swp44s1: (index:111
                                                  , hal-port:38) - 0 b/s,
                                                  port: swp42s0: (index:106
                                                  , hal-port:40) - 0 b/s,
                                                  port: swp42s1: (index:107
                                                  , hal-port:42) - 0 b/s,
                                                  port: swp41s0: (index:104
                                                  , hal-port:44) - 0 b/s,
                                                  port: swp41s1: (index:105
                                                  , hal-port:46) - 0 b/s,
                                                  port: swp47s0: (index:116
                                                  , hal-port:48) - 0 b/s,
                                                  port: swp47s1: (index:117
                                                  , hal-port:50) - 0 b/s,
                                                  port: swp48s0: (index:118
                                                  , hal-port:52) - 0 b/s,
                                                  port: swp48s1: (index:119
                                                  , hal-port:54) - 0 b/s,
                                                  port: swp46s0: (index:114
                                                  , hal-port:56) - 0 b/s,
                                                  port: swp46s1: (index:115
                                                  , hal-port:58) - 0 b/s,
                                                  port: swp45s0: (index:112
                                                  , hal-port:60) - 0 b/s,
                                                  port: swp45s1: (index:113
                                                  , hal-port:62) - 0 b/s

  • netq show ecmp-hash-config

netq show ecmp-hash-config

显示等价多路径 (ECMP) 哈希配置。

语法

netq [<hostname>] show ecmp-hash-config 
    [fields]
    [around <text-time>] 
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
fieldsNA显示哈希字段视图
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

cumulus@switch:~$ netq show ecmp-hash-config 
Matching ecmp_hash records:
Hostname          Seed     Max Paths Resilient Hash Enable Resilient Hash Entries Symmetric Hash enable Last Updated
----------------- -------- --------- --------------------- ---------------------- --------------------- ------------------------
nvidia-cl-r1-s1   random   129       False                 64                     True                  Sun Feb 18 15:41:43 2024
nvidia-cl-r1-s2   random   129       False                 64                     True                  Sun Feb 11 16:37:13 2024
nvidia-cl-r1-s3   random   129       False                 64                     True                  Sun Feb 11 16:38:40 2024
nvidia-cl-r1-s4   random   129       False                 64                     True                  Tue Feb 20 20:49:49 2024
nvidia-cl-r2-s1   random   129       False                 64                     True                  Sun Feb 11 16:30:38 2024
nvidia-cl-r2-s2   random   129       False                 64                     True                  Thu Feb 15 05:46:03 2024
nvidia-cl-r2-s3   random   65        False                 64                     True                  Sun Feb 18 09:59:34 2024
nvidia-cl-r2-s4   random   129       False                 64                     True                  Tue Feb 20 07:10:39 2024
nvidia-cl-r3-s1   random   129       False                 64                     True                  Mon Feb 19 12:43:04 2024
nvidia-cl-r3-s2   random   129       False                 64                     True                  Sun Feb 11 16:30:38 2024
nvidia-cl-r3-s3   random   129       False                 64                     True                  Sun Feb 11 16:52:37 2024
nvidia-cl-r3-s4   random   129       False                 64                     True                  Sun Feb 11 17:11:14 2024
nvidia-cl-r4-s1   random   129       False                 64                     True                  Sun Feb 11 16:25:58 2024
nvidia-cl-r4-s2   random   65        False                 64                     True                  Mon Feb 19 09:40:51 2024
nvidia-cl-r4-s3   random   129       False                 64                     True                  Sun Feb 11 16:38:41 2024
nvidia-cl-r4-s4   random   129       False                 64                     True                  Sun Feb 11 16:25:57 2024
nvidia-cl-ssp1    random   129       False                 64                     True                  Sun Feb 11 17:37:49 2024
nvidia-cl-ssp2    random   65        False                 64                     True                  Mon Feb 19 09:41:06 2024
nvidia-cl-ssp3    random   129       False                 64                     True                  Sun Feb 11 16:38:45 2024
nvidia-cl-ssp4    random   129       False                 64                     True                  Thu Feb 15 15:21:50 2024
nvidia-cl-ssp5    random   129       False                 64                     True                  Tue Feb 20 12:53:29 2024
nvidia-cl-ssp6    random   129       False                 64                     True                  Sun Feb 11 18:07:59 2024
nvidia-cl-ssp7    random   129       False                 64                     True                  Sun Feb 11 17:10:05 2024
nvidia-cl-ssp8    random   129       False                 64                     True                  Sun Feb 11 17:48:49 2024
nvidia-cl-su2-l1  random   129       False                 64                     True                  Sun Feb 11 17:11:15 2024
nvidia-cl-su2-l2  random   129       False                 64                     True                  Sun Feb 11 16:38:13 2024
nvidia-cl-su2-l3  random   129       False                 64                     True                  Sun Feb 11 17:42:34 2024
nvidia-cl-su2-l4  random   129       False                 64                     True                  Sun Feb 11 17:05:59 2024
nvidia-cl-su3-l1  random   65        False                 64                     True                  Mon Feb 19 09:41:23 2024
nvidia-cl-su3-l2  random   129       False                 64                     True                  Sun Feb 11 16:30:37 2024
nvidia-cl-su3-l3  random   129       False                 64                     True                  Sun Feb 11 16:30:36 2024
nvidia-cl-su3-l4  random   129       False                 64                     True                  Sun Feb 11 16:41:50 2024
nvidia-cl-su4-l1  random   129       False                 64                     True                  Fri Feb 16 09:18:33 2024
nvidia-cl-su4-l2  random   129       False                 64                     True                  Sun Feb 11 16:25:57 2024
nvidia-cl-su4-l3  random   65        False                 64                     True                  Mon Feb 19 09:41:06 2024
nvidia-cl-su4-l4  random   129       False                 64                     True                  Sun Feb 11 17:14:05 2024
nvidia-cl-test-l1 random   89        False                 64                     True                  Wed Feb 28 01:27:08 2024
nvidia-cl-test-l2 random   89        False                 64                     True                  Wed Feb 28 01:26:39 2024
nvidia-cl-test-l3 random   89        False                 64                     True                  Wed Feb 28 01:27:18 2024
nvidia-cl-test-l4 random   89        False                 64                     True                  Wed Feb 28 01:26:50 2024
nvidia-cl-test-s1 random   97        False                 64                     True                  Tue Feb 27 22:34:36 2024
nvidia-cl-test-s2 random   97        False                 64                     True                  Wed Feb 28 01:58:56 2024
  • netq show ecmp

netq show ethtool-stats

显示一个或所有设备上网络接口的发送和接收统计信息,包括帧错误、ACL 丢弃、缓冲区丢弃等。您可以按设备过滤输出,并查看过去某个时间的统计信息。

语法

netq <hostname> show ethtool-stats
    port <physical-port>
    (rx|tx)
    [extended]
    [around <text-time>]
    [json]

必需参数

选项

参数描述
port<physical-port>仅显示此名称的接口的结果
rxNA仅显示接收统计信息
txNA仅显示发送统计信息

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
extendedNA显示其他统计信息;不包括使用标准输出显示的统计信息
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示网络中给定交换机接口和交换机的发送统计信息

cumulus@switch:~$ netq leaf01 show ethtool-stats port swp50 tx
Matching ethtool_stats records:
Hostname          Interface                 HwIfOutOctets        HwIfOutUcastPkts     HwIfOutMcastPkts     HwIfOutBcastPkts     HwIfOutDiscards      HwIfOutErrors        HwIfOutQDrops        HwIfOutNonQDrops     HwIfOutQLen          HwIfOutPausePkt      SoftOutErrors        SoftOutDrops         SoftOutTxFifoFull    Last Updated
----------------- ------------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- ------------------------
leaf01            swp50                     8749                 0                    44                   0                    0                    0                    0                    0                    0                    0                    0                    0                    0                    Tue Apr 28 22:09:57 2020
  • netq show interface-stats
  • netq show interface-untilization

netq show events

显示过去 24 小时内发生的系统事件。您可以按事件严重性和事件类型过滤输出。输出提供每个设备的以下信息

  • 消息类型
  • 事件严重性(信息、错误)
  • 描述性事件消息
  • 事件发生的时间

事件查询在过去 30 天内的 72 小时窗口内受支持。

语法

netq [<hostname>] show events
    [severity info | severity error]
    [message_type agent|bgp|btrfsinfo|cable|clsupport|configdiff|evpn|interfaces|lcm|link|lldp|mlag|mtu|node|ntp|port|ptp|resource|roceconfig|runningconfigdiff|sensor|services|ssdutil|tca_bgp|tca_dom|tca_ecmp|tca_ethtool|tca_hostd_roce|tca_link|tca_procdevstats|tca_resource|tca_roce|tca_sensors|tca_services|tca_wjh|topology|trace|vlan|vxlan]
    [between <text-time> and <text-endtime>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
severityinfo, error仅显示此严重性级别的事件
message_typeagent, bgp, btrfsinfo, cable, clsupport, configdiff, evpn, interfaces, lcm, link, lldp, mlag, mtu, node, ntp, port, ptp, resource, roceconfig, runningconfigdiff, sensor, services, ssdutil, tca_bgp, tca_dom, tca_ecmp, tca_ethtool, tca_hostd_roce, tca_link, tca_procdevstats, tca_resource, tca_roce, tca_sensors, tca_services, tca_wjh, topology, trace, vlan, vxlan显示此名称类型的事件
between<text-time> 和 <text-endtime>

仅显示这两个时间之间的结果。时间必须包含数值度量单位

  • w: 周
  • d: 天
  • h: 小时
  • m: 分钟
  • s: 秒
  • now

您可以输入开始时间 (text-time) 和结束时间 (text-endtime) 值,最近的时间在前,最旧的时间在后,反之亦然。这些值不必具有相同的度量单位。

jsonNA以 JSON 格式显示输出

用法示例

显示过去 3 天的所有事件

cumulus@switch:~$ netq show events between now and 3d
Matching events records:
Hostname          Message Type             Severity         Message                             Timestamp
----------------- ------------------------ ---------------- ----------------------------------- -------------------------
leaf02            evpn                     error            VNI 4002 state changed from up to d Thu Dec 10 22:00:36 2020
                                                            own
leaf02            evpn                     error            VNI 4001 state changed from up to d Thu Dec 10 22:00:36 2020
                                                            own
leaf02            evpn                     error            VNI 10 state changed from up to dow Thu Dec 10 22:00:36 2020
                                                            n
leaf02            evpn                     error            VNI 30 state changed from up to dow Thu Dec 10 22:00:36 2020
                                                            n
leaf02            evpn                     error            VNI 20 state changed from up to dow Thu Dec 10 22:00:36 2020
                                                            n
leaf02            evpn                     error            VNI 4002 state changed from up to d Thu Dec 10 20:42:39 2020
                                                            own
leaf02            evpn                     error            VNI 4001 state changed from up to d Thu Dec 10 20:42:39 2020
                                                            own
...
border02          evpn                     error            VNI 4002 state changed from up to d Thu Dec 10 03:24:10 2020
                                                            own
border02          evpn                     error            VNI 4001 state changed from up to d Thu Dec 10 03:24:10 2020
                                                            own
border02          evpn                     error            VNI 4002 state changed from up to d Thu Dec 10 02:58:20 2020
                                                            own
border02          evpn                     error            VNI 4001 state changed from up to d Thu Dec 10 02:58:20 2020
                                                            own
border02          evpn                     error            VNI 4002 state changed from up to d Thu Dec 10 02:32:16 2020
                                                            own
...
leaf02            services                 info             Service netqd status changed from i Thu Dec 10 06:49:15 2020
                                                            nactive to active
leaf02            services                 info             Service netqd status changed from i Thu Dec 10 06:22:22 2020
                                                            nactive to active
leaf02            services                 info             Service netqd status changed from i Thu Dec 10 06:21:20 2020
                                                            nactive to active
leaf02            services                 info             Service netqd status changed from i Thu Dec 10 06:20:19 2020
                                                            nactive to active
leaf02            services                 info             Service netqd status changed from i Thu Dec 10 06:14:06 2020
                                                            nactive to active
...

显示在 leaf01 交换机上从现在到一小时前发生的事件。

cumulus@switch:~$ netq leaf01 show events

Matching events records:
Hostname          Message Type             Severity         Message                             Timestamp
----------------- ------------------------ ---------------- ----------------------------------- -------------------------
leaf01            btrfsinfo                error            data storage efficiency : space lef Wed Sep  2 20:34:31 2020
                                                            t after allocation greater than chu
                                                            nk size 0.57 GB
leaf01            btrfsinfo                error            data storage efficiency : space lef Wed Sep  2 20:04:30 2020
                                                            t after allocation greater than chu
                                                            nk size 0.57 GB


netq show events-config

显示所有事件抑制配置。或者,您可以按特定配置或消息类型进行过滤。输出显示每个配置的以下信息

  • 配置标识符和名称
  • 消息类型
  • 抑制范围
  • 抑制不再适用的时间

当您按消息类型过滤时,必须包含 show-filter-conditions 关键字以显示与该消息类型和处理层次结构关联的条件。在这种情况下,输出提供每个消息类型的以下信息

  • 消息名称
  • 过滤器条件名称、层次结构和描述

语法

netq show events-config
    [events_config_id <text-events-config-id-anchor>]
    [show-filter-conditions | message_type <text-message-type-anchor> show-filter-conditions]
    [json]

必需参数

选项

选项描述
events_config_id<text-events-config-id-anchor>仅显示此名称的交换机或主机的结果
show-filter-conditionsNA仅显示使用此名称的 VNI 的会话的结果
message_type<text-message-type-anchor>仅显示此类型的配置的结果。值包括 agentarbgpbtrfsinfoclsupportconfigdiffevpnlcmlinklldpmlagmtuntppackageinfoptproceconfigrunningconfigdiffsensorservicesssdutil
jsonNA以 JSON 格式显示输出

用法示例

显示给定的事件抑制配置

cumulus@switch:~$ netq show events-config events_config_id eventsconfig_1

Matching config_events records:
Events Config ID     Events Config Name   Message Type         Scope                                                        Active Suppress Until
-------------------- -------------------- -------------------- ------------------------------------------------------------ ------ --------------------
eventsconfig_1       job_cl_upgrade_2d89c agent                {"db_state":"*","hostname":"spine02","severity":"*"}         True   Tue Jul  7 16:16:20
                     21b3effd79796e585c35                                                                                          2020
                     096d5fc6cef32b463e37
                     cca88d8ee862ae104d5_
                     spine02
eventsconfig_1       job_cl_upgrade_2d89c bgp                  {"vrf":"*","peer":"*","hostname":"spine04","severity":"*"}   True   Tue Jul  7 16:16:20
                     21b3effd79796e585c35                                                                                          2020
                     096d5fc6cef32b463e37
                     cca88d8ee862ae104d5_
                     spine04
eventsconfig_1       job_cl_upgrade_2d89c btrfsinfo            {"hostname":"spine04","info":"*","severity":"*"}             True   Tue Jul  7 16:16:20
                     21b3effd79796e585c35                                                                                          2020
                     096d5fc6cef32b463e37
                     cca88d8ee862ae104d5_
                     spine04
eventsconfig_1       job_cl_upgrade_2d89c clag                 {"hostname":"spine04","severity":"*"}                        True   Tue Jul  7 16:16:20
                     21b3effd79796e585c35                                                                                          2020
                     096d5fc6cef32b463e37
                     cca88d8ee862ae104d5_
                     spine04
...

显示 EVPN 事件抑制配置的过滤器条件

cumulus@switch:~$ netq show events-config message_type evpn show-filter-conditions

Matching config_events records:
Message Name             Filter Condition Name                      Filter Condition Hierarchy                           Filter Condition Description
------------------------ ------------------------------------------ ---------------------------------------------------- --------------------------------------------------------
evpn                     vni                                        3                                                    Target VNI
evpn                     severity                                   2                                                    Severity error/info
evpn                     hostname                                   1                                                    Target Hostname
  • netq show events

netq show evpn

显示当前或过去一段时间内,您的网络结构中所有节点或特定节点上所有 EVPN 会话或单个会话的运行状况。输出提供每个会话的以下信息

  • 使用的 VNI
  • VNI 端点的地址
  • 会话是否是第 2 层或第 3 层配置的一部分
  • 定义的关联 VRF 或 VLAN
  • 关联的 VNI 是否在内核中
  • 用于过滤的导出和导入路由目标
  • 上述任何项目上次发生更改的时间

语法

netq [<hostname>] show evpn
    [vni <text-vni>]
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
vni<text-vni>仅显示使用此名称的 VNI 的会话的结果
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

以下示例显示所有设备的配置和状态,包括关联的 VNI、VTEP 地址、导入和导出路由(显示 BGP ASN 和 VNI 路径)以及每个运行 EVPN 的设备上次发生更改的时间。

此示例显示 Cumulus 参考拓扑,其中 EVPN 在所有边界交换机和叶交换机上运行。每个会话由一行表示。

cumulus@switch:~$ netq show evpn
Matching evpn records:
Hostname          VNI        VTEP IP          Type             Mapping        In Kernel Export RT        Import RT        Last Changed
----------------- ---------- ---------------- ---------------- -------------- --------- ---------------- ---------------- -------------------------
border01          4002       10.0.1.254       L3               Vrf BLUE       yes       65132:4002       65132:4002       Wed Oct  7 00:49:27 2020
border01          4001       10.0.1.254       L3               Vrf RED        yes       65132:4001       65132:4001       Wed Oct  7 00:49:27 2020
border02          4002       10.0.1.254       L3               Vrf BLUE       yes       65132:4002       65132:4002       Wed Oct  7 00:48:47 2020
border02          4001       10.0.1.254       L3               Vrf RED        yes       65132:4001       65132:4001       Wed Oct  7 00:48:47 2020
leaf01            10         10.0.1.1         L2               Vlan 10        yes       65101:10         65101:10         Wed Oct  7 00:49:30 2020
leaf01            30         10.0.1.1         L2               Vlan 30        yes       65101:30         65101:30         Wed Oct  7 00:49:30 2020
leaf01            4002       10.0.1.1         L3               Vrf BLUE       yes       65101:4002       65101:4002       Wed Oct  7 00:49:30 2020
leaf01            4001       10.0.1.1         L3               Vrf RED        yes       65101:4001       65101:4001       Wed Oct  7 00:49:30 2020
leaf01            20         10.0.1.1         L2               Vlan 20        yes       65101:20         65101:20         Wed Oct  7 00:49:30 2020
leaf02            10         10.0.1.1         L2               Vlan 10        yes       65101:10         65101:10         Wed Oct  7 00:48:25 2020
leaf02            20         10.0.1.1         L2               Vlan 20        yes       65101:20         65101:20         Wed Oct  7 00:48:25 2020
leaf02            4001       10.0.1.1         L3               Vrf RED        yes       65101:4001       65101:4001       Wed Oct  7 00:48:25 2020
leaf02            4002       10.0.1.1         L3               Vrf BLUE       yes       65101:4002       65101:4002       Wed Oct  7 00:48:25 2020
leaf02            30         10.0.1.1         L2               Vlan 30        yes       65101:30         65101:30         Wed Oct  7 00:48:25 2020
leaf03            4002       10.0.1.2         L3               Vrf BLUE       yes       65102:4002       65102:4002       Wed Oct  7 00:50:13 2020
leaf03            10         10.0.1.2         L2               Vlan 10        yes       65102:10         65102:10         Wed Oct  7 00:50:13 2020
leaf03            30         10.0.1.2         L2               Vlan 30        yes       65102:30         65102:30         Wed Oct  7 00:50:13 2020
leaf03            20         10.0.1.2         L2               Vlan 20        yes       65102:20         65102:20         Wed Oct  7 00:50:13 2020
leaf03            4001       10.0.1.2         L3               Vrf RED        yes       65102:4001       65102:4001       Wed Oct  7 00:50:13 2020
leaf04            4001       10.0.1.2         L3               Vrf RED        yes       65102:4001       65102:4001       Wed Oct  7 00:50:09 2020
leaf04            4002       10.0.1.2         L3               Vrf BLUE       yes       65102:4002       65102:4002       Wed Oct  7 00:50:09 2020
leaf04            20         10.0.1.2         L2               Vlan 20        yes       65102:20         65102:20         Wed Oct  7 00:50:09 2020
leaf04            10         10.0.1.2         L2               Vlan 10        yes       65102:10         65102:10         Wed Oct  7 00:50:09 2020
leaf04            30         10.0.1.2         L2               Vlan 30        yes       65102:30         65102:30         Wed Oct  7 00:50:09 2020

此示例显示 VNI 4001 的 EVPN 配置和状态。

cumulus@switch:~$ netq show evpn vni 4001
Matching evpn records:
Hostname          VNI        VTEP IP          Type             Mapping        In Kernel Export RT        Import RT        Last Changed
----------------- ---------- ---------------- ---------------- -------------- --------- ---------------- ---------------- -------------------------
border01          4001       10.0.1.254       L3               Vrf RED        yes       65132:4001       65132:4001       Mon Oct 12 03:45:45 2020
border02          4001       10.0.1.254       L3               Vrf RED        yes       65132:4001       65132:4001       Mon Oct 12 03:45:11 2020
leaf01            4001       10.0.1.1         L3               Vrf RED        yes       65101:4001       65101:4001       Mon Oct 12 03:46:15 2020
leaf02            4001       10.0.1.1         L3               Vrf RED        yes       65101:4001       65101:4001       Mon Oct 12 03:44:18 2020
leaf03            4001       10.0.1.2         L3               Vrf RED        yes       65102:4001       65102:4001       Mon Oct 12 03:48:22 2020
leaf04            4001       10.0.1.2         L3               Vrf RED        yes       65102:4001       65102:4001       Mon Oct 12 03:47:47 2020
  • netq show events message_type evpn
  • netq show unit-tests evpn
  • netq check evpn

netq show histogram

以直方图形式显示设备的出口队列长度,并将其分组到各个容器中。有关更多信息,请参阅监控交换机

语法

netq <hostname> show histogram interface <text-ifname> queue  
    [json]

必需参数

参数描述
NA<hostname>仅显示此名称的交换机的结果
interface<text-ifname>仅显示此名称的接口的结果

选项

选项描述
jsonNA以 JSON 格式显示输出

用法示例

显示 leaf01 上接口 swp1 的数据

cumulus@switch:~$ netq leaf01 show histogram interface swp1 queue

Matching queue_histograms records:
Time                           Bin0     Bin1     Bin2     Bin3     Bin4     Bin5     Bin6     Bin7     Bin8     Bin9
------------------------------ -------- -------- -------- -------- -------- -------- -------- -------- -------- --------
Mon Jul  8 19:41:23 2024       992115   3434     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:22 2024       999438   3492     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:21 2024       999782   3337     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:20 2024       998757   3479     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:19 2024       997223   3391     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:18 2024       987939   3346     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:17 2024       999167   3412     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:16 2024       1000553  3401     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:15 2024       1000598  3420     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:14 2024       999258   3420     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:13 2024       1002366  3452     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:12 2024       998212   3467     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:11 2024       1002767  3361     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:10 2024       1002361  3385     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:09 2024       989952   3451     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:08 2024       998360   3474     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:07 2024       1002658  3536     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:06 2024       999199   3450     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:05 2024       999429   3420     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:04 2024       997595   3430     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:03 2024       999888   3454     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:02 2024       1000880  3523     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:01 2024       999824   3502     0        0        0        0        0        0        0        0
Mon Jul  8 19:41:00 2024       1001447  3413     0        0        0        0        0        0        0        0
Mon Jul  8 19:40:59 2024       995547   3366     0        0        0        0        0        0        0        0
Mon Jul  8 19:40:58 2024       986930   3393     0        0        0        0        0        0        0        0
Mon Jul  8 19:40:57 2024       998351   3417     0        0        0        0        0        0        0        0
Mon Jul  8 19:40:56 2024       999049   3442     0        0        0        0        0        0        0        0
Mon Jul  8 19:40:55 2024       988615   3439     0        0        0        0        0        0        0        0
Mon Jul  8 19:40:54 2024       992414   3298     0        0        0        0        0        0        0        0
Mon Jul  8 19:40:53 2024       997661   3407     0        0        0        0        0        0        0        0


netq show interfaces

显示当前或过去一段时间内,您的网络结构中所有节点或特定节点上所有接口或单个接口的运行状况。您可以按接口类型、接口状态或远程接口进行过滤。对于给定的交换机或主机,您可以查看已配置接口的总数。

输出提供每个设备的以下信息

  • 接口的名称
  • 接口的类型
  • 接口的状态(up 或 down)
  • 关联的 VRF、VLAN、PVID、MTU 和 LLDP 对等项
  • 上述任何项目上次发生更改的时间
  • 给定设备上接口的总数
  • 物理接口的模块、供应商、部件号和性能信息

语法

此命令有六种形式,具体取决于您是要查看所有设备还是给定设备的接口运行状况,以及是否要按接口类型进行过滤。

netq show interfaces
    [<remote-interface>]
    [state <remote-interface-state>]
    [around <text-time>]
    [json]

netq <hostname> show interfaces
    [<remote-interface>]
    [state <remote-interface-state>]
    [around <text-time>]
    [count]
    [json]

netq [<hostname>] show interfaces alias 
    [<remote-interface>] 
    [around <text-time>] 
    [json]

netq [<hostname>] show interfaces physical 
   [<physical-port>] 
   [empty|plugged] 
   [peer] 
   [vendor <module-vendor> | model <module-model>| module] 
   [around <text-time>]
   [json]

netq show interfaces type (bond|bridge|eth|loopback|macvlan|swp|vlan|vrf|vxlan)
    [state <remote-interface-state>]
    [around <text-time>]
    [json]

netq <hostname> show interfaces type (bond|bridge|eth|loopback|macvlan|swp|vlan|vrf|vxlan)
    [state <remote-interface-state>]
    [around <text-time>]
    [count]
    [json]

必需参数

参数描述
NA<hostname>仅显示此名称的交换机或主机的结果。
aliasNA仅显示指定接口别名的结果
physicalNA仅显示物理接口的结果
typebond, bridge, eth, loopback, macvlan, swp, vlan, vrf, 或 vxlan仅显示指定接口类型的结果

选项

选项描述
NA<remote-interface>仅显示具有此远程接口的本地接口的结果
state<remote-interface-state>仅显示处于指定状态(up 或 down)的远程接口的结果
NA<physical-port>仅显示此名称的接口的结果
NAempty, plugged显示具有连接电缆(已插入)或没有连接(空)的交换机端口
NApeer显示连接的对等端口
vendor<module-vendor>仅显示来自特定供应商(例如,Mellanox)的结果
model<module-model>仅显示来自特定型号的结果
moduleNA显示接口模块信息
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

countNA显示指定交换机或主机上的接口总数。您必须指定 hostname 选项。
jsonNA以 JSON 格式显示输出

用法示例

显示给定设备上的接口

cumulus@switch:~$ netq spine01 show interfaces
Matching link records:
Hostname          Interface                 Type             State      VRF             Details                             Last Changed
----------------- ------------------------- ---------------- ---------- --------------- ----------------------------------- -------------------------
spine01           swp5                      swp              up         default         VLANs: ,                            Tue Nov 10 22:30:11 2020
                                                                                        PVID: 0 MTU: 9216 LLDP: border01:sw
                                                                                        p51
spine01           swp6                      swp              up         default         VLANs: ,                            Tue Nov 10 22:30:11 2020
                                                                                        PVID: 0 MTU: 9216 LLDP: border02:sw
                                                                                        p51
spine01           eth0                      eth              up         mgmt            MTU: 1500                           Tue Nov 10 22:30:11 2020
spine01           lo                        loopback         up         default         MTU: 65536                          Tue Nov 10 22:30:11 2020
spine01           mgmt                      vrf              up         mgmt            table: 1001, MTU: 65536,            Tue Nov 10 22:30:11 2020
                                                                                        Members:  eth0,  mgmt,
spine01           vagrant                   swp              down       default         VLANs: , PVID: 0 MTU: 1500          Tue Nov 10 22:30:11 2020
spine01           swp1                      swp              up         default         VLANs: ,                            Tue Nov 10 22:30:11 2020
                                                                                        PVID: 0 MTU: 9216 LLDP: leaf01:swp5
                                                                                        1
spine01           swp2                      swp              up         default         VLANs: ,                            Tue Nov 10 22:30:11 2020
                                                                                        PVID: 0 MTU: 9216 LLDP: leaf02:swp5
                                                                                        1
spine01           swp3                      swp              up         default         VLANs: ,                            Tue Nov 10 22:30:11 2020
                                                                                        PVID: 0 MTU: 9216 LLDP: leaf03:swp5
                                                                                        1
spine01           swp4                      swp              up         default         VLANs: ,                            Tue Nov 10 22:30:11 2020
                                                                                        PVID: 0 MTU: 9216 LLDP: leaf04:swp5
                                                                                        1

查看给定设备上的接口计数。

cumulus@switch:~$ netq spine01 show interfaces count
Count of matching link records: 10

仅显示 VLAN 结果。输出显示接口、其指定的 MTU、是否在 VRF 上运行以及上次更改的时间。

cumulus@switch:~$ netq show interfaces type vlan
Matching link records:
Hostname          Interface                 Type             State      VRF             Details                             Last Changed
----------------- ------------------------- ---------------- ---------- --------------- ----------------------------------- -------------------------
border01          vlan4002                  vlan             up         BLUE            MTU: 9216                           Tue Oct 27 22:28:48 2020
border01          vlan4001                  vlan             up         RED             MTU: 9216                           Tue Oct 27 22:28:48 2020
border01          peerlink.4094             vlan             up         default         MTU: 9216                           Tue Oct 27 22:28:48 2020
border02          vlan4002                  vlan             up         BLUE            MTU: 9216                           Tue Oct 27 22:28:51 2020
border02          vlan4001                  vlan             up         RED             MTU: 9216                           Tue Oct 27 22:28:51 2020
border02          peerlink.4094             vlan             up         default         MTU: 9216                           Tue Oct 27 22:28:51 2020
fw1               borderBond.20             vlan             up         default         MTU: 9216                           Tue Oct 27 22:28:25 2020
fw1               borderBond.10             vlan             up         default         MTU: 9216                           Tue Oct 27 22:28:25 2020
leaf01            vlan20                    vlan             up         RED             MTU: 9216                           Tue Oct 27 22:28:42 2020
leaf01            vlan4002                  vlan             up         BLUE            MTU: 9216                           Tue Oct 27 22:28:42 2020
leaf01            vlan30                    vlan             up         BLUE            MTU: 9216                           Tue Oct 27 22:28:42 2020
leaf01            vlan4001                  vlan             up         RED             MTU: 9216                           Tue Oct 27 22:28:42 2020
leaf01            vlan10                    vlan             up         RED             MTU: 9216                           Tue Oct 27 22:28:42 2020
leaf01            peerlink.4094             vlan             up         default         MTU: 9216                           Tue Oct 27 22:28:42 2020
leaf02            vlan20                    vlan             up         RED             MTU: 9216                           Tue Oct 27 22:28:51 2020
leaf02            vlan4002                  vlan             up         BLUE            MTU: 9216                           Tue Oct 27 22:28:51 2020
leaf02            vlan30                    vlan             up         BLUE            MTU: 9216                           Tue Oct 27 22:28:51 2020
leaf02            vlan4001                  vlan             up         RED             MTU: 9216                           Tue Oct 27 22:28:51 2020
leaf02            vlan10                    vlan             up         RED             MTU: 9216                           Tue Oct 27 22:28:51 2020
leaf02            peerlink.4094             vlan             up         default         MTU: 9216                           Tue Oct 27 22:28:51 2020
leaf03            vlan20                    vlan             up         RED             MTU: 9216                           Tue Oct 27 22:28:23 2020
leaf03            vlan4002                  vlan             up         BLUE            MTU: 9216                           Tue Oct 27 22:28:23 2020
leaf03            vlan4001                  vlan             up         RED             MTU: 9216                           Tue Oct 27 22:28:23 2020
leaf03            vlan30                    vlan             up         BLUE            MTU: 9216                           Tue Oct 27 22:28:23 2020
leaf03            vlan10                    vlan             up         RED             MTU: 9216                           Tue Oct 27 22:28:23 2020
leaf03            peerlink.4094             vlan             up         default         MTU: 9216                           Tue Oct 27 22:28:23 2020
leaf04            vlan20                    vlan             up         RED             MTU: 9216                           Tue Oct 27 22:29:06 2020
leaf04            vlan4002                  vlan             up         BLUE            MTU: 9216                           Tue Oct 27 22:29:06 2020
leaf04            vlan4001                  vlan             up         RED             MTU: 9216                           Tue Oct 27 22:29:06 2020
leaf04            vlan30                    vlan             up         BLUE            MTU: 9216                           Tue Oct 27 22:29:06 2020
leaf04            vlan10                    vlan             up         RED             MTU: 9216                           Tue Oct 27 22:29:06 2020
leaf04            peerlink.4094             vlan             up         default         MTU: 9216                           Tue Oct 27 22:29:06 2020

显示与您的 vRR(虚拟路由反射器)接口配置关联的所有 MAC 地址。这对于确定 VLAN 内指定的 MAC 地址在您的 vRR 配置中是否相同或不同非常有用。

cumulus@switch:~$ netq show interfaces type macvlan
Matching mac records:
Origin MAC Address        VLAN   Hostname          Egress Port                    Remote Last Changed
------ ------------------ ------ ----------------- ------------------------------ ------ -------------------------
yes    00:00:00:00:00:1a  10     leaf02            bridge                         no     Tue Oct 27 22:28:51 2020
yes    44:38:39:00:00:37  10     leaf02            bridge                         no     Tue Oct 27 22:28:51 2020
cumulus@netq-ts:~$ netq show interfaces type macvlan

Matching link records:
Hostname          Interface                 Type             State      VRF             Details                             Last Changed
----------------- ------------------------- ---------------- ---------- --------------- ----------------------------------- -------------------------
leaf01            vlan10-v0                 macvlan          up         RED             MAC: 00:00:00:00:00:1a,             Tue Oct 27 22:28:42 2020
                                                                                        Mode: Private
leaf01            vlan20-v0                 macvlan          up         RED             MAC: 00:00:00:00:00:1b,             Tue Oct 27 22:28:42 2020
                                                                                        Mode: Private
leaf01            vlan30-v0                 macvlan          up         BLUE            MAC: 00:00:00:00:00:1c,             Tue Oct 27 22:28:42 2020
                                                                                        Mode: Private
leaf02            vlan10-v0                 macvlan          up         RED             MAC: 00:00:00:00:00:1a,             Tue Oct 27 22:28:51 2020
                                                                                        Mode: Private
leaf02            vlan20-v0                 macvlan          up         RED             MAC: 00:00:00:00:00:1b,             Tue Oct 27 22:28:51 2020
                                                                                        Mode: Private
leaf02            vlan30-v0                 macvlan          up         BLUE            MAC: 00:00:00:00:00:1c,             Tue Oct 27 22:28:51 2020
                                                                                        Mode: Private
leaf03            vlan10-v0                 macvlan          up         RED             MAC: 00:00:00:00:00:1a,             Tue Oct 27 22:28:23 2020
                                                                                        Mode: Private
leaf03            vlan20-v0                 macvlan          up         RED             MAC: 00:00:00:00:00:1b,             Tue Oct 27 22:28:23 2020
                                                                                        Mode: Private
leaf03            vlan30-v0                 macvlan          up         BLUE            MAC: 00:00:00:00:00:1c,             Tue Oct 27 22:28:23 2020
                                                                                        Mode: Private
leaf04            vlan10-v0                 macvlan          up         RED             MAC: 00:00:00:00:00:1a,             Tue Oct 27 22:29:06 2020
                                                                                        Mode: Private
leaf04            vlan20-v0                 macvlan          up         RED             MAC: 00:00:00:00:00:1b,             Tue Oct 27 22:29:06 2020
                                                                                        Mode: Private
leaf04            vlan30-v0                 macvlan          up         BLUE            MAC: 00:00:00:00:00:1c,             Tue Oct 27 22:29:06 2020

显示所有设备上所有接口端口的电缆信息和状态

cumulus@switch:~$ netq show interfaces physical
Matching cables records:
Hostname          Interface                 State      Speed      AutoNeg Module    Vendor               Part No          Last Changed
----------------- ------------------------- ---------- ---------- ------- --------- -------------------- ---------------- -------------------------
border01          vagrant                   down       Unknown    off     RJ45      n/a                  n/a              Fri Sep 18 20:08:05 2020
border01          swp54                     up         1G         off     RJ45      n/a                  n/a              Fri Sep 18 20:08:05 2020
border01          swp49                     up         1G         off     RJ45      n/a                  n/a              Fri Sep 18 20:08:05 2020
border01          swp2                      down       Unknown    off     RJ45      n/a                  n/a              Fri Sep 18 20:08:05 2020
border01          swp3                      up         1G         off     RJ45      n/a                  n/a              Fri Sep 18 20:08:05 2020
border01          swp52                     up         1G         off     RJ45      n/a                  n/a              Fri Sep 18 20:08:05 2020
border01          swp1                      down       Unknown    off     RJ45      n/a                  n/a              Fri Sep 18 20:08:05 2020
border01          swp53                     up         1G         off     RJ45      n/a                  n/a              Fri Sep 18 20:08:05 2020
border01          swp4                      down       Unknown    off     RJ45      n/a                  n/a              Fri Sep 18 20:08:05 2020
border01          swp50                     up         1G         off     RJ45      n/a                  n/a              Fri Sep 18 20:08:05 2020
border01          eth0                      up         1G         off     RJ45      n/a                  n/a              Fri Sep 18 20:08:05 2020
border01          swp51                     up         1G         off     RJ45      n/a                  n/a              Fri Sep 18 20:08:05 2020
border02          swp49                     up         1G         off     RJ45      n/a                  n/a              Thu Sep 17 21:07:54 2020
border02          swp54                     up         1G         off     RJ45      n/a                  n/a              Thu Sep 17 21:07:54 2020
border02          swp52                     up         1G         off     RJ45      n/a                  n/a              Thu Sep 17 21:07:54 2020
border02          swp53                     up         1G         off     RJ45      n/a                  n/a              Thu Sep 17 21:07:54 2020
border02          swp4                      down       Unknown    off     RJ45      n/a                  n/a              Thu Sep 17 21:07:54 2020
border02          swp3                      up         1G         off     RJ45      n/a                  n/a              Thu Sep 17 21:07:54 2020
border02          vagrant                   down       Unknown    off     RJ45      n/a                  n/a              Thu Sep 17 21:07:54 2020
border02          swp1                      down       Unknown    off     RJ45      n/a                  n/a              Thu Sep 17 21:07:54 2020
border02          swp2                      down       Unknown    off     RJ45      n/a                  n/a              Thu Sep 17 21:07:54 2020
border02          swp51                     up         1G         off     RJ45      n/a                  n/a              Thu Sep 17 21:07:54 2020
border02          swp50                     up         1G         off     RJ45      n/a                  n/a              Thu Sep 17 21:07:54 2020
border02          eth0                      up         1G         off     RJ45      n/a                  n/a              Thu Sep 17 21:07:54 2020
fw1               swp49                     down       Unknown    off     RJ45      n/a                  n/a              Thu Sep 17 21:07:37 2020
fw1               eth0                      up         1G         off     RJ45      n/a                  n/a              Thu Sep 17 21:07:37 2020
fw1               swp1                      up         1G         off     RJ45      n/a                  n/a              Thu Sep 17 21:07:37 2020
fw1               swp2                      up         1G         off     RJ45      n/a                  n/a              Thu Sep 17 21:07:37 2020
fw1               vagrant                   down       Unknown    off     RJ45      n/a                  n/a              Thu Sep 17 21:07:37 2020
fw2               vagrant                   down       Unknown    off     RJ45      n/a                  n/a              Thu Sep 17 21:07:38 2020
fw2               eth0                      up         1G         off     RJ45      n/a                  n/a              Thu Sep 17 21:07:38 2020
fw2               swp49                     down       Unknown    off     RJ45      n/a                  n/a              Thu Sep 17 21:07:38 2020
fw2               swp2                      down       Unknown    off     RJ45      n/a                  n/a              Thu Sep 17 21:07:38 2020
fw2               swp1                      down       Unknown    off     RJ45      n/a                  n/a              Thu Sep 17 21:07:38 2020
...

以下示例显示 leaf02 交换机上接口端口的详细模块信息

cumulus@switch:~$ netq leaf02 show interfaces physical module
Matching cables records are:
Hostname          Interface                 Module    Vendor               Part No          Serial No                 Transceiver      Connector        Length Last Changed
----------------- ------------------------- --------- -------------------- ---------------- ------------------------- ---------------- ---------------- ------ -------------------------
leaf02            swp1                      RJ45      n/a                  n/a              n/a                       n/a              n/a              n/a    Thu Feb  7 22:49:37 2019
leaf02            swp2                      SFP       Mellanox             MC2609130-003    MT1507VS05177             1000Base-CX,Copp Copper pigtail   3m     Thu Feb  7 22:49:37 2019
                                                                                                                        er Passive,Twin
                                                                                                                        Axial Pair (TW)
leaf02            swp47                     QSFP+     CISCO                AFBR-7IER05Z-CS1 AVE1823402U               n/a              n/a              5m     Thu Feb  7 22:49:37 2019
leaf02            swp48                     QSFP28    TE Connectivity      2231368-1        15250052                  100G Base-CR4 or n/a              3m     Thu Feb  7 22:49:37 2019
                                                                                                                        25G Base-CR CA-L
                                                                                                                        ,40G Base-CR4               
leaf02            swp49                     SFP       OEM                  SFP-10GB-LR      ACSLR130408               10G Base-LR      LC               10km,  Thu Feb  7 22:49:37 2019
                                                                                                                                                        10000m
leaf02            swp50                     SFP       JDSU                 PLRXPLSCS4322N   CG03UF45M                 10G Base-SR,Mult LC               80m,   Thu Feb  7 22:49:37 2019
                                                                                                                        imode,                            30m,  
                                                                                                                        50um (M5),Multim                  300m  
                                                                                                                        ode,            
                                                                                                                        62.5um (M6),Shor
                                                                                                                        twave laser w/o
                                                                                                                        OFC (SN),interme
                                                                                                                        diate distance (
                                                                                                                        I)              
leaf02            swp51                     SFP       Mellanox             MC2609130-003    MT1507VS05177             1000Base-CX,Copp Copper pigtail   3m     Thu Feb  7 22:49:37 2019
                                                                                                                        er Passive,Twin
                                                                                                                        Axial Pair (TW)
leaf02            swp52                     SFP       FINISAR CORP.        FCLF8522P2BTL    PTN1VH2                   1000Base-T       RJ45             100m   Thu Feb  7 22:49:37 2019

以下示例首先确定所有设备上存在的型号(部件号),然后显示安装了部件号为 QSFP-H40G-CU1M 的设备

cumulus@switch:~$ netq show interfaces physical model
    2231368-1         :  2231368-1
    624400001         :  624400001
    QSFP-H40G-CU1M    :  QSFP-H40G-CU1M
    QSFP-H40G-CU1MUS  :  QSFP-H40G-CU1MUS
    n/a               :  n/a

cumulus@switch:~$ netq show interfaces physical model QSFP-H40G-CU1M
Matching cables records:
Hostname          Interface                 State      Speed      AutoNeg Module    Vendor               Part No          Last Changed
----------------- ------------------------- ---------- ---------- ------- --------- -------------------- ---------------- -------------------------
leaf01            swp50                     up         1G         off     QSFP+     OEM                  QSFP-H40G-CU1M   Thu Feb  7 18:31:20 2019
leaf02            swp52                     up         1G         off     QSFP+     OEM                  QSFP-H40G-CU1M   Thu Feb  7 18:31:20 2019
  • netq show events
  • netq check interfaces
  • netq show unit-tests interfaces

netq show interface-stats

显示网络中交换机上物理接口的性能统计信息。NetQ Agent 每 30 秒收集一次统计信息。不收集非物理接口(例如,bond、bridge 和 VXLAN)的统计信息。您可以按接口过滤输出,或仅显示错误。输出提供每个交换机和接口的以下信息

  • 发送: tx_bytes, tx_carrier, tx_colls, tx_drop, tx_errs, tx_packets
  • 接收: rx_bytes, rx_drop, rx_errs, rx_frame, rx_multicast, rx_packets
  • 上述任何项目上次更改的时间

语法

netq [<hostname>] show interface-stats
    [errors | all]
    [<physical-port>]
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
errorsNA仅显示发送和接收错误统计信息
allNA显示所有统计信息
NA<physical-port>仅显示此名称的接口的结果
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示给定接口的统计信息

cumulus@switch:~$ netq show interface-stats swp2
Matching proc_dev_stats records:
Hostname          Interface                 RX Packets           RX Drop              RX Errors            TX Packets           TX Drop              TX Errors            Last Updated
----------------- ------------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- ------------------------
border01          swp2                      0                    0                    0                    0                    0                    0                    Tue Dec 15 15:47:23 2020
border02          swp2                      0                    0                    0                    0                    0                    0                    Tue Dec 15 15:47:09 2020
fw1               swp2                      6327111              0                    0                    6324616              0                    0                    Tue Dec 15 15:47:07 2020
fw2               swp2                      0                    0                    0                    0                    0                    0                    Tue Dec 15 15:46:54 2020
spine03           swp2                      5097329              0                    0                    5124570              0                    0                    Tue Dec 15 15:47:00 2020
spine04           swp2                      5167364              0                    0                    5111678              0                    0                    Tue Dec 15 15:47:18 2020
  • netq show interface-utilization
  • netq show ethtool-stats

netq show interface-utilization

显示网络中交换机上物理接口的利用率(发送和接收)和端口速度。NetQ 每 30 秒收集一次此数据。您可以按端口名称、数据方向和时间过滤输出。

语法

netq [<hostname>] show interface-utilization
    [<text-port>]
    [tx|rx]
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
NA<text-port>仅显示此名称端口的结果
txNA仅显示发送数据的结果
rxNA仅显示接收数据的结果
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示给定设备的利用率

cumulus@switch:~$ netq spine01 show interface-utilization
Matching port_stats records:
Hostname          Interface                 RX Bytes (30sec)     RX Drop (30sec)      RX Errors (30sec)    RX Util (%age)       TX Bytes (30sec)     TX Drop (30sec)      TX Errors (30sec)    TX Util (%age)       Port Speed           Last Changed
----------------- ------------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- --------------------
spine01           swp6                      2652                 0                    0                    0                    2650                 0                    0                    0                    1G                   Tue Dec 15 16:02:57
                                                                                                                                                                                                                                         2020
spine01           swp5                      2547                 0                    0                    0                    2545                 0                    0                    0                    1G                   Tue Dec 15 16:02:57
                                                                                                                                                                                                                                         2020

仅显示所有设备的利用率(仅发送)

cumulus@switch:~$ netq show interface-utilization tx
Matching port_stats records:
Hostname          Interface                 TX Bytes (30sec)     TX Drop (30sec)      TX Errors (30sec)    TX Util (%age)       Port Speed           Last Changed
----------------- ------------------------- -------------------- -------------------- -------------------- -------------------- -------------------- --------------------
border01          swp1                      0                    0                    0                    0                    Unknown              Tue Dec 15 16:04:01
                                                                                                                                                     2020
border01          swp54                     2539                 0                    0                    0                    1G                   Tue Dec 15 16:04:01
                                                                                                                                                     2020
border01          swp52                     1679                 0                    0                    0                    1G                   Tue Dec 15 16:04:01
                                                                                                                                                     2020
border01          swp4                      0                    0                    0                    0                    Unknown              Tue Dec 15 16:04:01
                                                                                                                                                     2020
border01          swp53                     2539                 0                    0                    0                    1G                   Tue Dec 15 16:04:01
                                                                                                                                                     2020
border01          swp3                      4714                 0                    0                    0                    1G                   Tue Dec 15 16:04:01
                                                                                                                                                     2020
border01          swp49                     7708                 0                    0                    0                    1G                   Tue Dec 15 16:04:01
                                                                                                                                                     2020
border01          swp51                     2711                 0                    0                    0                    1G                   Tue Dec 15 16:04:01
...
  • netq show interface-stats
  • netq show ethtool-stats

netq show inventory

显示有关在给定设备或网络范围内所有设备上部署的硬件和软件组件的信息。输出提供特定于所选组件的详细信息。

语法

此命令有多种形式,具体取决于您要查看的清单组件

netq [<hostname>] show inventory brief
    [opta]
    [json]

netq [<hostname>] show inventory asic
    [vendor <asic-vendor>| model <asic-model>| model-id <asic-model-id>]
    [opta]
    [json]

netq [<hostname>] show inventory board
    [vendor <board-vendor>|model <board-model>]
    [opta]
    [json]

netq [<hostname>] show inventory cpu
    [arch <cpu-arch>]
    [opta]
    [json]

netq [<hostname>] show inventory disk
    [name <disk-name>|transport <disk-transport>| vendor <disk-vendor>]
    [opta]
    [json]

netq [<hostname>] show inventory memory
    [type <memory-type>|vendor <memory-vendor>]
    [opta]
    [json]

netq [<hostname>] show inventory os
    [version <os-version>|name <os-name>]
    [opta]
    [json]

必需参数

参数描述
briefNA仅显示摘要信息:主机名、交换机、OS、CPU 架构、ASIC 供应商、端口、NIC
asicNA仅显示 ASIC 信息:主机名、供应商、型号、型号 ID、核心带宽、端口
boardNA仅显示主板信息:主机名、供应商、型号、基本 MAC 地址、序列号、部件号、修订号、制造日期
cpuNA仅显示处理器信息:主机名、架构、型号、频率、核心数
diskNA仅显示磁盘信息:主机名、磁盘名称和类型、传输、大小、供应商、型号
memoryNA仅显示内存信息:主机名、内存名称、类型、大小、速度、供应商、序列号
osNA仅显示操作系统信息:主机名、OS 名称、版本、更改时间

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
vendor<asic-vendor>, <board-vendor>, <disk-vendor>, <memory-vendor>仅显示此名称的 ASIC、主板、磁盘或内存供应商的结果
model<asic-model>, <board-model>仅显示此名称的 ASIC 或主板型号的结果
model-id<asic-model-id>仅显示此 ID 的 ASIC 型号的结果
arch<cpu-arch>仅显示此架构的 CPU 的结果
transport<disk-transport>仅显示此传输方法的磁盘的结果
type<memory-type>仅显示此类型内存的结果
version<os-version>仅显示此版本操作系统的结果
name<os-name>仅显示此名称的操作系统的结果
optaNA仅显示 NetQ 设备或 VM 的结果(而不是其他交换机或主机)
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示清单摘要

cumulus@switch:~$ netq show inventory brief
Matching inventory records:
Hostname          Switch               OS              CPU      ASIC            Ports                               NIC
----------------- -------------------- --------------- -------- --------------- ----------------------------------- -----------------------------------
neo-switch01      SN3700C              CL              x86_64   Spectrum-2      32 x 100G-QSFP28                    N/A
neo-switch02      SN3700C              CL              x86_64   Spectrum-2      32 x 100G-QSFP28                    N/A
r-3420-01         SN3420               CL              x86_64   Spectrum-2      48 x 25G-SFP28 & 12 x 100G-QSFP28   N/A
r-3700-01         SN3700V              CL              x86_64   Spectrum-2      32 x 200G-QSFP56                    N/A
r-3700-02         SN3700C              CL              x86_64   Spectrum-2      32 x 100G-QSFP28                    N/A
r-3700-03         SN3700C              CL              x86_64   Spectrum-2      32 x 100G-QSFP28                    N/A
ufm-switch19      MSN2700              CL              x86_64   Spectrum        32 x 100G-QSFP28                    N/A
ufm-switch29      SN3700C              CL              x86_64   Spectrum-2      32 x 100G-QSFP28                    N/A

显示供应商为 NVIDIA 的所有设备的 ASIC 信息

cumulus@switch:~$ netq show inventory asic vendor NVIDIA
Matching inventory records:
Hostname          Vendor               Model                          Model ID                  Core BW        Ports
----------------- -------------------- ------------------------------ ------------------------- -------------- -----------------------------------
mlx-2100-05       NVIDIA               Spectrum                       MT52132                   N/A            16 x 100G-QSFP28
mlx-2410a1-05     NVIDIA               Spectrum                       MT52132                   N/A            48 x 25G-SFP28 & 8 x 100G-QSFP28
mlx-2700-11       NVIDIA               Spectrum                       MT52132                   N/A            32 x 100G-QSFP28

仅显示具有 Celestica 主板的设备

cumulus@switch:~$ netq show inventory board vendor celestica
Matching inventory records:
Hostname          Vendor               Model                          Base MAC           Serial No                 Part No          Rev    Mfg Date
----------------- -------------------- ------------------------------ ------------------ ------------------------- ---------------- ------ ----------
st1-l1            CELESTICA            Arctica 4806xp                 00:E0:EC:27:71:37  D2060B2F044919GD000011    R0854-F1004-01   Redsto 09/20/2014
                                                                                                                                    ne-XP
st1-l2            CELESTICA            Arctica 4806xp                 00:E0:EC:27:6B:3A  D2060B2F044919GD000060    R0854-F1004-01   Redsto 09/20/2014
                                                                                                                                    ne-XP

显示网络中当前部署的所有架构,然后显示具有 x86_64 架构的设备

cumulus@switch:~$ netq show inventory cpu arch
    x86_64  :  CPU Architecture
    
cumulus@switch:~$ netq show inventory cpu arch x86_64
Matching inventory records:
Hostname          Arch     Model                          Freq       Cores
----------------- -------- ------------------------------ ---------- -----
leaf01            x86_64   Intel Core i7 9xx (Nehalem Cla N/A        1
                            ss Core i7)
leaf02            x86_64   Intel Core i7 9xx (Nehalem Cla N/A        1
                            ss Core i7)
leaf03            x86_64   Intel Core i7 9xx (Nehalem Cla N/A        1
                            ss Core i7)
leaf04            x86_64   Intel Core i7 9xx (Nehalem Cla N/A        1
                            ss Core i7)
oob-mgmt-server   x86_64   Intel Core i7 9xx (Nehalem Cla N/A        1
                            ss Core i7)
server01          x86_64   Intel Core i7 9xx (Nehalem Cla N/A        1
                            ss Core i7)
server02          x86_64   Intel Core i7 9xx (Nehalem Cla N/A        1
                            ss Core i7)
server03          x86_64   Intel Core i7 9xx (Nehalem Cla N/A        1
                            ss Core i7)
server04          x86_64   Intel Core i7 9xx (Nehalem Cla N/A        1
                            ss Core i7)
spine01           x86_64   Intel Core i7 9xx (Nehalem Cla N/A        1
                            ss Core i7)
spine02           x86_64   Intel Core i7 9xx (Nehalem Cla N/A        1
                            ss Core i7)
  • netq config agent cpu-limit
  • netq show cl-manifest
  • netq show dom type
  • netq show resource-util
  • netq show sensors

netq show ip/ipv6 addresses

显示当前或过去一段时间内,为给定设备或网络范围内所有设备配置的 IPv4 或 IPv6 地址。您可以按远程接口、地址或前缀以及 VRF 过滤输出。您可以获取给定设备的地址计数。输出提供每个地址的以下信息

  • 具有地址的设备的主机名
  • 设备上具有地址的接口
  • 配置后,设备上具有地址的接口上的 VRF
  • 上述任何项目上次发生更改的时间

语法

有两组 IP 地址命令可用,一组用于 IPv4,另一组用于 IPv6。

netq <hostname> show ip addresses
    [<remote-interface>]
    [<ipv4>|<ipv4/prefixlen>]
    [vrf <vrf>]
    [around <text-time>]
    [count]
    [json]

netq show ip addresses
    [<remote-interface>]
    [<ipv4>|<ipv4/prefixlen>]
    [vrf <vrf>]
    [subnet|supernet|gateway]
    [around <text-time>]
    [json]

netq <hostname> show ipv6 addresses
    [<remote-interface>]
    [<ipv6>|<ipv6/prefixlen>]
    [vrf <vrf>]
    [around <text-time>]
    [count]
    [json]

netq show ipv6 addresses
    [<remote-interface>]
    [<ipv6>|<ipv6/prefixlen>]
    [vrf <vrf>]
    [subnet|supernet|gateway]
    [around <text-time>]
    [json]

必需参数

参数描述
NA<hostname>仅显示此名称的交换机或主机的结果
ipNA显示 TCP IPv4 地址
ipv6NA显示 TCP IPv6 地址

选项

选项描述
NA<remote-interface>仅显示具有此接口的交换机和主机的结果
NA<ipv4>仅显示具有此 IPv4 地址的交换机和主机的结果
NA<ipv4/prefixlen>仅显示具有此 IPv4 地址和前缀的交换机和主机的结果
NA<ipv6>仅显示具有此 IPv6 地址的交换机和主机的结果
NA<ipv6/prefixlen>仅显示具有此 IPv6 地址和前缀的交换机和主机的结果
vrf<vrf>仅显示使用此虚拟路由转发接口的交换机和主机的结果
subnetNA仅显示子网中地址的结果
supernetNA仅显示超网中地址的结果
gatewayNA仅显示网关中地址的结果
around<text-time>

指示磁盘利用率信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

以下示例显示参考拓扑中的所有 IPv4 地址

cumulus@switch:~$ netq show ip addresses
Matching address records:
Address                   Hostname          Interface                 VRF             Last Changed
------------------------- ----------------- ------------------------- --------------- -------------------------
10.10.10.104/32           spine04           lo                        default         Mon Oct 19 22:28:23 2020
192.168.200.24/24         spine04           eth0                                      Tue Oct 20 15:46:20 2020
10.10.10.103/32           spine03           lo                        default         Mon Oct 19 22:29:01 2020
192.168.200.23/24         spine03           eth0                                      Tue Oct 20 15:19:24 2020
192.168.200.22/24         spine02           eth0                                      Tue Oct 20 15:40:03 2020
10.10.10.102/32           spine02           lo                        default         Mon Oct 19 22:28:45 2020
192.168.200.21/24         spine01           eth0                                      Tue Oct 20 15:59:36 2020
10.10.10.101/32           spine01           lo                        default         Mon Oct 19 22:28:48 2020
192.168.200.38/24         server08          eth0                      default         Mon Oct 19 22:28:50 2020
192.168.200.37/24         server07          eth0                      default         Mon Oct 19 22:28:43 2020
192.168.200.36/24         server06          eth0                      default         Mon Oct 19 22:40:52 2020
10.1.20.105/24            server05          uplink                    default         Mon Oct 19 22:41:08 2020
10.1.10.104/24            server04          uplink                    default         Mon Oct 19 22:40:45 2020
192.168.200.33/24         server03          eth0                      default         Mon Oct 19 22:41:04 2020
192.168.200.32/24         server02          eth0                      default         Mon Oct 19 22:41:00 2020
10.1.10.101/24            server01          uplink                    default         Mon Oct 19 22:40:36 2020
10.255.1.228/24           oob-mgmt-server   vagrant                   default         Mon Oct 19 22:28:20 2020
192.168.200.1/24          oob-mgmt-server   eth1                      default         Mon Oct 19 22:28:20 2020
10.1.20.3/24              leaf04            vlan20                    RED             Mon Oct 19 22:28:47 2020
10.1.10.1/24              leaf04            vlan10-v0                 RED             Mon Oct 19 22:28:47 2020
192.168.200.14/24         leaf04            eth0                                      Tue Oct 20 15:56:40 2020
10.10.10.4/32             leaf04            lo                        default         Mon Oct 19 22:28:47 2020
10.1.20.1/24              leaf04            vlan20-v0                 RED             Mon Oct 19 22:28:47 2020
...

显示 spine01 交换机上的所有 IP 地址

cumulus@switch:~$ netq spine01 show ip addresses
Matching address records:
Address                   Hostname          Interface                 VRF             Last Changed
------------------------- ----------------- ------------------------- --------------- -------------------------
192.168.200.21/24         spine01           eth0                      mgmt            Thu Sep 17 20:07:49 2020
10.10.10.101/32           spine01           lo                        default         Thu Sep 17 20:25:05 2020

显示 leaf03 交换机上使用 BLUE VRF 的所有 IP 地址

cumulus@switch:~$ netq leaf03 show ip addresses vrf BLUE
Matching address records:
Address                   Hostname          Interface                 VRF             Last Changed
------------------------- ----------------- ------------------------- --------------- -------------------------
10.1.30.1/24              leaf03            vlan30-v0                 BLUE            Thu Sep 17 20:25:09 2020
10.1.30.2/24              leaf03            vlan30                    BLUE            Thu Sep 17 20:25:08 2020

以下示例显示参考拓扑中的所有 IPv6 地址

cumulus@switch:~$ netq show ipv6 addresses
Matching address records:
Address                   Hostname          Interface                 VRF             Last Changed
------------------------- ----------------- ------------------------- --------------- -------------------------
fe80::4638:39ff:fe00:16c/ spine04           eth0                                      Mon Oct 19 22:28:23 2020
64
fe80::4638:39ff:fe00:27/6 spine04           swp5                      default         Mon Oct 19 22:28:23 2020
4
fe80::4638:39ff:fe00:2f/6 spine04           swp6                      default         Mon Oct 19 22:28:23 2020
4
fe80::4638:39ff:fe00:17/6 spine04           swp3                      default         Mon Oct 19 22:28:23 2020
4
fe80::4638:39ff:fe00:1f/6 spine04           swp4                      default         Mon Oct 19 22:28:23 2020
4
fe80::4638:39ff:fe00:7/64 spine04           swp1                      default         Mon Oct 19 22:28:23 2020
fe80::4638:39ff:fe00:f/64 spine04           swp2                      default         Mon Oct 19 22:28:23 2020
fe80::4638:39ff:fe00:2d/6 spine03           swp6                      default         Mon Oct 19 22:29:01 2020
4
fe80::4638:39ff:fe00:25/6 spine03           swp5                      default         Mon Oct 19 22:29:01 2020
4
fe80::4638:39ff:fe00:170/ spine03           eth0                                      Mon Oct 19 22:29:01 2020
64
fe80::4638:39ff:fe00:15/6 spine03           swp3                      default         Mon Oct 19 22:29:01 2020
4
...

以下示例显示 leaf01 交换机的 IPv6 地址信息

cumulus@switch:~$ netq leaf01 show ipv6 addresses
Matching address records:
Address                   Hostname          Interface                 VRF             Last Changed
------------------------- ----------------- ------------------------- --------------- -------------------------
fe80::4638:39ff:febe:efaa leaf01            vlan4002                  BLUE            Mon Oct 19 22:28:22 2020
/64
fe80::4638:39ff:fe00:8/64 leaf01            swp54                     default         Mon Oct 19 22:28:22 2020
fe80::4638:39ff:fe00:59/6 leaf01            vlan10                    RED             Mon Oct 19 22:28:22 2020
4
fe80::4638:39ff:fe00:59/6 leaf01            vlan20                    RED             Mon Oct 19 22:28:22 2020
4
fe80::4638:39ff:fe00:59/6 leaf01            vlan30                    BLUE            Mon Oct 19 22:28:22 2020
4
fe80::4638:39ff:fe00:2/64 leaf01            swp51                     default         Mon Oct 19 22:28:22 2020
fe80::4638:39ff:fe00:4/64 leaf01            swp52                     default         Mon Oct 19 22:28:22 2020
fe80::4638:39ff:febe:efaa leaf01            vlan4001                  RED             Mon Oct 19 22:28:22 2020
/64
fe80::4638:39ff:fe00:6/64 leaf01            swp53                     default         Mon Oct 19 22:28:22 2020
fe80::200:ff:fe00:1c/64   leaf01            vlan30-v0                 BLUE            Mon Oct 19 22:28:22 2020
fe80::200:ff:fe00:1b/64   leaf01            vlan20-v0                 RED             Mon Oct 19 22:28:22 2020
fe80::200:ff:fe00:1a/64   leaf01            vlan10-v0                 RED             Mon Oct 19 22:28:22 2020
fe80::4638:39ff:fe00:59/6 leaf01            peerlink.4094             default         Mon Oct 19 22:28:22 2020
4
fe80::4638:39ff:fe00:59/6 leaf01            bridge                    default         Mon Oct 19 22:28:22 2020
4
fe80::4638:39ff:fe00:17a/ leaf01            eth0                                      Mon Oct 19 22:28:22 2020
64

以下示例显示 leaf01 交换机上的 IPv4 和 IPv6 地址数量

cumulus@switch:~$ netq leaf01 show ip addresses count
Count of matching address records: 9

cumulus@switch:~$ netq leaf01 show ipv6 addresses count
Count of matching address records: 17
  • netq show ip/ipv6 neighbors
  • netq show ip routes

netq show ip/ipv6 neighbors

显示当前或过去一段时间内,为给定设备或网络范围内所有设备配置的 IPv4 或 IPv6 邻居。您可以按远程接口、地址、地址和 VRF 或 VRF 过滤输出。您可以获取给定设备或给定设备和 MAC 地址的邻居计数。输出提供每个地址的以下信息

  • 邻居的主机名
  • 邻居的接口
  • 邻居的 MAC 地址
  • VRF,如果已配置,则为邻居的 VRF
  • 此地址是邻居拥有的还是主机学习到的
  • 上述任何项目上次发生更改的时间

语法

提供两组 IP 邻居命令,一组用于 IPv4,另一组用于 IPv6。

netq show ip neighbors
    [<remote-interface>]
    [<ipv4>|<ipv4> vrf <vrf>|vrf <vrf>]
    [<mac>]
    [around <text-time>]
    [json]

netq <hostname> show ip neighbors
    [<remote-interface>]
    [<ipv4>|<ipv4> vrf <vrf>|vrf <vrf>]
    [<mac>]
    [around <text-time>]
    [count]
    [json]

netq show ipv6 neighbors
    [<remote-interface>]
    [<ipv6>|<ipv6> vrf <vrf>|vrf <vrf>]
    [<mac>]
    [around <text-time>]
    [json]

netq <hostname> show ipv6 neighbors
    [<remote-interface>]
    [<ipv6>|<ipv6> vrf <vrf>|vrf <vrf>]
    [<mac>]
    [around <text-time>]
    [count]
    [json]

必需参数

参数描述
NA<hostname>仅显示此名称的交换机或主机的结果
ipNA显示 TCP IPv4 邻居
ipv6NA显示 TCP IPv6 邻居

选项

选项描述
NA<remote-interface>仅显示具有此接口的交换机和主机的结果
NA<ipv4>仅显示具有此 IPv4 地址的交换机和主机的结果
NA<ipv4> vrf <vrf>仅显示具有此 IPv4 地址和虚拟路由转发接口的交换机或主机的结果
NA<ipv6>仅显示具有此 IPv6 地址的交换机和主机的结果
NA<ipv6> vrf <vrf>仅显示具有此 IPv6 地址和 VRF 的交换机和主机的结果
vrf<vrf>仅显示使用此 VRF 的交换机和主机的结果
NA<mac>仅显示具有此 MAC 地址的交换机和主机的结果
around<text-time>

指示磁盘利用率信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示 spine01 交换机上的所有 IPv4 邻居

cumulus@switch:~$ netq show ip neighbors
Matching neighbor records:
IP Address                Hostname          Interface                 MAC Address        VRF             Remote Last Changed
------------------------- ----------------- ------------------------- ------------------ --------------- ------ -------------------------
169.254.0.1               spine04           swp1                      44:38:39:00:00:08  default         no     Thu Dec  3 22:29:18 2020
169.254.0.1               spine04           swp6                      44:38:39:00:00:30  default         no     Thu Dec  3 22:29:18 2020
169.254.0.1               spine04           swp5                      44:38:39:00:00:28  default         no     Thu Dec  3 22:29:18 2020
192.168.200.1             spine04           eth0                      44:38:39:00:00:6d                  no     Fri Dec  4 19:41:35 2020
169.254.0.1               spine04           swp4                      44:38:39:00:00:20  default         no     Thu Dec  3 22:29:18 2020
169.254.0.1               spine04           swp3                      44:38:39:00:00:18  default         no     Thu Dec  3 22:29:18 2020
169.254.0.1               spine04           swp2                      44:38:39:00:00:10  default         no     Thu Dec  3 22:29:18 2020
192.168.200.24            spine04           mgmt                      c6:b3:15:1d:84:c4                  no     Thu Dec  3 22:29:18 2020
192.168.200.250           spine04           eth0                      44:38:39:00:01:80                  no     Thu Dec  3 22:29:18 2020
169.254.0.1               spine03           swp1                      44:38:39:00:00:06  default         no     Thu Dec  3 22:31:27 2020
169.254.0.1               spine03           swp6                      44:38:39:00:00:2e  default         no     Thu Dec  3 22:31:27 2020
169.254.0.1               spine03           swp5                      44:38:39:00:00:26  default         no     Thu Dec  3 22:31:27 2020
...

以下示例显示了使用 RED VRF 的所有 IPv4 邻居。请注意,VRF 名称区分大小写。

cumulus@switch:~$ netq show ip neighbors vrf RED
Matching neighbor records:
IP Address                Hostname          Interface                 MAC Address        VRF             Remote Last Changed
------------------------- ----------------- ------------------------- ------------------ --------------- ------ -------------------------
10.1.10.2                 leaf04            vlan10                    44:38:39:00:00:5d  RED             no     Mon Oct 19 22:28:47 2020
10.1.20.2                 leaf04            vlan20                    44:38:39:00:00:5d  RED             no     Mon Oct 19 22:28:47 2020
10.1.10.3                 leaf03            vlan10                    44:38:39:00:00:5e  RED             no     Mon Oct 19 22:28:18 2020
10.1.20.3                 leaf03            vlan20                    44:38:39:00:00:5e  RED             no     Mon Oct 19 22:28:18 2020
10.1.10.2                 leaf02            vlan10                    44:38:39:00:00:59  RED             no     Mon Oct 19 22:28:30 2020
10.1.20.2                 leaf02            vlan20                    44:38:39:00:00:59  RED             no     Mon Oct 19 22:28:30 2020
10.1.10.3                 leaf01            vlan10                    44:38:39:00:00:37  RED             no     Mon Oct 19 22:28:22 2020
10.1.20.3                 leaf01            vlan20                    44:38:39:00:00:37  RED             no     Mon Oct 19 22:28:22 2020

显示 leaf03 交换机上的所有 IPv6 地址

cumulus@switch:~$ netq leaf03 show ipv6 neighbors
Matching neighbor records:
IP Address                Hostname          Interface                 MAC Address        VRF             Remote Last Changed
------------------------- ----------------- ------------------------- ------------------ --------------- ------ -------------------------
ff02::16                  leaf03            eth0                      33:33:00:00:00:16                  no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:32   leaf03            vlan10-v0                 44:38:39:00:00:32  RED             no     Thu Dec  3 22:28:59 2020
ff02::1                   leaf03            mgmt                      33:33:00:00:00:01                  no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:febe:efbb leaf03            vlan4001                  44:38:39:be:ef:bb  RED             no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:3a   leaf03            vlan20-v0                 44:38:39:00:00:34  RED             no     Thu Dec  3 22:28:59 2020
ff02::1:ff00:184          leaf03            eth0                      33:33:ff:00:01:84                  no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:3c   leaf03            vlan30                    44:38:39:00:00:36  BLUE            yes    Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:13   leaf03            swp52                     44:38:39:00:00:13  default         no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:5e   leaf03            vlan30                    44:38:39:00:00:5e  BLUE            no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:42   leaf03            vlan30-v0                 44:38:39:00:00:42  BLUE            no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:44   leaf03            vlan10                    44:38:39:00:00:3e  RED             no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:5e   leaf03            vlan10                    44:38:39:00:00:5e  RED             no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:3c   leaf03            vlan30-v0                 44:38:39:00:00:36  BLUE            no     Thu Dec  3 22:28:59 2020
fe80::4638:39ff:fe00:17   leaf03            swp54                     44:38:39:00:00:17  default         no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:5e   leaf03            vlan20                    44:38:39:00:00:5e  RED             no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:32   leaf03            vlan10                    44:38:39:00:00:32  RED             yes    Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:190  leaf03            eth0                      44:38:39:00:01:90                  no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:40   leaf03            vlan20-v0                 44:38:39:00:00:40  RED             no     Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:3a   leaf03            vlan20                    44:38:39:00:00:34  RED             yes    Thu Dec  3 22:28:58 2020
fe80::4638:39ff:fe00:180  leaf03            eth0                      44:38:39:00:01:80                  no     Thu Dec  3 22:28:58 2020
...
  • netq show ip/ipv6 addresses
  • netq show ip routes

netq show ip routes

显示为给定设备或全网络所有设备配置的 IPv4 或 IPv6 路由,可以是当前或过去某个时间点。您可以按远程接口、地址、地址和前缀、VRF 以及路由来源筛选输出。您可以获取给定设备的路由计数。输出为每条路由提供以下信息

  • 此路由是否源自此设备
  • 用于路由的 VRF
  • 用于路由的地址前缀
  • 具有路由的设备的主机名
  • 路由采用的下一跳
  • 上述任何项目上次发生更改的时间

语法

提供两组 IP 路由命令,一组用于 IPv4,另一组用于 IPv6。

netq <hostname> show ip routes
    [<ipv4>|<ipv4/prefixlen>]
    [vrf <vrf>]
    [origin <text-origin>]
    [edge]
    [around <text-time>]
    [count]
    [json]

netq show ip routes
    [<ipv4>|<ipv4/prefixlen>]
    [vrf <vrf>]
    [origin <text-origin>]
    [edge]
    [around <text-time>]
    [json]

netq <hostname> show ipv6 routes
    [<ipv6>|<ipv6/prefixlen>]
    [vrf <vrf>]
    [origin <text-origin>]
    [edge]
    [around <text-time>]
    [count]
    [json]

netq show ipv6 routes
    [<ipv6>|<ipv6/prefixlen>]
    [vrf <vrf>]
    [origin <text-origin>]
    [edge]
    [around <text-time>]
    [json]

必需参数

参数描述
NA<hostname>仅显示此名称的交换机或主机的结果
ipNA显示 TCP IPv4 路由
ipv6NA显示 TCP IPv6 路由

选项

选项描述
NA<remote-interface>仅显示具有此接口的交换机和主机的结果
NA<ipv4>仅显示具有此 IPv4 地址的交换机和主机的结果
NA<ipv4/prefixlen>仅显示具有此 IPv4 地址和前缀的交换机或主机的结果
NA<ipv6>仅显示具有此 IPv6 地址的交换机和主机的结果
NA<ipv6/prefixlen>仅显示具有此 IPv6 地址和前缀的交换机和主机的结果
vrf<vrf>仅显示使用此 VRF 的交换机和主机的结果
来源<text-origin>显示此路由是否源自交换机或主机(真)
边缘NA显示从主机和未运行 Cumulus Linux 的网络设备学习路由的边缘交换机
around<text-time>

指示磁盘利用率信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

countNA显示给定交换机或主机的路由计数
jsonNA以 JSON 格式显示输出

用法示例

显示所有 IPv4 路由

cumulus@switch:~$ netq show ip routes

Matching routes records:
Origin VRF             Prefix                         Hostname          Nexthops                            Protocol     Last Changed
------ --------------- ------------------------------ ----------------- ----------------------------------- ------------ -------------------------
false  DataVrf1080     0.0.0.0/0                      torc-22           Blackhole                           boot         Wed Jul 10 20:33:19 2024
false  DataVrf1080     27.0.0.1/32                    torc-22           fe80::202:ff:fe00:72: swp3.2,       bgp          Wed Jul 10 20:33:19 2024
                                                                        fe80::202:ff:fe00:7c: swp4.2,
                                                                        fe80::202:ff:fe00:86: swp5.2
false  DataVrf1080     27.0.0.19/32                   torc-22           fe80::202:ff:fe00:72: swp3.2,       bgp          Wed Jul 10 20:33:19 2024
                                                                        fe80::202:ff:fe00:7c: swp4.2,
                                                                        fe80::202:ff:fe00:86: swp5.2
false  DataVrf1080     27.0.0.2/32                    torc-22           fe80::202:ff:fe00:72: swp3.2,       bgp          Wed Jul 10 20:33:19 2024
                                                                        fe80::202:ff:fe00:7c: swp4.2,
                                                                        fe80::202:ff:fe00:86: swp5.2
false  DataVrf1080     27.0.0.20/32                   torc-22           fe80::202:ff:fe00:72: swp3.2,       bgp          Wed Jul 10 20:33:19 2024
...

以下示例显示了给定 IP 地址可用的路由。

cumulus@switch:~$ netq show ip routes 27.0.0.24/32
Matching routes records:
Origin VRF             Prefix                         Hostname          Nexthops                            Protocol     Last Changed
------ --------------- ------------------------------ ----------------- ----------------------------------- ------------ -------------------------
false  default         27.0.0.24/32                   torc-22           fe80::202:ff:fe00:72: swp3,         bgp          Wed Jul 10 20:33:19 2024
                                                                        fe80::202:ff:fe00:7c: swp4,
                                                                        fe80::202:ff:fe00:86: swp5
false  default         27.0.0.24/32                   torc-21           fe80::202:ff:fe00:71: swp3,         bgp          Thu Jul 11 18:59:07 2024
                                                                        fe80::202:ff:fe00:7b: swp4,
                                                                        fe80::202:ff:fe00:85: swp5
false  default         27.0.0.24/32                   torc-12           fe80::202:ff:fe00:70: swp3,         bgp          Thu Jul 11 19:11:55 2024
                                                                        fe80::202:ff:fe00:7a: swp4,
                                                                        fe80::202:ff:fe00:84: swp5
true   default         27.0.0.24/32                   torc-11           lo                                  kernel       Wed Jul 10 21:22:13 2024
false  default         27.0.0.24/32                   tor-2             fe80::202:ff:fe00:74: swp3,         bgp          Wed Jul 10 21:32:35 2024
                                                                        fe80::202:ff:fe00:7e: swp4,
                                                                        fe80::202:ff:fe00:88: swp5
false  default         27.0.0.24/32                   tor-1             fe80::202:ff:fe00:73: swp3,         bgp          Thu Jul 11 19:38:17 2024
...

显示给定交换机上的所有 IPv6 路由

cumulus@switch:~$ netq torc-22 show ipv6 routes

Matching routes records:
Origin VRF             Prefix                         Hostname          Nexthops                            Protocol     Last Changed
------ --------------- ------------------------------ ----------------- ----------------------------------- ------------ -------------------------
false  DataVrf1080     2001:c15c:d06:f00d::1/128      torc-22           fe80::202:ff:fe00:72: swp3.2,       bgp          Wed Jul 10 20:33:19 2024
                                                                        fe80::202:ff:fe00:7c: swp4.2,
                                                                        fe80::202:ff:fe00:86: swp5.2
false  DataVrf1080     2001:c15c:d06:f00d::2/128      torc-22           fe80::202:ff:fe00:72: swp3.2,       bgp          Wed Jul 10 20:33:19 2024
                                                                        fe80::202:ff:fe00:7c: swp4.2,
                                                                        fe80::202:ff:fe00:86: swp5.2
false  DataVrf1080     2001:c15c:d06:f00d::3/128      torc-22           fe80::202:ff:fe00:72: swp3.2,       bgp          Wed Jul 10 20:33:19 2024
                                                                        fe80::202:ff:fe00:7c: swp4.2,
                                                                        fe80::202:ff:fe00:86: swp5.2
false  DataVrf1080     2001:c15c:d06:f00d::4/128      torc-22           fe80::202:ff:fe00:72: swp3.2,       bgp          Wed Jul 10 20:33:19 2024
...

以下示例显示了 exit-1 交换机拥有的所有 IPv4 路由

cumulus@switch:~$ netq exit-1 show ip routes origin true

Matching routes records:
Origin VRF             Prefix                         Hostname          Nexthops                            Protocol     Last Changed
------ --------------- ------------------------------ ----------------- ----------------------------------- ------------ -------------------------
true   DataVrf1080     30.0.0.1/32                    exit-1            DataVrf1080                         kernel       Wed Jul 10 21:03:11 2024
true   DataVrf1081     30.0.1.1/32                    exit-1            DataVrf1081                         kernel       Wed Jul 10 21:03:11 2024
true   DataVrf1082     30.0.2.1/32                    exit-1            DataVrf1082                         kernel       Wed Jul 10 21:03:11 2024
true   default         27.0.0.1/32                    exit-1            lo                                  kernel       Wed Jul 10 21:03:11 2024
true   mgmt            192.168.0.0/24                 exit-1            eth0                                kernel       Wed Jul 10 21:03:11 2024
true   mgmt            192.168.0.15/32                exit-1            eth0                                kernel       Wed Jul 10 21:03:11 2024
true   mgmt            45.0.0.0/26                    exit-1            NetQBond-1                          kernel       Wed Jul 10 21:03:11 2024
true   mgmt            45.0.0.15/32                   exit-1            NetQBond-1                          kernel       Wed Jul 10 21:03:11 2024

此示例显示了 leaf01 交换机上所有设备的 IPv4 和 IPv6 路由总数。

cumulus@switch:~$ netq leaf01 show ip routes count
Count of matching routes records: 27
    
cumulus@switch:~$ netq leaf01 show ipv6 routes count
Count of matching routes records: 3
  • netq show ip/ipv6 addresses
  • netq show ip/ipv6 neighbors

netq show lldp

显示网络结构中所有节点或特定节点上所有 LLDP 会话或单个会话的运行状况,可以是当前或过去某个时间点。您可以筛选输出以显示特定对等接口端口的会话。输出为每个会话提供以下信息

  • 本地设备上的接口
  • 对等设备的主机名和接口
  • 上述任何项目上次发生更改的时间

语法

netq [<hostname>] show lldp
    [<remote-physical-interface>]
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
NA<remote-physical-interface>仅显示使用此名称接口端口的会话的结果
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 文件格式显示输出

用法示例

此示例显示了 Cumulus 参考拓扑,其中 LLDP 在所有边界、防火墙、叶和脊交换机、服务器(包括带外管理服务器)上运行。

cumulus@switch:~$ netq show lldp

Matching lldp records:
Hostname          Interface                 Peer Hostname     Peer Interface            Last Changed
----------------- ------------------------- ----------------- ------------------------- -------------------------
exit-1            swp2                      noc-se            swp5                      Wed Jul 10 17:38:18 2024
exit-1            swp5                      spine-3           swp9                      Wed Jul 10 17:38:18 2024
exit-1            swp6                      firewall-1        swp3                      Wed Jul 10 17:38:18 2024
exit-1            swp3                      spine-1           swp9                      Wed Jul 10 17:38:18 2024
exit-1            swp4                      spine-2           swp9                      Wed Jul 10 17:38:18 2024
exit-1            swp1                      noc-pr            swp5                      Wed Jul 10 17:38:18 2024
exit-1            swp7                      firewall-2        swp3                      Wed Jul 10 17:38:18 2024
exit-2            swp7                      firewall-2        swp4                      Wed Jul 10 16:17:11 2024
exit-2            swp3                      spine-1           swp10                     Wed Jul 10 16:17:11 2024
...

显示给定主机接口端口的会话

cumulus@switch:~$ netq show lldp swp5
Matching lldp records:
Hostname          Interface                 Peer Hostname     Peer Interface            Last Changed
----------------- ------------------------- ----------------- ------------------------- -------------------------
spine01           swp5                      border01          swp51                     Fri Nov 20 10:28:20 2020
spine02           swp5                      border01          swp52                     Fri Nov 20 10:33:41 2020
spine03           swp5                      border01          swp53                     Fri Nov 20 10:28:32 2020
spine04           swp5                      border01          swp54                     Fri Nov 20 10:24:07 2020
  • netq show events
  • netq check lldp

netq show mac-commentary

显示有关给定 VLAN 上给定 MAC 地址更改的描述性信息,包括以下与 MAC 地址相关的事件的注释

  • 何时配置或取消配置 MAC 地址
  • 何时将绑定接口设为从属接口或从从属接口中移除
  • 桥接器成员资格何时更改
  • 何时通过隧道接口上的控制平面学习或安装 MAC 地址
  • 何时刷新或过期 MAC 地址
  • 何时移动 MAC 地址

语法

netq [<hostname>] show mac-commentary
    <mac>
    vlan <1-4096>
    [between <text-time> and <text-endtime>]
    [json]

必需参数

参数描述
NA<mac>显示此 MAC 地址的 MAC 移动的描述性摘要
vlan<1-4096>显示具有此 ID 的 VLAN 的 MAC 移动的描述性摘要

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
between<text-time> 和 <text-endtime>

仅显示这两个时间之间的结果。时间必须包含数值度量单位

  • w: 周
  • d: 天
  • h: 小时
  • m: 分钟
  • s: 秒
  • now

您可以输入开始时间 (text-time) 和结束时间 (text-endtime) 值,最近的时间在前,最旧的时间在后,反之亦然。这些值不必具有相同的度量单位。

jsonNA以 JSON 格式显示输出

用法示例

cumulus@switch:~$ netq show mac-commentary 33:33:00:00:00:01 vlan 104

Matching mac_commentary records:
Last Updated              Hostname         VLAN   Commentary
------------------------- ---------------- ------ --------------------------------------------------------------------------------
Thu Jul 11 19:32:00 2024  hosts-11         104    33:33:00:00:00:01 configured on interface swp1.104
  • netq show mac-history
  • netq show ip/ipv6 addresses

netq show mac-history

显示何时学习 MAC 地址,之后在网络中移动的时间和位置,以及是否在任何时候存在重复项等。默认情况下,命令在输出中按 VLAN 和时间戳(按时间顺序)分组显示各种历史线程。默认时间范围是现在和一小时前之间。

语法

netq [<hostname>] show mac-history
    <mac>
    [vlan <1-4096>]
    [diff]
    [between <text-time> and <text-endtime>]
    [listby <text-list-by>]
    [json]

必需参数

参数描述
NA<mac>显示此 MAC 地址的历史记录

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
vlan<1-4096>仅显示具有此 ID 的 VLAN 的 MAC 更改
diffNA仅显示在 between 选项定义的时间范围内发生的更改子集
between<text-time> 和 <text-endtime>

仅显示这两个时间之间的结果。时间必须包含数值度量单位

  • w: 周
  • d: 天
  • h: 小时
  • m: 分钟
  • s: 秒
  • now

您可以输入开始时间 (text-time) 和结束时间 (text-endtime) 值,最近的时间在前,最旧的时间在后,反之亦然。这些值不必具有相同的度量单位。

listby<text-list-by>基于指定的输出字段以组的形式显示输出
jsonNA以 JSON 格式显示输出

用法示例

此示例显示了如何查看 44:38:39:00:00:5d MAC 地址的完整更改时间线。显示时,插入符号 (^) 表示此值与上一行相比没有变化。

cumulus@switch:~$ netq show mac-history 44:38:39:00:00:5d
Matching machistory records:
Last Changed              Hostname          VLAN   Origin Link             Destination            Remote Static
------------------------- ----------------- ------ ------ ---------------- ---------------------- ------ ------------
Tue Oct 27 22:28:24 2020  leaf03            10     yes    bridge                                  no     no
Tue Oct 27 22:28:42 2020  leaf01            10     no     vni10            10.0.1.2               no     yes
Tue Oct 27 22:28:51 2020  leaf02            10     no     vni10            10.0.1.2               no     yes
Tue Oct 27 22:29:07 2020  leaf04            10     no     peerlink                                no     yes
Tue Oct 27 22:28:24 2020  leaf03            4002   yes    bridge                                  no     no
Tue Oct 27 22:28:24 2020  leaf03            0      yes    peerlink                                no     no
Tue Oct 27 22:28:24 2020  leaf03            20     yes    bridge                                  no     no
Tue Oct 27 22:28:42 2020  leaf01            20     no     vni20            10.0.1.2               no     yes
Tue Oct 27 22:28:51 2020  leaf02            20     no     vni20            10.0.1.2               no     yes
Tue Oct 27 22:29:07 2020  leaf04            20     no     peerlink                                no     yes
Tue Oct 27 22:28:24 2020  leaf03            4001   yes    bridge                                  no     no
Tue Oct 27 22:28:24 2020  leaf03            30     yes    bridge                                  no     no
Tue Oct 27 22:28:42 2020  leaf01            30     no     vni30            10.0.1.2               no     yes
Tue Oct 27 22:28:51 2020  leaf02            30     no     vni30            10.0.1.2               no     yes
Tue Oct 27 22:29:07 2020  leaf04            30     no     peerlink                                no     yes

此示例仅显示了 44:38:39:00:00:5d MAC 地址在现在和一小时前之间的更改差异。

cumulus@switch:~$ netq show mac-history 44:38:39:00:00:5d diff
Matching machistory records:
Last Changed              Hostname          VLAN   Origin Link             Destination            Remote Static
------------------------- ----------------- ------ ------ ---------------- ---------------------- ------ ------------
Tue Oct 27 22:29:07 2020  leaf04            30     no     peerlink                                no     yes

此示例仅显示了 44:38:39:00:00:5d MAC 地址在现在和 30 天前之间的更改差异。插入符号 (^) 表示此值与上一行相比没有变化。

cumulus@switch:~$ netq show mac-history 44:38:39:00:00:5d diff between now and 30d
Matching machistory records:
Last Changed              Hostname          VLAN   Origin Link             Destination            Remote Static
------------------------- ----------------- ------ ------ ---------------- ---------------------- ------ ------------
Mon Sep 28 00:02:26 2020  leaf04            30     no     peerlink                                no     no
Tue Oct 27 22:29:07 2020  leaf04            ^      ^      ^                ^                      ^      yes

此示例显示了 44:38:39:00:00:5d MAC 地址和 VLAN 10 的更改。

cumulus@switch:~$ netq show mac-history 44:38:39:00:00:5d vlan 10
Matching machistory records:
Last Changed              Hostname          VLAN   Origin Link             Destination            Remote Static
------------------------- ----------------- ------ ------ ---------------- ---------------------- ------ ------------
Tue Oct 27 22:28:24 2020  leaf03            10     yes    bridge                                  no     no
Tue Oct 27 22:28:42 2020  leaf01            10     no     vni10            10.0.1.2               no     yes
Tue Oct 27 22:28:51 2020  leaf02            10     no     vni10            10.0.1.2               no     yes
Tue Oct 27 22:29:07 2020  leaf04            10     no     peerlink                                no     yes
  • netq show mac-commentary
  • netq show ip/ipv6 addresses

netq show macs

显示全网络受监控交换机的 MAC 地址,可以是当前或过去某个时间点。对于给定的交换机,您可以查看与该交换机关联的 MAC 地址总数。您可以根据 VLAN、出口端口和来源状态筛选输出。

输出显示每个 MAC 地址的以下信息

  • 交换机是否拥有此地址或对等方是否学习了此地址
  • 与给定交换机的此地址关联的 VLAN
  • 使用此地址的交换机
  • 交换机上的出口端口
  • 上述任何项目上次发生更改的时间

此命令不显示主机的 MAC 地址。

语法

此命令有三种形式可用:基本命令(显示全网络所有 MAC 地址)、查看给定交换机的 MAC 地址或地址计数的命令,以及查看给定交换机和出口端口上的 MAC 地址的命令。

netq show macs
    [<mac>]
    [vlan <1-4096>]
    [origin <text-origin>]
    [around <text-time>]
    [json]

netq <hostname> show macs
    [<mac>]
    [vlan <1-4096>]
    [origin <text-origin> | count]
    [around <text-time>]
    [json]

netq <hostname> show macs
    egress-port <egress-port>
    [<mac>]
    [vlan <1-4096>]
    [origin <text-origin>]
    [around <text-time>]
    [json]

必需参数

参数描述
NA<hostname>仅显示此名称的交换机的结果
出口端口<egress-port>仅显示具有此出口端口的交换机的结果

选项

选项描述
NA<mac>显示此 MAC 地址的历史记录
vlan<1-4096>仅显示使用此 ID 的 VLAN 的 MAC 地址
来源<text-origin>显示源自设备 (true) 或非源自设备 (false) 的 MAC 地址
countNA显示指定交换机使用的 MAC 地址总数;仅当您定义 hostname 选项时才能使用此选项
around<text-time>

指示磁盘利用率信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 文件格式显示输出

用法示例

显示交换机上 MAC 地址的计数

cumulus@switch:~$ netq leaf01 show macs count
Count of matching mac records: 50

显示全网络所有 MAC 地址

cumulus@switch:~$ netq show macs
Matching mac records:
Origin MAC Address        VLAN   Hostname          Egress Port                    Remote Last Changed
------ ------------------ ------ ----------------- ------------------------------ ------ -------------------------
true   00:00:00:00:00:00  1001   torc-22           vx-33:tor-2                    no     Wed Jul 10 20:33:21 2024
true   00:00:00:00:00:00  1003   torc-22           vx-35:tor-2                    no     Wed Jul 10 20:33:21 2024
true   00:00:00:00:00:00  1005   torc-22           vx-37:tor-2                    no     Wed Jul 10 20:33:21 2024
true   00:00:00:00:00:00  1007   torc-22           vx-39:tor-2                    no     Wed Jul 10 20:33:21 2024
true   00:00:00:00:00:00  1009   torc-22           vx-41:tor-2                    no     Wed Jul 10 20:33:21 2024
true   00:00:5e:00:01:01  0      torc-22           VlanA-1                        no     Wed Jul 10 20:33:21 2024
true   00:00:5e:00:01:01  100    torc-22           VlanA-1.100                    no     Wed Jul 10 20:33:21 2024
true   00:00:5e:00:01:01  1001   torc-22           vlan1001                       no     Wed Jul 10 20:33:21 2024
true   00:00:5e:00:01:01  1003   torc-22           vlan1003                       no     Wed Jul 10 20:33:21 2024
true   00:00:5e:00:01:01  1005   torc-22           vlan1005                       no     Wed Jul 10 20:33:21 2024
true   00:00:5e:00:01:01  1007   torc-22           vlan1007                       no     Wed Jul 10 20:33:21 2024
true   00:00:5e:00:01:01  1009   torc-22           vlan1009                       no     Wed Jul 10 20:33:21 2024
...
false  00:02:00:00:00:24  106    torc-22           {hostbond3}:{hostd-22}         no     Wed Jul 10 20:33:21 2024
false  00:02:00:00:00:30  1001   torc-22           vx-33:tor-2                    yes    Wed Jul 10 20:33:21 2024

显示在交换机上使用给定出口端口的 MAC 地址

cumulus@switch:~$ netq torc-22 show macs egress-port VlanA-1.100
Matching mac records:
Origin MAC Address        VLAN   Hostname          Egress Port                    Remote Last Changed
------ ------------------ ------ ----------------- ------------------------------ ------ -------------------------
true   00:00:5e:00:01:01  100    torc-22           VlanA-1.100                    no     Wed Jul 10 20:33:21 2024

显示与给定 VLAN 关联的 MAC 地址。该命令还提供设备的主机名、接口的出口端口、MAC 地址是否源自给定设备、是否从对等方学习 MAC 地址 (remote=yes) 以及上次配置更改的时间。

cumulus@switch:~$ netq show macs vlan 102
Matching mac records:
Origin MAC Address        VLAN   Hostname          Egress Port                    Remote Last Changed
------ ------------------ ------ ----------------- ------------------------------ ------ -------------------------
true   00:00:5e:00:01:01  102    torc-22           VlanA-1.102                    no     Wed Jul 10 20:33:21 2024
false  00:02:00:00:00:20  102    torc-22           {hostbond2}:{hostd-21}         no     Wed Jul 10 20:33:21 2024
false  00:02:00:00:00:24  102    torc-22           {hostbond3}:{hostd-22}         no     Wed Jul 10 20:33:21 2024
false  00:02:00:00:00:b0  102    torc-22           {peerlink-1}:{torc-21}         no     Wed Jul 10 20:33:21 2024
true   00:02:00:00:00:b8  102    torc-22           VlanA-1                        no     Wed Jul 10 20:33:21 2024
true   00:00:5e:00:01:01  102    torc-21           VlanA-1.102                    no     Thu Jul 11 18:59:08 2024
false  00:02:00:00:00:20  102    torc-21           {hostbond2}:{hostd-21}         no     Thu Jul 11 18:59:08 2024
false  00:02:00:00:00:24  102    torc-21           {hostbond3}:{hostd-22}         no     Thu Jul 11 18:59:08 2024
true   00:02:00:00:00:b0  102    torc-21           VlanA-1                        no     Thu Jul 11 18:59:08 2024
false  00:02:00:00:00:b8  102    torc-21           {peerlink-1}:{torc-22}         no     Thu Jul 11 18:59:08 2024
true   00:00:5e:00:01:01  102    torc-12           VlanA-1.102                    no     Thu Jul 11 19:11:56 2024
true   00:02:00:00:00:a8  102    torc-12           VlanA-1                        no     Thu Jul 11 19:11:56 2024
...

以下示例显示了与 leaf02 交换机和 VLAN 10 关联的 MAC 地址,这些地址使用桥接端口。

cumulus@netq-ts:~$ netq leaf02 show macs egress-port bridge vlan 10
Matching mac records:
Origin MAC Address        VLAN   Hostname          Egress Port                    Remote Last Changed
------ ------------------ ------ ----------------- ------------------------------ ------ -------------------------
true    00:00:00:00:00:1a  10     leaf02            bridge                         no     Tue Oct 27 22:28:51 2020 
  • netq show mac-commentary
  • netq show mac-history

netq show mlag

显示网络结构中所有节点或特定节点上所有 MLAG 会话或单个会话的运行状况,可以是当前或过去某个时间点。输出提供

  • 给定节点的对等节点
  • 用于节点之间会话的系统 MAC 地址
  • 会话的运行状态(启动或关闭)
  • 备份 IP 地址的运行状态(启动或关闭)
  • 绑定总数
  • 双连接绑定的数量
  • 上述任何项目上次发生更改的时间

如果绑定总数与双连接绑定的数量不匹配,则可能存在配置问题。

语法

netq [<hostname>] show mlag
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 文件格式显示输出

用法示例

cumulus@switch:~$ netq show mlag
Matching clag records:
Hostname          Peer              SysMac             State      Backup #Bond #Dual Last Changed
                                                                         s
----------------- ----------------- ------------------ ---------- ------ ----- ----- -------------------------
border01(P)       border02          44:38:39:be:ef:ff  up         up     3     3     Thu Nov 19 22:33:48 2020
border02          border01(P)       44:38:39:be:ef:ff  up         up     3     3     Thu Nov 19 22:29:24 2020
leaf01(P)         leaf02            44:38:39:be:ef:aa  up         up     8     8     Thu Nov 19 22:29:16 2020
leaf02            leaf01(P)         44:38:39:be:ef:aa  up         up     8     8     Thu Nov 19 22:39:27 2020
leaf03(P)         leaf04            44:38:39:be:ef:bb  up         up     8     8     Fri Nov 20 11:10:35 2020
leaf04            leaf03(P)         44:38:39:be:ef:bb  up         up     8     8     Fri Nov 20 11:11:24 2020
  • netq show events type clag
  • netq check mlag
  • netq show unit-tests mlag

netq show neighbor-history

显示 IP 地址的邻居配置何时更改。默认情况下,更改按时间顺序显示。您可以按时间和接口筛选输出,并且可以选择仅查看差异或按历史线程对输出进行分组。

输出为每个邻居更改提供以下信息

  • 邻居配置何时更改
  • 与更改关联的交换机
  • 邻居使用的接口
  • 邻居使用的 VRF
  • 交换机是否拥有地址或邻居是否学习了地址
  • IP 和 MAC 地址
  • IP 地址是 IPv4 地址还是 IPv6 地址
  • IP 接口地址的索引

默认情况下,输出中的每一行都是一个线程(或组),按 VLAN 排序,使用的时间范围是从现在到一小时前。

语法

netq [<hostname>] show neighbor-history
    <text-ipaddress>
    [ifname <text-ifname>]
    [diff]
    [between <text-time> and <text-endtime>]
    [listby <text-list-by>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机的结果
NA<text-ipaddress>显示此 IPv4 或 IPv6 地址的历史记录
ifname<text-ifname>仅显示此名称的接口的结果
diffNA仅显示与每次更改关联的差异
between<text-time> 和 <text-endtime>仅显示在这些时间拍摄的快照之间的结果
listby<text-list-by>按指定的属性显示结果。属性包括接口名称或索引、VRF 名称、远程状态、MAC 地址(如果地址是 IPv6 地址)和主机名。
jsonNA以 JSON 格式显示输出

用法示例

以下示例显示了 IP 地址邻居的完整更改时间线。插入符号 (^) 表示上一行中的值没有更改。

cumulus@switch:~$ netq show neighbor-history 10.1.10.2

Matching neighborhistory records:
Last Changed              Hostname          Ifname       Vrf             Remote Ifindex        Mac Address        Ipv6     Ip Address
------------------------- ----------------- ------------ --------------- ------ -------------- ------------------ -------- -------------------------
Tue Sep 29 17:25:08 2020  leaf02            vlan10       RED             no     24             44:38:39:00:00:59  no       10.1.10.2
Tue Sep 29 17:25:17 2020  leaf04            vlan10       RED             no     24             44:38:39:00:00:5d  no       10.1.10.2

以下示例按主机名显示了 IP 地址邻居的历史记录。

cumulus@switch:~$ netq show neighbor-history 10.1.10.2 listby hostname

Matching neighborhistory records:
Last Changed              Hostname          Ifname       Vrf             Remote Ifindex        Mac Address        Ipv6     Ip Address
------------------------- ----------------- ------------ --------------- ------ -------------- ------------------ -------- -------------------------
Tue Sep 29 17:25:08 2020  leaf02            vlan10       RED             no     24             44:38:39:00:00:59  no       10.1.10.2
Tue Sep 29 17:25:17 2020  leaf04            vlan10       RED             no     24             44:38:39:00:00:5d  no       10.1.10.2

以下示例显示了现在和两小时前之间的 IP 地址邻居的历史记录。

cumulus@switch:~$ netq show neighbor-history 10.1.10.2 between 2h and now

Matching neighborhistory records:
Last Changed              Hostname          Ifname       Vrf             Remote Ifindex        Mac Address        Ipv6     Ip Address
------------------------- ----------------- ------------ --------------- ------ -------------- ------------------ -------- -------------------------
Tue Sep 29 15:35:18 2020  leaf02            vlan10       RED             no     24             44:38:39:00:00:59  no       10.1.10.2
Tue Sep 29 15:35:22 2020  leaf04            vlan10       RED             no     24             44:38:39:00:00:5d  no       10.1.10.2
Tue Sep 29 17:25:00 2020  leaf02            vlan10       RED             no     24             44:38:39:00:00:59  no       10.1.10.2
Tue Sep 29 17:25:08 2020  leaf04            vlan10       RED             no     24             44:38:39:00:00:5d  no       10.1.10.2
Tue Sep 29 17:25:08 2020  leaf02            vlan10       RED             no     24             44:38:39:00:00:59  no       10.1.10.2
Tue Sep 29 17:25:14 2020  leaf04            vlan10       RED             no     24             44:38:39:00:00:5d  no       10.1.10.2
  • netq show address-history
  • netq show mac-history

netq show notification

显示通知通道、过滤器、规则或代理(如果已配置)的配置。受支持的通知通道包括电子邮件、PagerDuty、Slack 和 syslog。输出因您要查看的组件而异。有关更多信息,请参阅 配置系统事件通知

语法

netq show notification
    (channel|filter|rule|proxy)
    [json]

必需参数

参数描述
通道NA显示所有通道配置
过滤器NA显示所有过滤器配置
规则NA显示所有规则配置
代理NA显示代理配置

选项

选项描述
jsonNA以 JSON 格式显示输出

用法示例

显示通知通道

cumulus@netq-ts:~$ netq show notification channel

Matching config_notify records:
Name            Type             Severity         Channel Info
--------------- ---------------- ---------------- ------------------------
cloud-email    email            error            password: TEiO98BOwlekUP
                                                     TrFev2/Q==, port: 587,
                                                     isEncrypted: True,
                                                     host: netqsmtp.domain.com,
                                                     from: netqsmtphostlogin@doma
                                                     in.com,
                                                     id: smtphostlogin@domain
                                                     .com,
                                                     to: netq-notifications@d
                                                     omain.com
pd-netq-events  pagerduty        debug            integration_key: c6d666e
                                                  210a8425298ef7abde0d1998
slk-netq-events slack            debug            webhook: https://hooks.s
                                                  lack.com/services/text/m
                                                  oretext/evenmoretext
syslog-netq-eve syslog           debug            syslog_hostname: 10.10.2
nts                                               0.35, syslog_port: 514

显示规则

cumulus@switch:~$ netq show notification rule
Matching config_notify records:
Name            Rule Key         Rule Value
--------------- ---------------- --------------------
bgpHostname     hostname         spine-01
evpnVni         vni              42
fecSupport      new_supported_fe supported
                c
overTemp        new_s_crit       24
svcStatus       new_status       down
swp52           port             swp52
sysconf         configdiff       updated
  • netq add notification
  • netq del notification
  • netq add tca
  • netq del tca
  • netq show tca

netq show ntp

显示所有节点或特定节点是否与 NetQ 设备或 VM 同步时间,可以是当前或过去某个时间点。输出提供

  • 同步状态
  • 用于同步的当前时间服务器
  • 交换机或主机与参考时钟之间的层级级别数
  • 用于获取和同步节点上时钟的 NTP 应用程序

语法

netq [<hostname>] show ntp
    [out-of-sync | in-sync]
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
未同步NA仅显示与 NetQ 设备或 VM 不同步的设备的结果
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

以下示例显示了 NVIDIA 参考架构中所有设备的时间同步状态。

所有边界、叶和脊交换机都依赖于运行 ntpq 的带外管理服务器来提供其时间;它们都已同步。带外管理服务器使用运行 ntpqtitan.crash-ove 服务器来获取和维护时间同步。同时,NetQ 服务器使用运行 chronyceterna.binary.net 服务器来获取和维护时间同步。防火墙交换机未进行时间同步(这是预期的)。Stratum 值指示交换机或主机与参考时钟之间的层级级别数。

cumulus@switch:~$ netq show ntp
Matching ntp records:
Hostname          NTP Sync Current Server    Stratum NTP App
----------------- -------- ----------------- ------- ---------------------
border01          yes      oob-mgmt-server   3       ntpq
border02          yes      oob-mgmt-server   3       ntpq
fw1               no       -                 16      ntpq
fw2               no       -                 16      ntpq
leaf01            yes      oob-mgmt-server   3       ntpq
leaf02            yes      oob-mgmt-server   3       ntpq
leaf03            yes      oob-mgmt-server   3       ntpq
leaf04            yes      oob-mgmt-server   3       ntpq
netq-ts           yes      eterna.binary.net 2       chronyc
oob-mgmt-server   yes      titan.crash-ove   2       ntpq
server01          yes      oob-mgmt-server   3       ntpq
server02          yes      oob-mgmt-server   3       ntpq
server03          yes      oob-mgmt-server   3       ntpq
server04          yes      oob-mgmt-server   3       ntpq
server05          yes      oob-mgmt-server   3       ntpq
server06          yes      oob-mgmt-server   3       ntpq
server07          yes      oob-mgmt-server   3       ntpq
server08          yes      oob-mgmt-server   3       ntpq
spine01           yes      oob-mgmt-server   3       ntpq
spine02           yes      oob-mgmt-server   3       ntpq
spine03           yes      oob-mgmt-server   3       ntpq
spine04           yes      oob-mgmt-server   3       ntpq

显示网络中所有未进行时间同步的设备,因此需要进一步调查

cumulus@switch:~$ netq show ntp out-of-sync
Matching ntp records:
Hostname          NTP Sync Current Server    Stratum NTP App
----------------- -------- ----------------- ------- ---------------------
internet          no       -                 16      ntpq
  • netq check ntp
  • netq show events message_type ntp
  • netq show unit-tests ntp

netq show opta-health

显示在 NetQ 本地设备或虚拟机上运行的各种应用程序和服务的状态。对于 NetQ 云设备或 VM,此命令显示指示总体运行状况的简单语句。

请注意,在安装过程中运行此命令时,应用程序和服务需要 5 到 10 分钟才能完全运行。

语法

netq show opta-health
    [json]

必需参数

选项

选项描述
jsonNA以 JSON 格式显示输出

用法示例

本地设备或 VM

cumulus@hostname:~$ netq show opta-health
Application                                            Status    Namespace      Restarts    Timestamp
-----------------------------------------------------  --------  -------------  ----------  ------------------------
cassandra-rc-0-w7h4z                                   READY     default        0           Fri Apr 10 16:08:38 2020
cp-schema-registry-deploy-6bf5cbc8cc-vwcsx             READY     default        0           Fri Apr 10 16:08:38 2020
kafka-broker-rc-0-p9r2l                                READY     default        0           Fri Apr 10 16:08:38 2020
kafka-connect-deploy-7799bcb7b4-xdm5l                  READY     default        0           Fri Apr 10 16:08:38 2020
netq-api-gateway-deploy-55996ff7c8-w4hrs               READY     default        0           Fri Apr 10 16:08:38 2020
netq-app-address-deploy-66776ccc67-phpqk               READY     default        0           Fri Apr 10 16:08:38 2020
netq-app-admin-oob-mgmt-server                         READY     default        0           Fri Apr 10 16:08:38 2020
netq-app-bgp-deploy-7dd4c9d45b-j9bfr                   READY     default        0           Fri Apr 10 16:08:38 2020
netq-app-clagsession-deploy-69564895b4-qhcpr           READY     default        0           Fri Apr 10 16:08:38 2020
netq-app-configdiff-deploy-ff54c4cc4-7rz66             READY     default        0           Fri Apr 10 16:08:38 2020
...
  • netq show opta-platform

netq show opta-platform

显示交换机上运行的 NetQ 版本、运行时间以及上次重新初始化的时间。

语法

netq show opta-platform
    [json]

必需参数

选项

选项描述
jsonNA以 JSON 格式显示输出

用法示例

cumulus@nswitch:~$ netq show opta-platform
Matching platform records:
Version                              Uptime                    Reinitialize Time
------------------------------------ ------------------------- --------------------------
3.2.0                                Fri Oct  2 22:04:17 2020  Wed Nov 11 21:53:57 2020
  • netq show opta-health

netq show ptp

显示 PTP 时钟和配置详细信息,包括

  • 时钟标识和层级
  • 质量和精度信息
  • PTP 端口计数器

语法

   netq [<hostname>] show ptp clock-details 
    [around <text-time>] 
    [json]
   
   netq [<hostname>] show ptp global-config 
    [around <text-time>] 
    [json]

   netq [<hostname>] show ptp port-status [<text-port>] 
    [around <text-time>] 
    [json]

   netq [<hostname>] show ptp counters [<text-port>]
   (tx | rx)
   [around <text-time>] 
   [json]

必需参数

参数描述
clock-detailsNA显示主时钟、父时钟和时钟 ID 以及时钟质量和精度
global-configNA显示优先级、与主时钟的偏移量和平均路径延迟阈值
port-statusNA显示层级信息(主时钟、从时钟)
countersNA显示 PTP 端口计数器
NAtx, rx显示传输 (Tx) 或接收 (Rx) 数据

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

cumulus@switch:~$ netq show ptp clock-details
Matching ptp records:
Hostname          Clock Domain             Clock Identity               Parent Clock Id                GrandMaster ID               Clock Quality              Clock Accuracy               PTP Ports Configured                     Steps Removed
----------------- ------------------------ ---------------------------- ------------------------------ ---------------------------- -------------------------- ---------------------------- ---------------------------------------- --------------------------
mlx-3700c-21      0                        1c:34:da:ff:fe:2d:a1:48      1c34da.fffe.2da148-0           1c:34:da:ff:fe:2d:a1:48      248                        254                          1                                        0
mlx-3700c-22      0                        1c:34:da:ff:fe:2d:a0:48      1c34da.fffe.2da148-1           1c:34:da:ff:fe:2d:a1:48      248                        254                          1                                        1
cumulus@switch:~$ netq show ptp global-config
Matching ptp records:
Hostname          Slave Only           Priority1          Priority2          Domain Number              Two Step Flag              OffSet From Master Max Threshold                                 OffSet From Master Min Threshold                                 Mean Path Delay Threshold
----------------- -------------------- ------------------ ------------------ -------------------------- -------------------------- ---------------------------------------------------------------- ---------------------------------------------------------------- --------------------------------------------------
mlx-3700c-21      0                    128                128                0                          0                          51                                                               -49                                                              200
mlx-3700c-22      0                    129                128                0                          0                          50                                                               -50                                                              200
cumulus@switch:~$ netq show ptp port-status
Matching ptp records:
Hostname          Interface                 PTP Status
----------------- ------------------------- --------------------
mlx-3700c-21      swp29                     MASTER
mlx-3700c-22      swp29                     SLAVE
cumulus@netq-appliance:~$ netq show ptp counters tx
Matching ptp records:
Hostname          Interface            Announce             Delay Request        Delay Response       Follow Up            Delay Resp. Follow U Peer Delay Request   Peer Delay Response  Management           Signaling
                                                                                                                           p
----------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- --------------------
mlx-3700c-21      swp29                114997               0                    200863               229985               0                    0                    0                    0                    229985
mlx-3700c-22      swp29                12                   0                    0                    16                   0                    0                    0                    0                    16


当您安装了软件清单时,此命令会根据已安装的 Cumulus Linux 版本显示建议升级的软件包和版本。然后,您可以将其与交换机上安装的软件包进行比较,以确定它是否与清单不同。如果您单独于 Cumulus Linux 软件本身升级了一个或多个软件包,则可能会发生这种差异。

输出为每个软件包提供以下信息

  • 软件包所在交换机的主机名
  • Cumulus Linux 版本 ID
  • 支持的 ASIC 供应商
  • 支持的 CPU 架构
  • 软件包的名称和版本
  • 上述任何项目上次发生更改的时间

语法

netq [<hostname>] show recommended-pkg-version
    [release-id <text-release-id>]
    [package-name <text-package-name>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机的结果
release-id<text-release-id>仅显示具有此 ID 的 Cumulus Linux 版本的结果;x.y.z 格式
package-name<text-package-name>仅显示具有此名称的软件包的结果
jsonNA以 JSON 格式显示输出

用法示例

显示 leaf12 交换机上建议升级的软件包

cumulus@switch:~$ netq leaf12 show recommended-pkg-version
Matching manifest records:
Hostname          Release ID           ASIC Vendor          CPU Arch             Package Name         Version              Last Changed
----------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------------
leaf12            3.7.1                vx                   x86_64               switchd              1.0-cl3u30           Wed Feb  5 04:36:30 2020

显示建议与 Cumulus Linux 3.7.2 一起使用的 switchd 软件包的版本

cumulus@switch:~$ netq act-5712-09 show recommended-pkg-version release-id 3.7.2 package-name switchd
Matching manifest records:
Hostname          Release ID           ASIC Vendor          CPU Arch             Package Name         Version              Last Changed
----------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------------
act-5712-09       3.7.2                bcm                  x86_64               switchd              1.0-cl3u31           Wed Feb  5 04:36:30 2020
  • netq show cl-manifest

netq show resource-util

显示网络中一个或所有交换机和主机消耗的计算资源利用率 — CPU、磁盘和内存。

输出为每个交换机或主机提供以下信息

  • 设备的主机名
  • 一个或所有设备的 CPU 利用率
  • 一个或所有设备的内存利用率
  • 磁盘名称
  • 磁盘总存储量、已用量和占总量的百分比
  • 上述任何项目上次发生更改的时间

语法

此命令有两种形式可用:一种用于 CPU 和内存利用率,另一种用于磁盘利用率。

netq [<hostname>] show resource-util
    [cpu | memory]
    [around <text-time>]
    [json]

netq [<hostname>] show resource-util
    disk [<text-diskname>]
    [around <text-time>]
    [json]

必需参数

参数描述
disk<text-diskname>显示磁盘利用率

选项

选项描述
NA<hostname>仅显示具有此名称的设备的结果
cpuNA显示一个或多个设备上 CPU 的利用率
memoryNA显示一个或多个设备上内存的利用率
around<text-time>

指示磁盘利用率信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示所有网络交换机的计算资源

cumulus@switch:~$ netq show resource-util
Matching resource_util records:
Hostname          CPU Utilization      Memory Utilization   Disk Name            Total                Used                 Disk Utilization     Last Updated
----------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- ------------------------
border01          10.4                 95.2                 /dev/vda4            6042644480           1710796800           29.9                 Wed Dec  9 16:15:35 2020
border02          10.5                 94.9                 /dev/vda4            6042644480           1710833664           29.9                 Wed Dec  9 16:15:00 2020
fw1               4.3                  88.7                 /dev/vda4            6042644480           1746694144           30.6                 Wed Dec  9 16:14:06 2020
fw2               4.5                  87.8                 /dev/vda4            6042644480           1746690048           30.6                 Wed Dec  9 16:13:57 2020
leaf01            9.9                  91.9                 /dev/vda4            6042644480           1717112832           30                   Wed Dec  9 16:11:16 2020
leaf02            12.6                 96.6                 /dev/vda4            6042644480           1713135616           30                   Wed Dec  9 16:14:17 2020
leaf03            10.5                 94.3                 /dev/vda4            6042644480           1713045504           30                   Wed Dec  9 16:15:14 2020
leaf04            13                   96.3                 /dev/vda4            6042644480           1713086464           30                   Wed Dec  9 16:15:25 2020
oob-mgmt-server   0.8                  42                   /dev/vda1            486105088            80372736             17.6                 Wed Dec  9 16:15:20 2020
...

显示给定交换机的内存利用率

cumulus@switch:~$ netq leaf01 show resource-util memory
Matching resource_util records:
Hostname          Memory Utilization   Last Updated
----------------- -------------------- ------------------------
leaf01            92                   Wed Dec  9 16:19:28 2020

显示所有交换机的磁盘信息

cumulus@switch:~$ netq show resource-util disk /dev/vda1
Matching resource_util records:
Hostname          Disk Name            Total                Used                 Disk Utilization     Last Updated
----------------- -------------------- -------------------- -------------------- -------------------- ------------------------
oob-mgmt-server   /dev/vda1            486105088            80372736             17.6                 Wed Dec  9 16:20:31 2020
server01          /dev/vda1            486105088            80372736             17.6                 Wed Dec  9 16:20:36 2020
server02          /dev/vda1            486105088            80372736             17.6                 Wed Dec  9 16:20:40 2020
server03          /dev/vda1            486105088            80372736             17.6                 Wed Dec  9 16:20:49 2020
server04          /dev/vda1            486105088            80372736             17.6                 Wed Dec  9 16:20:42 2020
server05          /dev/vda1            486105088            80372736             17.6                 Wed Dec  9 16:20:51 2020
server06          /dev/vda1            486105088            80372736             17.6                 Wed Dec  9 16:20:27 2020
server07          /dev/vda1            486105088            80372736             17.6                 Wed Dec  9 16:20:33 2020
server08          /dev/vda1            486105088            80372736             17.6                 Wed Dec  9 16:20:45 2020
  • netq show cl-resource forwarding
  • netq show cl-resource acl

netq show roce-config

显示 RoCE 配置。

语法

netq [<hostname>] show roce-config
    [<text-port>] 
    [around <text-time>] 
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示具有此名称的设备的结果
NA<text-port>按指定的端口筛选
around<text-time>

指示磁盘利用率信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

cumulus@switch:~$ netq show roce-config

Matching roce records:
Hostname          Interface       RoCE Mode  Enabled TCs  Mode     ECN Max  ECN Min  SP->DSCP   SP->PCP  SP->PG   SP->TC   PFC SPs  PFC Rx     PFC Tx     ETS Mode   Last Changed
----------------- --------------- ---------- ------------ -------- -------- -------- ---------- -------- -------- -------- -------- ---------- ---------- ---------- -------------------------
mlx-3700c-23      swp16           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp27           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp32           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp23           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp25           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp5            Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp26           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp4            Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp18           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp12           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp9            Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp30           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp21           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp13           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp1            Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp24           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp15           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp17           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-23      swp22           Lossless   0,3          ECN      1502208  156672   2 -> 26    2 -> 2   2 -> 1   2 -> 0   2        disabled   enabled    dwrr       Thu Mar 30 04:42:18 2023
mlx-3700c-24      swp8            Lossy      0,3          ECN      1502208  156672   3 -> 26    3 -> 3   3 -> 1   3 -> 3   -        disabled   disabled   dwrr       Wed Mar 29 11:00:51 2023
...
  • netq show roce-counters
  • netq check roce

netq show roce-counters

显示交换机、DPU 和 NIC 的 RoCE 计数器。

语法

netq [<hostname>] show roce-counters 
    [<text-port>] tx | rx [roce | general] 
    [around <text-time>] 
    [json]
netq [<hostname>] show roce-counters dpu 
    [around <text-time>] 
    [json]
netq [<hostname>] show roce-counters nic 
    [<text-device-name>]  
    [around <text-time>] 
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示具有此名称的设备的结果
NAtx显示 tx 信息
NArx显示 rx 信息
NA<text-device-name>仅显示具有此名称的 NIC 的结果
around<text-time>

指示磁盘利用率信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示常规和 CNP Rx 计数器

cumulus@switch:~$ netq show roce-counters rx general

Matching roce records:
Hostname          Interface            PG packets           PG bytes             no buffer discard    buffer usage         buffer max usage     PG usage             PG max usage
----------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- --------------------
switch            swp1s1               1627273              152582910            0                    0                    1                    0                    1
switch            swp1s2               1627273              152582910            0                    0                    1                    0                    1
switch            swp63s1              1618361              160178796            0                    0                    2                    0                    2
switch            swp1s0               1627273              152582910            0                    0                    1                    0                    1
switch            swp63s3              1618361              160178796            0                    0                    2                    0                    2
switch            swp1s3               1627273              152582910            0                    0                    1                    0                    1
switch            swp63s0              1094532              120228456            0                    0                    1                    0                    1
switch            swp63s2              1618361              160178796            0                    0                    2                    0                    2

显示特定于 RoCE 的 Rx 计数器

cumulus@switch:~$ netq show roce-counters rx roce

Matching roce records:
Hostname          Interface       PG packets   PG bytes     no buffer discard  PFC pause packets  PFC pause duration buffer usage buffer max usage   PG usage     PG max usage
----------------- --------------- ------------ ------------ ------------------ ------------------ ------------------ ------------ ------------------ ------------ ---------------
switch            swp1s1          0            0            0                  0                  0                  0            0                  0            0
switch            swp1s2          0            0            0                  0                  0                  0            0                  0            0
switch            swp63s1         0            0            0                  0                  0                  0            0                  0            0
switch            swp1s0          0            0            0                  0                  0                  0            0                  0            0
switch            swp63s3         0            0            0                  0                  0                  0            0                  0            0
switch            swp1s3          0            0            0                  0                  0                  0            0                  0            0
switch            swp63s0         0            0            0                  0                  0                  0            0                  0            0
switch            swp63s2         0            0            0                  0                  0                  0            0                  0            0

显示特定于 RoCE 的 Tx 计数器

cumulus@switch:~$ netq show roce-counters tx roce 

Matching roce records:
Hostname          Interface       TC packets TC bytes   unicast no buffer discard PFC pause packets  PFC pause duration buffer usage buffer max usage   TC usage   TC max usage
----------------- --------------- ---------- ---------- ------------------------- ------------------ ------------------ ------------ ------------------ ---------- ---------------
switch            swp1s1          0          0          0                         0                  0                  0            0                  0          0
switch            swp1s2          0          0          0                         0                  0                  0            0                  0          0
switch            swp63s1         0          0          0                         0                  0                  0            0                  0          0
switch            swp1s0          0          0          0                         0                  0                  0            0                  0          0
switch            swp63s3         0          0          0                         0                  0                  0            0                  0          0
switch            swp1s3          0          0          0                         0                  0                  0            0                  0          0
switch            swp63s0         0          0          0                         0                  0                  0            0                  0          0
switch            swp63s2         0          0          0                         0                  0                  0            0                  0          0

要查看特定交换机端口的计数器,请在命令中包含交换机名称

cumulus@switch:~$ netq show roce-counters swp1s1 rx general 

Matching roce records:
Hostname          Interface            PG packets           PG bytes             no buffer discard    buffer usage         buffer max usage     PG usage             PG max usage
----------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- --------------------
switch            swp1s1               1643392              154094520            0                    0                    1                    0                    1

显示 BlueField DPU 的 RoCE 计数器

cumulus@dpu:~$ netq show roce-counters dpu 

Matching roce records:
Hostname          Device Name          Port Name            Rx Prio3 Bytes       Rx Prio3 Buf Discard Rx Prio3 Packets     Rx Prio3 Cong Discar Rx Prio3 Discards    Tx Prio3 Bytes       Tx Prio3 Packets     Np Cnp Sent          Np Ecn Marked Roce P Rp Cnp Handled       Rp Cnp Ignored
                                                                                                                           d                                                                                                        ackets
----------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- --------------------
r-netq-bf2-01-dpu pf0hpf               pf0hpf               0 Bytes              0                    0                    0                    0                    0 Bytes              0                    0 Bytes              0 Bytes              0                    0
01
r-netq-bf2-01-dpu pf1hpf               pf1hpf               0 Bytes              0                    0                    0                    0                    0 Bytes              0                    0 Bytes              0 Bytes              0                    0
01
r-netq-bf2-01-dpu enp3s0f1s0           enp3s0f1s0           0 Bytes              0                    0                    0                    0                    0 Bytes              0                    0 Bytes              0 Bytes              0                    0
01
r-netq-bf2-01-dpu enp3s0f0s0           enp3s0f0s0           0 Bytes              0                    0                    0                    0                    0 Bytes              0                    0 Bytes              0 Bytes              0                    0
01
r-netq-bf2-01-dpu en3f0pf0sf0          en3f0pf0sf0          0 Bytes              0                    0                    0                    0                    0 Bytes              0                    0 Bytes              0 Bytes              0                    0
01
r-netq-bf2-01-dpu p0                   p0                   0 Bytes              0                    0                    0                    0                    0 Bytes              0                    0 Bytes              0 Bytes              0                    0
01
r-netq-bf2-01-dpu en3f1pf1sf0          en3f1pf1sf0          0 Bytes              0                    0                    0                    0                    0 Bytes              0                    0 Bytes              0 Bytes              0                    0
01
r-netq-bf2-01-dpu p1                   p1                   1.23 GB              0                    176                    0                    0                    0 Bytes              0                    0 Bytes              0 Bytes              0                    0
01

显示 ConnectX NIC 的 RoCE 计数器

cumulus@nic:~$ netq show roce-counters nic 

Matching roce records:
Hostname          Device Name          Port Name            Rx Prio3 Bytes       Rx Prio3 Buf Discard Rx Prio3 Packets     Rx Prio3 Cong Discar Rx Prio3 Discards    Tx Prio3 Bytes       Tx Prio3 Packets     Np Cnp Sent          Np Ecn Marked Roce P Rp Cnp Handled       Rp Cnp Ignored
                                                                                                                           d                                                                                                        ackets
----------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- --------------------
fit-l-vrt-netq-40 ens7f1np1            ens7f1np1            146.28 GB            0                    2379794807           0                    0                    151.58 GB            149834335613         0 Bytes              0 Bytes              0                    0
fit-l-vrt-netq-40 ens8f1np1            ens8f1np1            0 Bytes              0                    0                    0                    0                    0 Bytes              0                    0 Bytes              0 Bytes              0                    0
  • netq show roce-config
  • netq show roce-counters pool
  • netq check roce
  • netq show events

netq show roce-counters pool

显示 RoCE 计数器池。

语法

netq [<hostname>] show roce-counters pool 
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示具有此名称的设备的结果
jsonNA以 JSON 格式显示输出

用法示例

cumulus@switch:~$ netq show roce-counters pool 

Matching roce records:
Hostname          Lossy Default Ingress Size     Roce Reserved Ingress Size     Lossy Default Egress Size      Roce Reserved Egress Size
----------------- ------------------------------ ------------------------------ ------------------------------ ------------------------------
switch            104823                         104823                         104823                         104823
  • netq show roce-config
  • netq check roce
  • netq show events

netq show sensors

显示网络结构中所有节点或特定节点上所有风扇、电源和温度传感器的状态,可以是当前或过去某个时间点。输出提供

  • 传感器名称和用户定义的描述
  • 传感器的运行状态
  • 任何消息(如果可用)
  • 上述任何项目上次发生更改的时间

语法

根据您是要查看所有传感器的数据还是仅查看一类传感器的数据,此命令有四种形式可用。

netq [<hostname>] show sensors
    all
    [around <text-time>]
    [json]

netq [<hostname>] show sensors
    fan [<fan-name>]
    [around <text-time>]
    [json]

netq [<hostname>] show sensors
    psu [<psu-name>]
    [around <text-time>]
    [json]

netq [<hostname>] show sensors
    temp [<temp-name>]
    [around <text-time>]
    [json]

必需参数

参数描述
allNA显示所有传感器的数据
风扇<fan-name>显示所有风扇传感器的数据或使用 fan-name 值指定的风扇传感器的数据
psu<psu-name>显示所有电源单元传感器的数据或使用 psu-name 值指定的电源单元传感器的数据
温度<temp-name>显示所有温度传感器的数据或使用 temp-name 值指定的温度传感器的数据

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示所有节点上 fan4 传感器的数据

cumulus@switch:~$ netq show sensors fan fan4
Matching sensors records:
Hostname          Name            Description                         State      Speed      Max      Min      Message                             Last Changed
----------------- --------------- ----------------------------------- ---------- ---------- -------- -------- ----------------------------------- -------------------------
border01          fan4            fan tray 2, fan 2                   ok         2500       29000    2500                                         Tue Nov 24 03:57:06 2020
border02          fan4            fan tray 2, fan 2                   ok         2500       29000    2500                                         Tue Nov 24 04:13:30 2020
fw1               fan4            fan tray 2, fan 2                   ok         2500       29000    2500                                         Tue Nov 24 19:50:49 2020
fw2               fan4            fan tray 2, fan 2                   ok         2500       29000    2500                                         Tue Nov 24 19:50:51 2020
spine03           fan4            fan tray 2, fan 2                   ok         2500       29000    2500                                         Tue Nov 24 04:03:01 2020
spine04           fan4            fan tray 2, fan 2                   ok         2500       29000    2500                                         Tue Nov 24 04:13:52 2020

显示名称为 psu2temp1 的所有温度传感器的状态

cumulus@switch:~$ netq show sensors temp psu2temp1
Matching sensors records:
Hostname          Name            Description                         State      Temp     Critical Max      Min      Message                             Last Changed
----------------- --------------- ----------------------------------- ---------- -------- -------- -------- -------- ----------------------------------- -------------------------
border01          psu2temp1       psu2 temp sensor                    ok         25       85       80       5                                            Tue Aug 25 21:45:21 2020
border02          psu2temp1       psu2 temp sensor                    ok         25       85       80       5                                            Tue Aug 25 21:39:36 2020
fw1               psu2temp1       psu2 temp sensor                    ok         25       85       80       5                                            Wed Aug 26 00:08:01 2020
fw2               psu2temp1       psu2 temp sensor                    ok         25       85       80       5                                            Wed Aug 26 00:02:13 2020
leaf01            psu2temp1       psu2 temp sensor                    ok         25       85       80       5                                            Tue Aug 25 18:30:07 2020
leaf02            psu2temp1       psu2 temp sensor                    ok         25       85       80       5                                            Tue Aug 25 18:08:38 2020
leaf03            psu2temp1       psu2 temp sensor                    ok         25       85       80       5                                            Tue Aug 25 21:20:34 2020
leaf04            psu2temp1       psu2 temp sensor                    ok         25       85       80       5                                            Wed Aug 26 14:20:22 2020
spine01           psu2temp1       psu2 temp sensor                    ok         25       85       80       5                                            Wed Aug 26 10:53:17 2020
spine02           psu2temp1       psu2 temp sensor                    ok         25       85       80       5                                            Wed Aug 26 10:54:07 2020
spine03           psu2temp1       psu2 temp sensor                    ok         25       85       80       5                                            Wed Aug 26 11:00:44 2020
spine04           psu2temp1       psu2 temp sensor                    ok         25       85       80       5                                            Wed Aug 26 10:52:00 2020
  • netq show events
  • netq check sensors
  • netq show unit-tests sensors

netq show services

显示一个或所有交换机和主机的系统级服务的配置和运行状况,可以是当前或过去某个时间点。您可以按交换机、服务、VRF 和状态筛选输出。

支持的服务包括

  • aclinit: aclinit 服务
  • acltool: acltool 服务
  • bgp: BGP(边界网关协议)服务
  • bgpd: BGP 守护程序
  • chrony: chrony 服务
  • clagd: MLAG(多机箱链路聚合)守护程序
  • cumulus-chassis-ssh: cumulus-chassis-ssh
  • cumulus-chassisd: cumulus-chassisd
  • database: 数据库
  • dhcp_relay: DHCP 中继服务
  • docker: Docker 容器服务
  • ledmgrd: 交换机 LED 管理器守护程序
  • lldp: LLDP(链路层发现协议)服务
  • lldpd: LLDP 守护程序
  • mstpd: MSTP(多生成树协议)守护程序
  • neighmgrd: BGP 和 OSPF 的邻居管理器守护程序
  • netq-agent: NetQ 代理服务
  • netqd: NetQ 应用程序守护程序
  • ntp: 网络时间协议 (NTP) 服务
  • pmon: 进程监视器服务
  • portwd: 端口监视守护程序
  • ptmd: PTM(规定性拓扑管理器)守护程序
  • ptp4l: PTP(精确时间协议)服务
  • pwmd: 密码管理器守护程序
  • radv: 路由通告程序服务
  • rsyslog: 极速系统事件日志处理服务
  • smond: 系统监视器守护程序
  • ssh: 交换机和服务器的安全 Shell 服务
  • status: 显示具有给定状态的服务(okerrorwarningfail
  • switchd: Cumulus Linux switchd 服务,用于硬件加速
  • swss: SONiC 交换机状态服务守护程序
  • sx_sdk: Spectrum ASIC SDK 服务
  • syncd: 同步服务
  • syslog: 系统事件日志服务
  • teamd: 网络团队服务
  • vrf: VRF(虚拟路由转发)服务
  • wd_keepalive: 软件看门狗服务
  • zebra: GNU Zebra 路由守护程序

输出为每个交换机和主机提供以下信息

  • 服务名称和 ID
  • 服务使用的 VRF
  • 服务是否已启用、活动和受监控
  • 服务的状态
  • 服务已启动并运行的时间
  • 上次任何这些项目更改的时间

运行 netq config add color 以红色文本显示未启用、活动或受监控的服务。

语法

此命令有两种形式可用:一种用于所有信息,另一种用于特定状态。

netq [<hostname>] show services
    [<service-name>]
    [vrf <vrf>]
    [active|monitored]
    [around <text-time>]
    [json]

netq [<hostname>] show services
    [<service-name>]
    [vrf <vrf>]
    status (ok|warning|error|fail)
    [around <text-time>]
    [json]

使用以下命令显示服务的 CPU 和内存总使用量

netq [<hostname>] show services resource-util
    [<service-name>] 
    [around <text-time>] 
    [json]

必需参数

参数描述
状态ok、warning、error、fail仅显示具有此状态的服务

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
NA<service-name>仅显示具有此名称的服务的结果
vrf<vrf>仅显示使用此 VRF 的服务的结果
活动NA仅显示当前正在运行的服务的结果
受监控NA仅显示受监控的服务的结果
around<text-time>

指示磁盘利用率信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示所有服务、交换机和主机

cumulus@switch:~$ netq show services
Matching services records:
Hostname          Service              PID   VRF             Enabled Active Monitored Status           Uptime                    Last Changed
----------------- -------------------- ----- --------------- ------- ------ --------- ---------------- ------------------------- -------------------------
neo-switch01      pwmd                 11405 default         yes     yes    no        ok               72 day 8h ago             Tue Jul 18 13:59:28 2023
neo-switch01      lldpd                15988 default         yes     yes    yes       ok               50 day 10h ago            Tue Jul 18 13:59:42 2023
neo-switch01      docker               n/a   default         no      no     no        n/a              n/a                       Tue Jul 18 13:59:28 2023
neo-switch01      smond                11323 default         yes     yes    yes       ok               72 day 8h ago             Tue Jul 18 14:00:15 2023
neo-switch01      ssh                  1837  default         yes     yes    no        ok               72 day 8h ago             Tue Jul 18 13:59:28 2023
neo-switch01      dhcrelay             n/a   default         no      no     no        n/a              n/a                       Tue Jul 18 13:59:28 2023
neo-switch01      snmpd                n/a   default         no      no     no        n/a              n/a                       Tue Jul 18 13:59:28 2023
neo-switch01      mstpd                3671  default         yes     yes    yes       ok               72 day 8h ago             Tue Jul 18 14:00:14 2023
neo-switch01      netq-agent           16111 default         yes     yes    yes       ok               4h 56min ago              Tue Jul 18 13:59:28 2023
neo-switch01      switchd              15073 default         yes     yes    no        ok               50 day 10h ago            Tue Jul 18 13:59:28 2023
neo-switch01      bgpd                 2721  default         yes     yes    yes       ok               50 day 10h ago            Tue Jul 18 13:59:28 2023
neo-switch01      wd_keepalive         3471  default         yes     yes    no        ok               72 day 8h ago             Tue Jul 18 13:59:28 2023
neo-switch01      sx_sdk               13193 default         yes     yes    no        ok               50 day 10h ago            Tue Jul 18 13:59:28 2023
...

显示给定服务

cumulus@switch:~$ netq show services bgpd
Matching services records:
Hostname          Service              PID   VRF             Enabled Active Monitored Status           Uptime                    Last Changed
----------------- -------------------- ----- --------------- ------- ------ --------- ---------------- ------------------------- -------------------------
border01          bgpd                 14432 default         yes     yes    yes       ok               Tue Dec  8 21:18:39 2020  Tue Dec  8 21:18:39 2020
border02          bgpd                 14372 default         yes     yes    yes       ok               Tue Dec  8 21:18:42 2020  Tue Dec  8 21:18:42 2020
spine03           bgpd                 13919 default         yes     yes    yes       ok               Tue Dec  8 21:18:43 2020  Tue Dec  8 21:18:43 2020
spine04           bgpd                 13934 default         yes     yes    yes       ok               Tue Dec  8 21:18:44 2020  Tue Dec  8 21:18:44 2020

显示给定交换机或主机上的服务

cumulus@switch:~$ netq leaf02 show services
Matching services records:
Hostname          Service              PID   VRF             Enabled Active Monitored Status           Uptime                    Last Changed
----------------- -------------------- ----- --------------- ------- ------ --------- ---------------- ------------------------- -------------------------
leaf02            air-agent            663   mgmt            yes     yes    no        ok               Tue Dec  8 21:15:00 2020  Tue Dec  8 21:15:00 2020
leaf02            snmpd                10098 mgmt            yes     yes    no        ok               Tue Dec  8 21:15:00 2020  Tue Dec  8 21:15:00 2020
leaf02            rsyslog              11937 default         yes     yes    no        ok               Tue Dec  8 21:15:00 2020  Tue Dec  8 21:15:00 2020

显示所有交换机中服务的服务 CPU 和内存使用量

cumulus@switch:~$ netq show services resource-util

Matching services records:
Hostname          Service              PID   VRF                  Enabled Active Uptime               CPU one Minute       CPU five Minute      Memory one Minute    Memory five Minute   Last Updated
----------------- -------------------- ----- -------------------- ------- ------ -------------------- -------------------- -------------------- -------------------- -------------------- ------------------------
r-3700-02         sx_sdk               19012 default              yes     yes    81 day 17h ago       7.7                  24.65                9.44                 9.44                 Tue Jul 18 18:49:19 2023
r-3700-03         sx_sdk               13627 default              yes     yes    81 day 18h ago       0                    17.82                9.44                 9.44                 Tue Jul 18 18:49:19 2023
r-3700-02         switchd              21100 default              yes     yes    81 day 17h ago       56.77                15.07                1.13                 1.13                 Tue Jul 18 18:49:19 2023
r-3700-03         switchd              15768 default              yes     yes    81 day 18h ago       0                    8.28                 1.11                 1.11                 Tue Jul 18 18:49:19 2023
neo-switch02      sx_sdk               1841  default              yes     yes    2h 29min ago         30.1                 6.55                 9.67                 9.67                 Tue Jul 18 18:49:19 2023
ufm-switch19      sx_sdk               2343  default              yes     yes    21h 3min ago         5.22                 5.73                 2.84                 2.84                 Tue Jul 18 18:49:19 2023
ufm-switch29      sx_sdk               2135  default              yes     yes    8 day 4h ago         2.88                 5.73                 9.54                 9.54                 Tue Jul 18 18:49:19 2023
r-3420-01         sx_sdk               1885  default              yes     yes    9 day 3h ago         5.28                 5.01                 9.3                  9.3                  Tue Jul 18 18:49:19 2023
ufm-switch29      clagd                7095  default              no      yes    8 day 4h ago         23.57                4.71                 0.63                 0.63                 Tue Jul 18 18:49:19 2023
r-3700-01         smond                7301  default              yes     yes    9 day 3h ago         0                    4.7                  0.2                  0.2                  Tue Jul 18 18:49:19 2023
... 
  • netq show events

netq show status verbose

显示安装后 NetQ 组件的状态。使用此命令验证 NetQ 系统就绪情况。

语法

netq show status verbose
    [json]

必需参数

选项

选项描述
jsonNA以 JSON 格式显示输出

用法示例

cumulus@netq:~$ netq show status verbose
NetQ Live State: Active
Installation Status: FINISHED
Version: 4.12.0
Installer Version: 4.12.0
Installation Type: Standalone
Activation Key: EhVuZXRxLWasdW50LWdhdGV3YXkYsagDIixkWUNmVmhVV2dWelVUOVF3bXozSk8vb2lSNGFCaE1FR2FVU2dHK1k3RzJVPQ==
Master SSH Public Key: c3NoLXJzYSBBQUFBQjNOemFDMXljMkVBQUFBREFRQUJBQUFCfdsaHpjKzcwNmJiNVROOExRRXdLL3l5RVNLSHRhUE5sZS9FRjN0cTNzaHh1NmRtMkZpYmg3WWxKUE9lZTd5bnVlV2huaTZxZ0xxV3ZMYkpLMGdkc3RQcGdzNUlqanNMR3RzRTFpaEdNa3RZNlJYenQxLzh4Z3pVRXp3WTBWZDB4aWJrdDF3RGQwSjhnbExlbVk1RDM4VUdBVFVkMWQwcndLQ3gxZEhRdEM5L1UzZUs5cHFlOVdBYmE0ZHdiUFlaazZXLzM0ZmFsdFJxaG8rNUJia0pkTkFnWHdkZGZ5RXA1Vjc3Z2I1TUU3Q1BxOXp2Q1lXZW84cGtXVS9Wc0gxWklNWnhsa2crYlZ4MDRWUnN4ZnNIVVJHVmZvckNLMHRJL0FrQnd1N2FtUGxObW9ERHg2cHNHaU1EQkM0WHdud1lmSlNleUpmdTUvaDFKQ2NuRXpOVnVWRjUgcm9vdEBhbmlscmVzdG9yZQ==
Is Cloud: False
Kubernetes Cluster Nodes Status:
IP Address     Hostname       Role    NodeStatus
-------------  -------------  ------  ------------
10.188.46.243  10.188.46.243  Role    Ready
Task                                                                Status
------------------------------------------------------------------  --------
Prepared for download and extraction                                FINISHED
Completed setting up python virtual environment                     FINISHED
Checked connectivity from master node                               FINISHED
Installed Kubernetes control plane services                         FINISHED
Installed Calico CNI                                                FINISHED
Installed K8 Certificates                                           FINISHED
Updated etc host file with master node IP address                   FINISHED
Stored master node hostname                                         FINISHED
Generated and copied master node configuration                      FINISHED
Updated cluster information                                         FINISHED
Plugged in release bundle                                           FINISHED
Downloaded, installed, and started node service                     FINISHED
Downloaded, installed, and started port service                     FINISHED
Patched Kubernetes infrastructure                                   FINISHED
Removed unsupported conditions from master node                     FINISHED
Installed NetQ Custom Resource Definitions                          FINISHED
Installed Master Operator                                           FINISHED
Updated Master Custom Resources                                     FINISHED
Updated NetQ cluster manager custom resource                        FINISHED
Installed Cassandra                                                 FINISHED
Created new database                                                FINISHED
Updated Master Custom Resources                                     FINISHED
Updated Kafka Custom Resources                                      FINISHED
Read Config Key ConfigMap                                           FINISHED
Backed up ConfigKey                                                 FINISHED
Read ConfigKey                                                      FINISHED
Created Keys                                                        FINISHED
Verified installer version                                          FINISHED
...
  • netq install

netq show stp topology

显示桥接器或交换机上的生成树协议 (STP) 拓扑。如果您的配置中没有桥接器,则输出会指示这一点。

语法

   netq <hostname> show stp topology
   [around <text-time>]
   [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
around<text-time>

指示磁盘利用率信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示从 spine1 交换机查看的 STP 拓扑

cumulus@switch:~$ netq spine1 show stp topology
Root(spine1) -- spine1:sw_clag200 -- leaf2:EdgeIntf(sng_hst2) -- hsleaf21
                                    -- leaf2:EdgeIntf(dual_host2) -- hdleaf2
                                    -- leaf2:EdgeIntf(dual_host1) -- hdleaf1
                                    -- leaf2:ClagIsl(peer-bond1) -- leaf1
                                    -- leaf1:EdgeIntf(sng_hst2) -- hsleaf11
                                    -- leaf1:EdgeIntf(dual_host2) -- hdleaf2
                                    -- leaf1:EdgeIntf(dual_host1) -- hdleaf1
                                    -- leaf1:ClagIsl(peer-bond1) -- leaf2
                                    -- spine1:ClagIsl(peer-bond1) -- spine2
                                    -- spine1:sw_clag300 -- edge1:EdgeIntf(sng_hst2) -- hsedge11
                                    -- edge1:EdgeIntf(dual_host2) -- hdedge2
                                    -- edge1:EdgeIntf(dual_host1) -- hdedge1
                                    -- edge1:ClagIsl(peer-bond1) -- edge2
                                    -- edge2:EdgeIntf(sng_hst2) -- hsedge21
                                    -- edge2:EdgeIntf(dual_host2) -- hdedge2
                                    -- edge2:EdgeIntf(dual_host1) -- hdedge1
                                    -- edge2:ClagIsl(peer-bond1) -- edge1
Root(spine2) -- spine2:sw_clag200 -- leaf2:EdgeIntf(sng_hst2) -- hsleaf21
                                    -- leaf2:EdgeIntf(dual_host2) -- hdleaf2
                                    -- leaf2:EdgeIntf(dual_host1) -- hdleaf1
                                    -- leaf2:ClagIsl(peer-bond1) -- leaf1
                                    -- leaf1:EdgeIntf(sng_hst2) -- hsleaf11
                                    -- leaf1:EdgeIntf(dual_host2) -- hdleaf2
                                    -- leaf1:EdgeIntf(dual_host1) -- hdleaf1
                                    -- leaf1:ClagIsl(peer-bond1) -- leaf2
                                    -- spine2:ClagIsl(peer-bond1) -- spine1
                                    -- spine2:sw_clag300
                                    -- edge2:EdgeIntf(sng_hst2) -- hsedge21
                                    -- edge2:EdgeIntf(dual_host2) -- hdedge2
                                    -- edge2:EdgeIntf(dual_host1) -- hdedge1
                                    -- edge2:ClagIsl(peer-bond1) -- edge1
                                    -- edge1:EdgeIntf(sng_hst2) -- hsedge11
                                    -- edge1:EdgeIntf(dual_host2) -- hdedge2
                                    -- edge1:EdgeIntf(dual_host1) -- hdedge1
                                    -- edge1:ClagIsl(peer-bond1) -- edge2


netq show tca

显示所有用户指定的基于阈值的事件通知的配置信息。您可以按配置的标识符筛选输出。输出为每个通知配置提供以下信息

  • 配置名称
  • 托管事件的名称
  • 范围,指示此配置应包括或排除哪些管理
  • 事件严重性
  • 接收事件的通道
  • 配置当前是活动、禁用还是已抑制
  • 阈值、度量单位和类型
  • 这些事件的抑制何时结束(如果已配置)

语法

netq show tca
    [tca_id <text-tca-id-anchor>]
    [json]

必需参数

选项

选项描述
tca_id<text-tca-id-anchor>仅显示具有此 ID/名称的配置的结果
jsonNA以 JSON 格式显示输出

用法示例

显示所有 TCA 事件配置

cumulus@switch:~$ netq show tca
Matching config_tca records:
TCA Name                     Event Name           Scope                      Severity Channel/s          Active Threshold          Unit     Threshold Type Suppress Until
---------------------------- -------------------- -------------------------- -------- ------------------ ------ ------------------ -------- -------------- ----------------------------
TCA_CPU_UTILIZATION_UPPER_1  TCA_CPU_UTILIZATION_ {"hostname":"leaf01"}      info     pd-netq-events,slk True   87                 %        user_set       Fri Oct  9 15:39:35 2020
                             UPPER                                                    -netq-events
TCA_CPU_UTILIZATION_UPPER_2  TCA_CPU_UTILIZATION_ {"hostname":"*"}           error    slk-netq-events    True   93                 %        user_set       Fri Oct  9 15:39:56 2020
                             UPPER
TCA_DOM_BIAS_CURRENT_ALARM_U TCA_DOM_BIAS_CURRENT {"hostname":"leaf*","ifnam error    slk-netq-events    True   0                  mA       vendor_set     Fri Oct  9 16:02:37 2020
PPER_1                       _ALARM_UPPER         e":"*"}
TCA_DOM_RX_POWER_ALARM_UPPER TCA_DOM_RX_POWER_ALA {"hostname":"*","ifname":" info     slk-netq-events    True   0                  mW       vendor_set     Fri Oct  9 15:25:26 2020
_1                           RM_UPPER             *"}
TCA_SENSOR_TEMPERATURE_UPPER TCA_SENSOR_TEMPERATU {"hostname":"leaf","s_name error    slk-netq-events    True   32                 degreeC  user_set       Fri Oct  9 15:40:18 2020
_1                           RE_UPPER             ":"temp1"}
TCA_TCAM_IPV4_ROUTE_UPPER_1  TCA_TCAM_IPV4_ROUTE_ {"hostname":"*"}           error    pd-netq-events     True   20000              %        user_set       Fri Oct  9 16:13:39 2020
                             UPPER

显示特定 TCA 配置

cumulus@switch:~$ netq show tca tca_id TCA_TXMULTICAST_UPPER_1
Matching config_tca records:
TCA Name                     Event Name           Scope                      Severity         Channel/s          Active Threshold          Suppress Until
---------------------------- -------------------- -------------------------- ---------------- ------------------ ------ ------------------ ----------------------------
TCA_TXMULTICAST_UPPER_1      TCA_TXMULTICAST_UPPE {"ifname":"swp3","hostname info             tca-tx-bytes-slack True   0                  Sun Dec  8 16:40:14 2269
                             R                    ":"leaf01"}
  • netq add tca
  • netq del tca
  • netq show notification

netq show trace

显示给定计划跟踪的配置设置、所有计划跟踪的摘要结果或计划跟踪的完整结果。使用摘要形式获取作业 ID。输出因命令的形式而异。请注意,按需跟踪结果会在命令运行时显示在终端窗口中。

语法

此命令有三种形式可用。

netq show trace results <text-job-id>
    [json]

netq show trace settings
    [name <text-trace-name>]
    [json]

netq show trace summary
    [name <text-trace-name>]
    [around <text-time-hr>]
    [json]

必需参数

参数描述
resultsNA显示所有计划跟踪请求的完整结果,包括可用路径
NA<text-job-id>仅显示具有此作业 ID 的跟踪请求的结果
settingsNA显示给定跟踪请求的跟踪配置设置
summaryNA仅显示当前或过去某个时间点所有计划跟踪结果的名称、作业 ID、状态和持续时间

选项

选项描述
name<text-trace-name>仅显示具有此名称的跟踪的摘要结果或配置设置
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示给定跟踪的完整结果

cumulus@switch:~$ netq show trace results e58bcf94-6922-40e4-ab2e-ff29aefe0120
Job ID                                             ID                        Errors       Warnings         Hops     MTU    Failure reason               Timestamp
-------------------------------------------------- ------------------------- ------------ ---------------- -------- ------ ---------------------------- -------------------------
e58bcf94-6922-40e4-ab2e-ff29aefe0120               1                         0            0                2        9216   N/A                          Tue Jan 16 08:25:02 2024
e58bcf94-6922-40e4-ab2e-ff29aefe0120               1                         0            0                2        9216   N/A                          Tue Jan 16 08:20:02 2024
e58bcf94-6922-40e4-ab2e-ff29aefe0120               1                         0            0                2        9216   N/A                          Tue Jan 16 08:15:02 2024

显示配置设置

cumulus@switch:~$ netq show trace settings name Lf01toBor01Daily

显示过去 24 小时的摘要结果

cumulus@switch:~$ netq show trace summary
Name            Job ID       Status           Status Details               Start Time           End Time
--------------- ------------ ---------------- ---------------------------- -------------------- ----------------
leaf01toborder0 f8d6a2c5-54d Complete         0                            Fri Nov  6 15:04:54  Fri Nov  6 15:05
1               b-44a8-9a5d-                                               2020                 :21 2020
                9d31f4e4701d
New Trace       0e65e196-ac0 Complete         1                            Fri Nov  6 15:04:48  Fri Nov  6 15:05
                5-49d7-8c81-                                               2020                 :03 2020
                6e6691e191ae
Svr01toSvr04Hrl 4c580c97-8af Complete         0                            Fri Nov  6 15:01:16  Fri Nov  6 15:01
y               8-4ea2-8c09-                                               2020                 :44 2020
                038cde9e196c
...
  • netq add trace
  • netq del trace
  • netq trace
  • netq show events type trace

netq show unit-tests

显示您可以为关联的 netq check 命令运行的所有验证测试的列表。输出提供每个验证测试的 ID、名称和简短描述。

语法

netq show unit-tests address 
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests agent 
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests bgp
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests cl-version 
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests evpn 
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests interfaces 
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests mlag 
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests mtu 
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests ntp 
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests roce 
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests sensors 
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests topology 
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests vlan 
    [check_filter_id <text-check-filter-id>] 
    [json]

netq show unit-tests vxlan 
    [check_filter_id <text-check-filter-id>] 
    [json]

必需参数

参数描述
address、agent、bgp、cl-version、evpn、interfaces、mlag、mtu、ntp、roce、sensors、topology、vlan 或 vxlanNA显示在此名称的协议或服务的标准验证期间运行的测试

选项

选项描述
check_filter_id<text-check-filter-id>包括验证的特定过滤器
jsonNA以 JSON 格式显示输出

用法示例

显示 BGP 验证测试列表

cumulus@netq-ts:~$ netq show unit-tests bgp
   0 : Session Establishment     - check if BGP session is in established state
   1 : Address Families          - check if tx and rx address family advertisement is consistent between peers of a BGP session
   2 : Router ID                 - check for BGP router id conflict in the network
   3 : Hold Time                 - check for mismatch of hold time between peers of a BGP session
   4 : Keep Alive Interval       - check for mismatch of keep alive interval between peers of a BGP session
   5 : Ipv4 Stale Path Time      - check for mismatch of ipv4 stale path timer between peers of a BGP session
   6 : Ipv6 Stale Path Time      - check for mismatch of ipv6 stale path timer between peers of a BGP session
   7 : Interface MTU             - check for consistency of Interface MTU for BGP peers

Configured global result filters:

Configured per test result filters:
  • netq show events
  • netq check

netq show validation settings

显示一个或所有计划验证,包括其名称、类型、频率、验证开始时间、创建时间以及当前是否处于活动状态。这对于获取计划验证的名称以用于其他验证命令非常有用。

语法

netq show validation settings
    [name <text-validation-name>]
    [type addr|agents|bgp|evpn|interfaces|mlag|mtu|ntp|roce|sensors|topology|vlan|vxlan]
    [json]

必需参数

选项

选项描述
name<text-validation-name>筛选输出以查看具有此名称的计划验证的设置
typeaddr、agents、bgp、evpn、interfaces、mlag、mtu、ntp、roce、sensors、topology、vlan 或 vxlan筛选输出以仅查看指示的协议或服务的设置
jsonNA以 JSON 格式显示输出

用法示例

cumulus@switch:~$ netq show validation settings
Name            Types      Cadence        Start Time           Creation Time              Active
--------------- ---------- -------------- -------------------- -------------------------- ------
BGP12hr         bgp, evpn  720m           Thu Nov 12 16:15:00  Thu Nov 12 20:10:05 2020   yes
                                          2020
BGP12hr (pre 11 bgp        720m           Thu Nov 12 16:15:00  Thu Nov 12 18:45:52 2020   no
-12-20)                                   2020
Bgp30m          bgp        30m            Tue Nov 10 21:46:05  Tue Nov 10 21:46:05 2020   yes
                                          2020
Default validat interfaces 60m            Wed Nov 11 08:38:40  Wed Nov 11 08:38:40 2020   yes
ion INTERFACES                            2020
Default validat mlag       60m            Wed Nov 11 08:38:40  Wed Nov 11 08:38:40 2020   yes
ion MLAG                                  2020
Default validat vlan       60m            Wed Nov 11 08:38:40  Wed Nov 11 08:38:40 2020   yes
ion VLAN                                  2020
Default validat sensors    60m            Wed Nov 11 08:38:40  Wed Nov 11 08:38:40 2020   yes
ion SENSORS                               2020
Default validat vxlan      60m            Wed Nov 11 08:38:40  Wed Nov 11 08:38:40 2020   yes
ion VXLAN                                 2020
Default validat mtu        60m            Wed Nov 11 08:38:40  Wed Nov 11 08:38:40 2020   yes
ion MTU                                   2020
Default validat bgp        60m            Wed Nov 11 08:38:40  Wed Nov 11 08:38:40 2020   yes
ion BGP                                   2020
Default validat agents     60m            Wed Nov 11 08:38:40  Wed Nov 11 08:38:40 2020   yes
ion AGENTS                                2020
Default validat ntp        60m            Wed Nov 11 08:38:40  Wed Nov 11 08:38:40 2020   yes
ion NTP                                   2020
Default validat evpn       60m            Wed Nov 11 08:38:40  Wed Nov 11 08:38:40 2020   yes
ion EVPN                                  2020
  • netq add validation
  • netq del validation
  • netq show validation summary

netq show validation summary

显示给定协议或服务的计划验证的摘要状态,包括其名称、类型、作业 ID、已验证的节点数、验证失败的节点数、运行协议或服务的节点数以及上次运行验证的时间。

语法

netq show validation summary
    [name <text-validation-name>]
    type (addr | agents | bgp | evpn | interfaces | mlag | mtu | ntp | roce | sensors | topology | vlan | vxlan)
    [around <text-time-hr>]
    [json]

必需参数

参数描述
typeaddr、agents、bgp、evpn、interfaces、mlag、mtu、ntp、roce、sensors、topology、vlan 或 vxlan显示指示的协议或服务的验证运行摘要

选项

选项描述
name<text-validation-name>筛选输出以查看具有此名称的计划验证的设置
around<text-time-hr>显示过去此时间的摘要状态。您必须以小时为单位指定值,并包含 h 时间单位。默认为 24 小时。
jsonNA以 JSON 文件格式显示输出,而不是默认的屏幕文本格式

用法示例

显示过去 24 小时的 EVPN 计划验证摘要

cumulus@switch:~$ netq show validation summary type evpn
Name            Type             Job ID       Checked Nodes              Failed Nodes             Total Nodes            Timestamp
--------------- ---------------- ------------ -------------------------- ------------------------ ---------------------- -------------------------
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 15:43:08 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 14:43:21 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 13:42:57 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 12:42:57 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 11:43:15 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 10:42:54 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 09:42:56 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 08:43:25 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
BGP12hr         scheduled        5818f911-d9e 6                          1                        6                      Fri Nov 20 08:10:15 2020
                                 2-4927-9cc1-
                                 6972899a3422
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 07:42:56 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 06:42:54 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 05:43:12 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
BGP12hr         scheduled        5818f911-d9e 0                          0                        0                      Fri Nov 20 05:14:06 2020
                                 2-4927-9cc1-
                                 6972899a3422
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 04:42:52 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
Default validat scheduled        1129e006-d47 6                          0                        6                      Fri Nov 20 03:42:59 2020
ion                              2-4ee7-917e-
                                 f21d15adec22
...
  • netq add validation
  • netq del validation
  • netq show validation settings

netq show vlan

显示网络结构中所有节点或特定节点上所有 VLAN 的配置,可以是当前或过去某个时间点。输出显示

  • 交换机或主机名
  • 与该节点关联的 VLAN
  • 与该节点关联的 SVI(交换机虚拟接口)
  • 上述任何项目上次发生更改的时间

语法

netq [<hostname>] show vlan
    [<1-4096>]
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
NA<1-4096>仅显示此范围内的 VLAN 的结果
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

以下示例显示了基于 NVIDIA 参考架构的网络中配置的 VLAN

cumulus@switch:~$ netq show vlan
Matching vlan records:
Hostname          VLANs                     SVIs                      Last Changed
----------------- ------------------------- ------------------------- -------------------------
border01          1,10,20,30,4001-4002                                Wed Oct 28 14:46:33 2020
border02          1,10,20,30,4001-4002                                Wed Oct 28 14:46:33 2020
leaf01            1,10,20,30,4001-4002      10 20 30                  Wed Oct 28 14:46:34 2020
leaf02            1,10,20,30,4001-4002      10 20 30                  Wed Oct 28 14:46:34 2020
leaf03            1,10,20,30,4001-4002      10 20 30                  Wed Oct 28 14:46:34 2020
leaf04            1,10,20,30,4001-4002      10 20 30                  Wed Oct 28 14:46:34 2020

以下示例显示了 leaf02 交换机上配置的 VLAN

cumulus@switch:~$ netq leaf02 show vlan
Matching vlan records:
Hostname          VLAN   Ports                               SVI  Last Changed
----------------- ------ ----------------------------------- ---- -------------------------
leaf02            20     bond2,vni20                         yes  Wed Oct 28 15:14:11 2020
leaf02            30     vni30,bond3                         yes  Wed Oct 28 15:14:11 2020
leaf02            1      peerlink                            no   Wed Oct 28 15:14:11 2020
leaf02            10     bond1,vni10                         yes  Wed Oct 28 15:14:11 2020
leaf02            4001   vniRED                              yes  Wed Oct 28 15:14:11 2020
leaf02            4002   vniBLUE                             yes  Wed Oct 28 15:14:11 2020

以下示例显示了 vlan 10 正在两个边界交换机和四个叶交换机上运行

cumulus@switch~$ netq show vlan 10
Matching vlan records:
Hostname          VLAN   Ports                               SVI  Last Changed
----------------- ------ ----------------------------------- ---- -------------------------
border01          10                                         no   Wed Oct 28 15:20:27 2020
border02          10                                         no   Wed Oct 28 15:20:28 2020
leaf01            10     bond1,vni10                         yes  Wed Oct 28 15:20:28 2020
leaf02            10     bond1,vni10                         yes  Wed Oct 28 15:20:28 2020
leaf03            10     bond1,vni10                         yes  Wed Oct 28 15:20:29 2020
leaf04            10     bond1,vni10                         yes  Wed Oct 28 15:20:29 2020
  • netq show events message_type vlan
  • netq show interfaces type vlan
  • netq show macs
  • netq check vlan
  • netq show unit-tests vlan

netq show vxlan

显示网络结构中所有节点或特定节点上所有 VXLAN 的配置,可以是当前或过去某个时间点。输出提供

  • 交换机或主机名
  • 与该节点关联的 VNI
  • 接口上使用的协议
  • 节点的 VTEP IP
  • 复制列表(如果适用)
  • 上述任何项目上次发生更改的时间

语法

netq [<hostname>] show vxlan
    [vni <text-vni>]
    [around <text-time>]
    [json]

必需参数

选项

选项描述
NA<hostname>仅显示此名称的交换机或主机的结果
vni<text-vni>仅显示具有此名称的 VNI 的结果
around<text-time>

指示网络状态信息要追溯到过去多长时间。您可以使用文本(例如,而不是 UTP 表示形式)编写值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

以下示例显示了全网络所有配置的 VXLAN。在此网络中,有三个与三个 VLAN(13、24、4001)关联的 VNI(13、24 和 104001),EVPN 是部署的虚拟协议,并且配置上次更改大约在 23 小时前

cumulus@switch:~$ netq show vxlan
Matching vxlan records:
Hostname          VNI        Protoc VTEP IP          VLAN   Replication List                    Last Changed
                                ol
----------------- ---------- ------ ---------------- ------ ----------------------------------- -------------------------
exit01            104001     EVPN   10.0.0.41        4001                                       Fri Feb  8 01:35:49 2019
exit02            104001     EVPN   10.0.0.42        4001                                       Fri Feb  8 01:35:49 2019
leaf01            13         EVPN   10.0.0.112       13     10.0.0.134(leaf04, leaf03)          Fri Feb  8 01:35:49 2019
leaf01            24         EVPN   10.0.0.112       24     10.0.0.134(leaf04, leaf03)          Fri Feb  8 01:35:49 2019
leaf01            104001     EVPN   10.0.0.112       4001                                       Fri Feb  8 01:35:49 2019
leaf02            13         EVPN   10.0.0.112       13     10.0.0.134(leaf04, leaf03)          Fri Feb  8 01:35:49 2019
leaf02            24         EVPN   10.0.0.112       24     10.0.0.134(leaf04, leaf03)          Fri Feb  8 01:35:49 2019
leaf02            104001     EVPN   10.0.0.112       4001                                       Fri Feb  8 01:35:49 2019
leaf03            13         EVPN   10.0.0.134       13     10.0.0.112(leaf02, leaf01)          Fri Feb  8 01:35:49 2019
leaf03            24         EVPN   10.0.0.134       24     10.0.0.112(leaf02, leaf01)          Fri Feb  8 01:35:49 2019
leaf03            104001     EVPN   10.0.0.134       4001                                       Fri Feb  8 01:35:49 2019
leaf04            13         EVPN   10.0.0.134       13     10.0.0.112(leaf02, leaf01)          Fri Feb  8 01:35:49 2019
leaf04            24         EVPN   10.0.0.134       24     10.0.0.112(leaf02, leaf01)          Fri Feb  8 01:35:49 2019
leaf04            104001     EVPN   10.0.0.134       4001                                       Fri Feb  8 01:35:49 2019

显示给定 VNI 的配置

cumulus@switch:~$ netq show vxlan vni 4001
Matching vxlan records:
Hostname          VNI        Protoc VTEP IP          VLAN   Replication List                    Last Changed
                             ol
----------------- ---------- ------ ---------------- ------ ----------------------------------- -------------------------
border01          4001       EVPN   10.0.1.254       4001                                       Tue Nov 10 22:29:05 2020
border02          4001       EVPN   10.0.1.254       4001                                       Tue Nov 10 22:29:06 2020
leaf01            4001       EVPN   10.0.1.1         4001                                       Tue Nov 10 22:29:04 2020
leaf02            4001       EVPN   10.0.1.1         4001                                       Tue Nov 10 22:29:15 2020
leaf03            4001       EVPN   10.0.1.2         4001                                       Tue Nov 10 22:28:31 2020
leaf04            4001       EVPN   10.0.1.2         4001                                       Tue Nov 10 22:29:34 2020
  • netq show events message_type vxlan
  • netq show interfaces type vxlan
  • netq check vxlan
  • netq show unit-tests vxlan

netq show wjh-drop

显示由于 NVIDIA Spectrum 交换机上的缓冲区拥塞、错误路由、隧道、ACL 以及第 1 层和第 2 层问题而导致的丢包。您可以按各种属性筛选特定类型的丢包。输出因丢包类型而异。有关支持的丢包原因的描述,请参阅 WJH 事件参考,有关查看和解释 WJH 数据的更多信息,请参阅 查看 WJH 指标

语法

netq [<hostname>] show wjh-drop 
    [severity <text-severity>] 
    [details] 
    [between <text-fixed-time> and <text-fixed-endtime>] 
    [around <text-fixed-time>] 
    [json]

netq [<hostname>] show wjh-drop <text-drop-type> 
    [ingress-port <text-ingress-port>] 
    [severity <text-severity>] 
    [reason <text-reason>] 
    [src-ip <text-src-ip>] 
    [dst-ip <text-dst-ip>] 
    [proto <text-proto>] 
    [src-port <text-src-port>] 
    [dst-port <text-dst-port>] 
    [src-mac <text-src-mac>] 
    [dst-mac <text-dst-mac>] 
    [egress-port <text-egress-port>] 
    [traffic-class <text-traffic-class>] 
    [rule-id-acl <text-rule-id-acl>] 
    [vlan <text-vlan>]
    [between <text-time> and <text-endtime>] 
    [around <text-time>] 
    [json]

还有一个额外的命令可用于聚合在同一入口端口上发生的 WJH L1 错误。

netq [<hostname>] show wjh-drop l1 
    [ingress-port <text-ingress-port>] 
    [severity <text-severity>]
    [reason <text-reason>] 
    [port-aggregate <text-port-aggregate>] 
    [between <text-time> and <text-endtime>] 
    [around <text-time>] [json]

必需参数

参数描述
NA<text-drop-type>仅显示此类型的丢包的结果。类型包括 l1l2routertunnelbufferacl

选项

选项描述
NA<hostname>仅显示具有此名称的交换机或主机的丢包
severity<text-severity>仅显示具有此严重性的丢包;errorwarningnotice
详细信息NA显示所有丢包类型的丢包计数和原因
入口端口<text-ingress-port>仅显示具有此名称的入口端口的丢包
端口聚合<text-port-aggregate>根据各自的端口聚合丢包 (True) 或列出所有端口 (False)
原因<text-reason>仅显示具有此原因的丢包
源 IP<text-src-ip>仅显示具有此源 IP 地址的丢包
目标 IP<text-dst-ip>仅显示具有此目标 IP 地址的丢包
协议<text-proto>仅显示来自具有此名称的协议的丢包
源端口<text-src-port>仅显示具有此源端口名称的丢包
目标端口<text-dst-port>仅显示具有此目标端口名称的丢包
源 MAC<text-src-mac>仅显示具有此源 MAC 地址的丢包
目标 MAC<text-dst-mac>仅显示具有此目标 MAC 地址的丢包
出口端口<text-egress-port>仅显示具有此名称的出口端口的丢包
流量类别<text-traffic-class>仅显示具有此流量类别的丢包
规则 ID ACL<text-rule-id-acl>仅显示具有此规则 ID 的 ACL 丢包
vlan<text-vlan>显示具有此 ID 的 VLAN 的丢包。VLAN 范围为 1-4096。
between<text-time> 和 <text-endtime>

仅显示这两个时间之间的结果。时间必须包含数值度量单位

  • w: 周
  • d: 天
  • h: 小时
  • m: 分钟
  • s: 秒
  • now

您可以输入开始时间 (text-time) 和结束时间 (text-endtime) 值,最近的时间在前,最旧的时间在后,反之亦然。这些值不必具有相同的度量单位。

around<text-time>

指示网络状态信息要追溯的时间范围。使用文本(而不是例如 UTP 表示)写入值。请注意,数字和时间单位之间没有空格。

有效值包括

  • <1-xx>s: 秒数
  • <1-xx>m: 分钟数
  • <1-xx>h: 小时数
  • <1-xx>d: 天数

jsonNA以 JSON 格式显示输出

用法示例

显示给定交换机或主机的丢包

cumulus@switch:~$ netq leaf03 show wjh-drop between now and 7d
Matching wjh records:
Drop type          Aggregate Count
------------------ ------------------------------
L1                 560
Buffer             224
Router             144
L2                 0
ACL                0
Tunnel             0

显示 L2 丢包

cumulus@mlx-2700-03:mgmt:~$ netq show wjh-drop l2
Matching wjh records:
Hostname          Ingress Port             Reason                                        Agg Count          Src Ip           Dst Ip           Proto  Src Port         Dst Port         Src Mac            Dst Mac            First Timestamp                Last Timestamp
----------------- ------------------------ --------------------------------------------- ------------------ ---------------- ---------------- ------ ---------------- ---------------- ------------------ ------------------ ------------------------------ ----------------------------
mlx-2700-03       swp1s2                   Port loopback filter                          10                 27.0.0.19        27.0.0.22        0      0                0                00:02:00:00:00:73  0c:ff:ff:ff:ff:ff  Mon Dec 16 11:54:15 2019       Mon Dec 16 11:54:15 2019
mlx-2700-03       swp1s2                   Source MAC equals destination MAC             10                 27.0.0.19        27.0.0.22        0      0                0                00:02:00:00:00:73  00:02:00:00:00:73  Mon Dec 16 11:53:17 2019       Mon Dec 16 11:53:17 2019
mlx-2700-03       swp1s2                   Source MAC equals destination MAC             10                 0.0.0.0          0.0.0.0          0      0                0                00:02:00:00:00:73  00:02:00:00:00:73  Mon Dec 16 11:40:44 2019       Mon Dec 16 11:40:44 2019

显示 ACL 丢包

cumulus@switch:~$ netq show wjh-drop acl
Matching wjh records:
Hostname          Ingress Port             Reason                                        Severity         Agg Count          Src Ip           Dst Ip           Proto  Src Port         Dst Port         Src Mac            Dst Mac            Acl Rule Id            Acl Bind Point               Acl Name         Acl Rule         First Timestamp                Last Timestamp
----------------- ------------------------ --------------------------------------------- ---------------- ------------------ ---------------- ---------------- ------ ---------------- ---------------- ------------------ ------------------ ---------------------- ---------------------------- ---------------- ---------------- ------------------------------ ----------------------------
leaf01            swp2                     Ingress router ACL                            Error            49                 55.0.0.1         55.0.0.2         17     8492             21423            00:32:10:45:76:89  00:ab:05:d4:1b:13  0x0                    0                                                              Tue Oct  6 15:29:13 2020       Tue Oct  6 15:29:39 2020
  • netq config add agent wjh
  • netq config add agent wjh-threshold
  • netq config add agent wjh-drop-filter
  • netq config restart agent