ThousandEyes データを表示するために必要な Webex バージョン

Control Hub の ThousandEyes エンドポイントの自動セッションテスト (AST) とのトラブルシューティングの統合には、Webex アプリのデスクトップバージョン 42.7 以降 が必要です。


 

ThousandEyes AST は、デスクトップ バージョンの Webex Meetings アプリと Webex アプリの両方をサポートしています。 ただし、トラブルシューティングのインテグレーションには、デスクトップ バージョンの Webex アプリから参加するユーザーのネットワーク パスしか表示されません。

Webex Calling の ThousandEyes

Webex Calling の顧客は、Control Hub で Webex Calling のメディア品質の問題をトラブルシューティングできます。 しかし、ThousandEyes統合を使用すると、ThousandEyesアプリケーションにクロス起動して、ネットワークの詳細と詳細な分析を行うことができます。 分単位のデータが収集されます。 Webex Calling では通常、1 分あたりの収集が推奨されます。

ThousandEyes メトリクスが使用可能な場合、メディア通話では、クロスローンチリンクとコピーリンクが Control Hub で使用できます。 通話セッションにメディアがない場合、ThousandEyes リンクは提供されません。

制限事項

  • ThousandEyes for Webex Calling は、Webex アプリ デスクトップでの通話のみをサポートします。
  • ThousandEyes データは、すべての Webex Calling 通話には適用されません。 同じネットワーク内にコールが確立されている場合、Webex Calling クラウドを通過しない ICE 最適化されたコールと見なされる場合があります。 したがって、ThousandEyes パスはこのシナリオでは表示されません。
  • テストでは、実際の通話に影響がなかったにもかかわらず、VPN が使用されたときに 100% のパケット損失が示されました。 この問題は、次の Endpoint Agent Client リリースで解決されます。 詳細については、ThousandEyesドキュメンテーションのリリースノート
Control Hub screenshot showing the network path of a Webex Calling call and the ThousandEyes cross-launch links.

Board、Desk、および Room シリーズデバイス用の ThousandEyes

Cisco コラボレーション デバイスの ThousandEyes データを表示する場合は、これらのデバイスと ThousandEyes Agent のインテグレーションを設定する方法について、この記事を参照してください

ThousandEyes のトラブルシューティングの仕組み

ネットワーク パスは、ラウンドトリップの損失、クライアントから各ホップへの遅延、およびホップから次のホップへの遅延の合計を提供します。

マシンに ThousandEyes エンドポイント エージェントがインストールされているユーザーが Webex アプリまたは Cisco コラボレーション デバイスを使用してミーティングに参加すると、参加者の詳細ページの [音声品質] に [ネットワーク パス] 行が表示されます。 この線は、ユーザーのクライアントと音声メディア ノード間における音声データのネットワーク パスの品質を示します。 通常、音声とビデオのデータは同じパスを移動し、同じメディア ノードによって処理されるため、ユーザーのビデオ品質についても把握できるようになります。 ネットワーク パスの品質は点線で表示されます。 各点線は、自動セッション テストで設定された間隔に基づいています。

ネットワークパスでThousandEyesによって報告された損失(往復)は、アプリケーションエラーの回復前の損失率です。 エラーリカバリ前のパケット損失が大きい場合、アプリケーションが再送信中にパケット損失を回収した可能性があるため、必ずしもユーザーエクスペリエンスが低いとは言えません。 Webex アプリはパケットリカバリを実行し、ネットワーク接続不良時のユーザーエクスペリエンスを向上させます。

エラー リカバリ後に後者の値が測定されるため、損失 (往復) は音声品質でのパケット損失値と一致しません。 音声品質のパケット損失は、実際のユーザーエクスペリエンスのより良いインジケータです。


 

ThousandEyes AST は、ミーティングが開始されるとすぐにネットワーク パス データのキャプチャを開始します。 ただし、トラブルシューティングでデータが入力されるまで最大 5 分の遅延が発生する可能性があります。 ライブミーティングを表示するときに、データがまだ入力されていない場合は、5 分後にページを更新します。

ThousandEyes network path in Troubleshooting

点線にカーソルを合わせると、その間隔中のユーザーのレイテンシー (往復) 平均値を確認できます。 値が満たされたしきい値に応じて色が変わります。 しきい値は次のように計算されます。

  • 不良(赤):遅延が400msを超えているか、損失(往復)が5%を超えている
  • 良(良)—遅延が300ms未満または損失(往復)が3%未満
  • フェア(黄色):上記のいずれにも該当しません。
  • 不明(グレー):ThousandEyes から Control Hub にデータを使用できません。 ThousandEyes ダッシュボードからメトリックを直接取得できる場合があります。

ポップアップ ウィンドウをクリックして、ホップが各ノードに取ったパス ルートに関する詳細な情報を表示します。

ThousandEyes pop-up tooltip in Troubleshooting

ネットワーク パス ルートは、各ノードの詳細な詳細を示します

ネットワーク パス ルートには、ホップが接続した各ノードの詳細が表示されます。 レイテンシー列には、クライアントのマシンから次のホップまでのレイテンシーが表示されます。 リンクの遅延は括弧内に示され、これは最後のホップから現在のホップまでの遅延です。

ユーザーマシンノードの詳細

ThousandEyes in Troubleshooting user machine details

このノードには、ユーザマシンのネットワークの詳細が表示されます。

表 1. ユーザーマシンノードの詳細
名前説明
名前ユーザーのマシンの名前。
IP アドレスユーザーのマシンの IP アドレス。
プライベート IPv4ユーザーのマシンのプライベート IPv4 アドレス。
損失(往復)ユーザーのマシンのパケット損失を送信します。
遅延ユーザーのマシンのエンドツーエンドのレイテンシー。
ジッターユーザーのマシンのジッタを送信します。
場所ユーザーのマシンの場所。 マシンが VPN に接続されている場合、代わりに VPN の場所が表示されます。

