Marvisクエリー言語を使用したトラブルシューティング

これらの例を使用して、Marvisクエリを使用してネットワークを監視し、トラブルシューティングする方法を確認してください。

イベントとデバイスの詳細を表示

問題をトラブルシューティングし、ネットワークの動作を理解するには、イベントの詳細やデバイスの詳細を確認する必要がある場合があります。LISTクエリを使用して、以下の詳細を表示できます。

  • アクセスポイント(AP)

  • クライアント(有線クライアントを含む)

  • スイッチ

  • APイベント

  • クライアントイベント

  • スイッチイベント

  • Mist Edge

  • Mist Edgeイベント

表 1 と 表 2 に、要件に基づいてクエリを作成するための参照として使用できるいくつかの LIST クエリを示します。

表1:イベントを表示するための主要なLISTクエリ
見たい場合は 使用する
特定の時間間隔でのAPのクライアントイベント LIST ClientEvents WITH AccessPoint <AP name> DURING <time duration>
APのすべてのイベント LIST ApEvents WITH AccessPoint <AP name>
APの特定のタイプのイベント 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 Edgesのすべてのイベント LIST MistEdgeEvents WITH Site <site-name>

次の例は、特定の AP に関連するすべてのクライアントのイベントを示しています。イベントの詳細を表示するには、表の最初の列にある矢印をクリックします。

Marvis platform screenshot showing client events for access point LD_Friday over 7 days, including time, event type, MAC address, SSID, BSSID, protocol, and band details for troubleshooting connectivity issues.

この例では、特定のイベントタイプの一覧を示しています。

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

表2:デバイスを表示するための主要なLISTクエリー
見たい場合は 使用する
サイト内の特定のモデルのスイッチ LIST Switches WITH Model <model number> AND Site <site name>
APに接続されたクライアント LIST Clients WITH AccessPoint <AP name>
サイト内の特定モデルのAP LIST APs WITH Model <model number> AND Site <site name>
サイト内のすべての有線クライアント LIST WiredClients WITH Site <site name>

サイト内のMist Edge

LIST MistEdges WITH Site <site name>

以下の例は、LIST クエリの出力を示しています。IP アドレスの一部を入力して、特定のサブネット内のデバイスを検索できます。追加のアクションを行うには、テーブルの左上隅にあるその他のオプションアイコンをクリックします。

Query results in Marvis showing two access points with model AP41 at site Live-Demo, including MAC address, IP address, and technical details like port speed and TxPower.

LIST クエリに加えて、COUNT クエリを使用して、クエリに一致するイベントまたはデバイスのカウントを取得できます。COUNT クエリは、LIST クエリと同じ構造を使用します。以下は、COUNT クエリの出力例を示すスクリーンショットです。 イベントリストを表示 をクリックすると、イベントの詳細を確認できます。

Query result in MARVIS showing 2 DFS-Radar-Detected events on access point LD_JSW within the last 7 days. Red-highlighted button labeled VIEW EVENT LIST for more details.

クライアントのローミング詳細の表示

ROAMINGOFクエリを使用すると、異なるAP間でローミングしているクライアントのグラフィカルビューを見ることができます。

ROAMINGOF <client name> DURING <time interval>

クライアントのステータスの表示

STATUSOF クエリは、サイトまたは 無線LAN (WLAN) で接続の問題に直面しているクライアントの概要を提供します。クエリ出力には、問題が最も多いクライアント順に、クライアントのランク付けされたリストが表示されます。このクエリを使用すると、サイト内で接続の問題に直面しているクライアントをすばやく特定できます。トラブルシューティングセッションの開始時にこのクエリを使用して、影響を受けるクライアントを特定できます。その後、クライアントの詳細をドリルダウンして、問題の根本的原因を見つけることができます。クライアントをクリックしてサービスレベルやインサイトを確認したり、Marvisでトラブルシューティングクエリーを開始したりできます。

STATUSOF Clients WITH Site <site name>

Screenshot of Marvis query result showing 1 out of 50 clients with connection issues at a site over 7 days. Bar chart ranks clients by correlation to connection attempts, divided into Weak, Medium, and Strong sections.

また、カバレッジの問題、スループットの問題、接続の問題など、特定の問題に直面しているクライアントを表示することもできます。たとえば、クエリ STATUSOF Clients WITH Problem Capacity には、組織内で容量の問題が発生しているすべてのクライアントが一覧表示されます。

AP、サイト、またはクライアントのトラブルシューティング

表3は 、サイト、クライアント、またはAPのトラブルシューティングに使用できるいくつかのTROUBLEHOOTクエリを示しています。

表3:クエリのトラブルシューティング
トラブルシューティングが必要な場合 使用する
クライアント、AP、またはサイト TROUBLESHOOT <client/site/AP name>
接続の問題に直面している無線クライアント、AP、またはサイト TROUBLESHOOT <client/site/AP name> WITH Problem SlowToConnect

TROUBLESHOOT <client/site/AP name> WITH Problem UnableToConnect

特定の期間にわたって接続の問題に直面している無線クライアント、AP、またはサイト TROUBLESHOOT <client/site/AP name> WITH Problem UnableToConnect DURING <time duration>

次のスクリーンショットは、 TROUBLESHOOT <site name> WITH Problem UnableToConnect クエリの出力を示しています。Marvisから、問題の原因、帯域、問題が発生したWLANなどのデータが表示されます。

Troubleshooting interface in MARVIS analyzing UnableToConnect issue for Live-Demo site. Clients failed to connect 74 percent of the time due to authorization issues on the 5 GHz band and Live_demo_only WLAN, mainly linked to LD_Marvis access point. Options for investigation include Service Levels, Anomalies, Classifiers, Correlation, Updates, Events, and Location. Includes close button and rating option.

各カテゴリをクリックすると、詳細にドリルダウンできます。サービス レベル カテゴリをクリックすると、次のスクリーンショットに示すように、Marvisに問題の詳細が表示されます。Screenshot of the MARVIS troubleshooting interface diagnosing a connectivity issue for the Live-Demo network. 74 percent of connection attempts failed due to authorization problems, mainly on the 5 GHz band and Live_demo_only WLAN, correlated with the LD_Marvis access point. A graph shows total and failed attempts over time, with expandable sections for additional diagnostics like anomalies and updates.

AP、サイト、またはクライアントの特定

LOCATE クエリを使用して、サイト、AP、またはクライアントを検索できます。クエリ出力には、 組織>サイト設定で設定したサイトの場所のマップビューが表示されます。APとクライアントの場合、Marvisはこれらのデバイスの場所をフロアプランに表示します。Marvisには追加情報も表示され、インサイト、サービスレベル、トラブルシューティングページへのリンクも提供されます。

Marvis platform interface showing AP01 location on a floor plan with labeled rooms. Right panel displays AP01 details: name, MAC address, connected clients by frequency band, channel usage, and transmission power. Tabs for Insights, Service Levels, and Troubleshoot are visible.

APのチャネル使用率の表示

UTILIZATIONOF クエリーを使用して、APがブロードキャストしているチャネルと、2.4 GHz、5 GHz、6 GHz帯域の使用レベルを表示できます。 チャネルを表示をクリックすると 、APが使用するすべての特定のチャネルの内訳を確認できます。

Marvis dashboard graph showing 7-day channel utilization for 2.4 GHz and 5 GHz bands; 2.4 GHz in blue, 5 GHz in orange.