使用 Marvis 查询语言进行故障排除

查看事件和设备详细信息

若要排解问题并了解网络行为，可能需要查看事件详细信息或设备详细信息。您可以使用 LIST 查询查看以下内容的详细信息：

• 接入点 （AP）

• 客户端（包括有线客户端）

• 开关

• AP 事件

• 客户端事件

• 交换机事件

• Mist边缘

• Mist Edge 事件

表 1 和 表 2 提供了一些 LIST 查询，您可以将其用作根据需求构建查询的参考。

表 1：用于查看事件的关键 LIST 查询

如果要查看	使用
特定时间间隔内接入点的客户端事件	LIST ClientEvents WITH AccessPoint <AP name> DURING <time duration>
接入点的所有事件	LIST ApEvents WITH AccessPoint <AP name>
接入点的特定类型的事件	LIST ApEvents WITH ApEventType <event-type> AND AccessPoint <ap-name>
交换机的所有事件	LIST SwitchEvents WITH Switch <switch name>
交换机的特定类型的事件	LIST SwitchEvents WITH SwitchEventType <event-type> AND Switch <switch-name>
特定站点上 Mist Edge 的所有事件	LIST MistEdgeEvents WITH Site <site-name>

以下示例显示了与特定 AP 关联的所有客户端的事件。要查看有关事件的更多详细信息，可以单击表格第一列中的箭头。

此示例显示了特定事件类型的列表：

表 2：用于查看设备的关键 LIST 查询

如果要查看	使用
站点中特定型号的交换机	LIST Switches WITH Model <model number> AND Site <site name>
连接到接入点的客户端	LIST Clients WITH AccessPoint <AP name>
站点中特定型号的接入点	LIST APs WITH Model <model number> AND Site <site name>
一个站点中的所有有线客户端	LIST WiredClients WITH Site <site name>
站点中的 Mist 边缘	LIST MistEdges WITH Site <site name>

以下示例显示了 LIST 查询的输出。请注意，您可以输入部分 IP 地址来搜索特定子网中的设备。对于其他操作，您可以单击表格左上角的“更多选项”图标。

除了 LIST 查询之外，还可以使用 COUNT 查询来获取与查询匹配的事件或设备的计数。COUNT 查询使用与 LIST 查询相同的结构。下面是一个屏幕截图，显示了 COUNT 查询的示例输出。您可以单击 查看事件列表 以查看事件详细信息。

查看客户端的漫游详细信息

您可以使用 ROAMINGOF 查询查看客户端在不同 AP 之间漫游的图形视图。

ROAMINGOF <client name> DURING <time interval>

查看客户端的状态

STATUSOF 查询概述了在站点或无线 LAN （WLAN） 中遇到连接问题的客户端。查询输出显示客户端的排名列表，从遇到最多问题的客户端开始。通过此查询，您可以快速识别站点中面临连接问题的客户端。您可以在故障排除会话开始时使用此查询来识别受影响的客户端。然后，您可以深入查看客户端详细信息，以查找问题的根本原因。您可以单击某个客户端来查看其服务级别或洞见，也可以在 Marvis 上发起 TROUBLESHOOT 查询。

STATUSOF Clients WITH Site <site name>

您还可以查看面临特定问题的客户端，例如覆盖率问题、吞吐量问题、连接问题等。例如，查询 STATUSOF Clients WITH Problem Capacity 会列出组织中遇到容量问题的所有客户端。

对接入点、站点或客户端进行故障排除

表 3 列出了几个可用于对站点、客户端或接入点进行故障排除的 TROUBLEHOOT 查询。

如果要

表 3：查询疑难解答

对“使用	”进行故障排除
客户端、接入点或站点	TROUBLESHOOT <client/site/AP name>
无线客户端、接入点或面临连接问题的站点	TROUBLESHOOT <client/site/AP name> WITH Problem SlowToConnect TROUBLESHOOT <client/site/AP name> WITH Problem UnableToConnect
某个无线客户端、一个接入点，或某个站点在特定时间内面临连接问题	TROUBLESHOOT <client/site/AP name> WITH Problem UnableToConnect DURING <time duration>

以下屏幕截图显示了查询的 TROUBLESHOOT <site name> WITH Problem UnableToConnect 输出。您将看到 Marvis 提供了问题原因、频段和发生问题的 WLAN 等数据。

您可以通过单击每个类别来深入了解更多详细信息。如果单击 “服务级别 ”类别，Marvis 将提供有关问题的更多详细信息，如以下屏幕截图所示：

查找接入点、站点或客户端

您可以使用 LOCATE 查询查找您的站点、接入点或客户端。查询输出显示您在 “组织”>“站点配置”中配置的站点位置的地图视图。对于接入点和客户端，Marvis 会在平面图上显示这些设备的位置。Marvis 还会显示其他信息，并提供指向“洞察”、“服务级别”和“故障排除”页面的链接。

查看接入点的信道利用率

您可以使用 UTILIZATIONOF 查询查看 AP 正在广播的信道以及 2.4 GHz、5 GHz 和 6 GHz 频段之间的使用级别。您可以单击 “显示频道” 查看接入点使用的所有特定频道的明细。