接続タイプ ノードの詳細

ThousandEyes in Troubleshooting connection type details

このノードには、ユーザのマシンの接続タイプに関する詳細が表示されます。

表 2. 接続タイプの詳細
名前説明
名前ネットワーク接続の名前。
SSIDネットワークのサービスセット識別子。
物理モードネットワークが使用している物理モードのタイプ。
チャネルネットワークが使用しているチャネル。
リンク速度ネットワークが使用している帯域幅の速度。
場所ユーザーのマシンの場所。 マシンが VPN に接続されている場合、代わりに VPN の場所が表示されます。

VPN ノードの詳細

ThousandEyes in Troubleshooting VPN node details

ユーザーのマシンが VPN に接続されている場合、使用される VPN の詳細を確認できます。

表 3. VPNの詳細
名前説明
名前VPNの名前。
VPN ゲートウェイ IPVPN が接続するゲートウェイ IP。
VPN タイプ使用するVPNの種類。

ネットワーク ノードの詳細

ThousandEyes in Troubleshooting network node details

このノードは、インターバル中に作成されたすべてのホップの詳細を示します。 ノードが 100 ms を超える遅延を持つノードに 1 つのホップがある場合、ノードは赤色で強調表示されます。


 
これらのノードは ICMP 要求に応答しないため、不明なノードには情報が表示されません。
表 4. ネットワーク ノードの詳細
名前説明
名前ホップの名前。
IP アドレスホップのIPアドレス。
プレフィックスホップの IP アドレスのプレフィックス。
レイテンシー(リンク遅延)括弧内の数字は、ユーザーのマシンからこのホップまでのレイテンシーです。 括弧の外側の番号は、最後のホップからこのホップまでのレイテンシーです。
ネットワークホップのネットワーク。
場所ホップの場所。

始める前に

トラブルシューティングで ThousandEyes ネットワーク パス データを表示するには、次の手順を実行する必要があります。

  • ThousandEyesでアカウントグループにユーザーを割り当てます。

     
    ユーザーをアカウント グループに割り当てる場合は、エンドポイント エージェント データを表示できるThousandEyesでロールを持つユーザーを割り当てることを確認します。 修正権限を持たないロールを持つユーザーは、ThousandEyes データを表示できません。 ThousandEyes データの表示に必要な最小権限は次のとおりです。
    • エンドポイント エージェント データの表示
    • エンドポイント エージェントが監視するドメイン セットを表示する
    • エンドポイント エージェント監視ネットワークを表示
    • エンドポイント エージェント設定を表示
    • エンドポイント エージェントを識別するエンドポイント データを表示する
    • ネットワークを識別するエンドポイントデータを表示する
    • ユーザーを識別するエンドポイント データを表示する
    • 訪問したページを識別するエンドポイントデータを表示する
    • エンドポイントテストを表示
    Permissions needed for a role in ThousandEyes to view endpoint agent data
  • ThousandEyes データを表示するマシンにエンドポイント エージェント をインストールします。

     
    マシンにインストールされたエンドポイント エージェントで TCP ドライバが有効になっているかどうかを確認するには、Endpoint Agents > Agent Settings > Endpoint Agentsです。 TCP が有効になっていない場合は、この powershell スクリプトを使用して、インストール後の TCP ドライバ をインストールできます。Endpoint agent with TCP enabled in ThousandEyes dashboard
  • Webex の自動セッションテスト を作成し、監視するエージェントを選択します。 次の方法で AST を設定することをお勧めします。
    • ターゲット—Webex
    • [プロトコル(Protocol)]:間隔を 1 分として自動検出します。
    • エージェント—すべてのエージェント
    • エージェントの最大数—5000
  • の「ユーザーAPIトークン」セクションに移動して、ThousandEyesでトークンを作成する アカウント設定 > ユーザーとロール > プロファイル
  • ThousandEyes のすべてのインストール手順が完了したら、次の手順に従って Control Hub で ThousandEyes インテグレーションを有効にします。
1

Control Hubにサインインし、[組織設定]に移動して、[ThousandEyes]セクションまでスクロールします。

2

[ThousandEye API アクセスを許可] スイッチをオンに切り替えます。

ThousandEyes setting in Control Hub
ポップアップ ウィンドウが表示されます。
3

ThousandEyes ユーザー API トークンセクションからコピーした OAuth ベアラー トークンを貼り付けます。

トークンが検証されている場合は、次のステップに進むことができます。 トークンが検証されていない場合、エラーがポップアップします。 トークンが ThousandEyes User API トークンセクションでコピーしたトークンと一致していることを確認してください。Activating ThousandEyes in Control Hub with a token
4

[有効化] をクリックします。

次に行うこと

ThousandEyes エンドポイント エージェントは、エンドポイント エージェントがマシンにインストールされている場合、ミーティングに参加するたびにユーザーを監視します。


 

ThousandEyes エンドポイント エージェントがマシンにインストールされているユーザーのみ、ThousandEyes データを表示できます。

1

Control Hub にサインインし、[トラブルシューティング] に移動します。

2

ユーザーを検索し、ミーティングまたは通話を選択します。

3

ユーザーの名前をクリックします。

4

ネットワークパスの点の上にカーソルを合わせると、ThousandEyesネットワークデータが表示されます。

5

ThousandEyesアイコンをクリックして、ThousandEyesダッシュボードにクロス起動して、より詳細なネットワークデータを表示します。