Troubleshoot Using Marvis Query Language

View Event and Device Details

To troubleshoot problems and understand network behavior, you might need to look at event details or device details. You can use the LIST query to view details for the following:

Access points (APs)
Clients (including wired clients)
Switches
AP events
Client events
Switch events
Mist Edges
Mist Edge events

Table 1 and Table 2 provide a few LIST queries that you can use as a reference to build queries based on your requirements.

Table 1: Key LIST Queries to View Events
If you want to view	Use
Client events for an AP during a specific time interval	`LIST ClientEvents WITH AccessPoint <AP name> DURING <time duration>`
All events for an AP	`LIST ApEvents WITH AccessPoint <AP name>`
Events of a specific type for an AP	`LIST ApEvents WITH ApEventType <event-type> AND AccessPoint <ap-name>`
All events for a switch	`LIST SwitchEvents WITH Switch <switch name>`
Events of a specific type for a switch	`LIST SwitchEvents WITH SwitchEventType <event-type> AND Switch <switch-name>`
All events for Mist Edges at a specific site	`LIST MistEdgeEvents WITH Site <site-name>`

The following example shows the events for all clients associated with a particular AP. To view more details about an event, you can click the arrow in the first column of the table.

Screenshot of the Marvis platform showing client events for access point LD_Friday over 7 days, including event time, type, client MAC address, SSID Live_demo_do_not_remove, BSSID, protocol, and frequency band.

This example shows the list for a specific event type:

Query results from a network management tool showing client events for access point LD_Friday over 7 days, including site Live-Demo, PSK authentication, RSSI -67, capabilities 80Mhz/40Mhz, time since association 3372 seconds, 3 streams, protocol AC, PMF enabled, client ID, and a PSK mismatch error log.

Table 2: Key LIST Queries to View Devices
If you want to view	Use
Switches of a particular model in a site	`LIST Switches WITH Model <model number> AND Site <site name>`
Clients connected to an AP	`LIST Clients WITH AccessPoint <AP name>`
APs of a specific model in a site	`LIST APs WITH Model <model number> AND Site <site name>`
All the wired clients in a site	`LIST WiredClients WITH Site <site name>`
Mist Edges in a site	`LIST MistEdges WITH Site <site name>`

The following example shows the output for a LIST query. Note that you can enter a partial IP address to search for devices in specific subnets. For additional actions, you can click the More Options icon at the top-left corner of the table.

Screenshot of MARVIS network management interface showing a query result for access points with model AP41 at site Live-Demo. Columns include Name, MAC Address, Model, Version, IP Address, Site, and additional technical details like port speed and channel info. A dropdown menu provides options for Details, Insights, Service Levels, and Troubleshoot.

In addition to the LIST query, you can use the COUNT query to get a count of events or devices that match the query. The COUNT query uses the same structure as the LIST query. Here is a screenshot that shows a sample output for the COUNT query. You can click VIEW EVENT LIST to see the event details.

Screenshot of MARVIS query results showing 2 events matching the search for radar detection on access point LD_JSW during last 7 days. Includes a red button labeled VIEW EVENT LIST and a star rating section asking for response feedback.

View Roaming Details of a Client

You can use the ROAMINGOF query to see a graphical view of a client roaming between different APs.

ROAMINGOF <client name> DURING <time interval>

View Status of a Client

The STATUSOF query provides an overview of clients that are facing connectivity issues in a site or wireless LAN (WLAN). The query output displays a ranked list of clients, starting with the clients experiencing the greatest number of issues. With this query, you can quickly identify clients facing connectivity issues in your site. You can use this query at the start of a troubleshooting session to identify the affected clients. You can then drill down into the client details to find the root cause of the issue. You can click a client to look at its service levels or insights, or to initiate the TROUBLESHOOT query on Marvis.

STATUSOF Clients WITH Site <site name>

Screenshot of MARVIS showing client connection analysis for the past 7 days. 1 of 50 clients has connection problems. Bar chart ranks clients by correlation to connection issues, divided into weak, medium, and strong sections, with most showing weak correlation.

You can also view clients facing specific problems such as coverage issues, throughput problems, connectivity issues, and so on. For example, the query STATUSOF Clients WITH Problem Capacity lists all clients experiencing capacity issues in your organization.

Troubleshoot APs, Sites, or Clients

Table 3 lists a few TROUBLEHOOT queries that you can use to troubleshoot a site, a client, or an AP.

Table 3: TROUBLESHOOT Queries
If you want to troubleshoot	Use
A client, an AP, or a site	`TROUBLESHOOT <client/site/AP name>`
A wireless client, an AP, or a site facing connectivity issues	`TROUBLESHOOT <client/site/AP name> WITH Problem SlowToConnect` `TROUBLESHOOT <client/site/AP name> WITH Problem UnableToConnect`
A wireless client, an AP, or a site facing connectivity issues for a specific duration	`TROUBLESHOOT <client/site/AP name> WITH Problem UnableToConnect DURING <time duration>`

The following screenshot shows the output for the TROUBLESHOOT <site name> WITH Problem UnableToConnect query. You'll see that Marvis provides data such as the cause of the issue, the band, and the WLAN on which the issue occurred.

Troubleshooting interface for MARVIS analyzing UnableToConnect issue at Live-Demo site. Clients failed to connect 74 percent of the time due to authorization problems, mostly on the 5 GHz band and Live_demo_only WLAN, with correlation to LD_Marvis access point. Options include Service Levels, Anomalies, Classifiers, Correlation, Updates, Events, and Location for further investigation.

You can drill down into more details by clicking each of the categories. If you click the Service Levels category, Marvis provides more details about the issue as shown in the following screenshot: Network troubleshooting interface showing query results for UnableToConnect issue on Live-Demo network. Authorization problems identified as main cause, with failures linked to LD_Marvis access point and 5 GHz band. Graph displays successful and failed connection attempts over time.

Locate APs, Sites, or Clients

You can use the LOCATE query to find your site, AP, or client. The query output displays a map view of the site location that you configured in Organization > Site Configuration. For APs and clients, Marvis shows the location of these devices on your floorplan. Marvis also displays additional information and provides links to the Insights, Service Levels, and Troubleshoot pages.

Marvis UI showing access point AP01 location on a labeled floor plan, highlighted in blue, with panel details including name, MAC address, clients, channels, and transmission power.

View Channel Utilization of an AP

You can use the UTILIZATIONOF query to view the channels that an AP is broadcasting and the usage levels between the 2.4 GHz, 5 GHz, and 6 GHz bands. You can click Show Channels to see a breakdown of all specific channels that the AP uses.

Channel Utilization graph showing 2.4 GHz and 6 GHz bands over the last 7 days with utilization percentage on the y-axis and dates on the x-axis.