Microsoft Teams の監視、トラブルシューティング、サポート

チームズの監視

このセクションでは、HDX を使用した Microsoft Teams の最適化を監視するためのガイドラインを提供します。 最適化モードで実行しており、HdxRtcEngine.exe がクライアントマシンで実行されている場合、VDA 上で WebSocketAgent.exe と呼ばれるプロセスがセッションで実行されています。アプリケーションを表示するには、Director の Activity Manager を使用します。

Microsoft Teams の最適化ステータスは、Director > User Details ページ > Session Details パネル > MS Teams Optimization フィールドで確認できます。Microsoft Teams が最適化されていることは、クリアなオーディオとビデオなど、より良いユーザーエクスペリエンスのために不可欠です。この機能は、VDA バージョン 2311 以降で利用可能です。サポートされている Citrix Workspace™ app のバージョンは、「Optimization for Microsoft Teams」に記載されています。Director は、Microsoft Teams が公開アプリケーションとして、または公開デスクトップ内で実行されている場合にのみ、Microsoft Teams の最適化ステータスを表示します。 詳細については、「Microsoft Teams optimization status」を参照してください。

VDA の最小バージョン 1912 以降では、Citrix HDX Monitor (最小バージョン 3.11) を使用してアクティブな Teams 通話を監視できます。Citrix Virtual Apps and Desktops 製品 ISO には、フォルダー layout\image-full\Support\HDX Monitor に最新の hdxmonitor.msi が含まれています。 VDA の最小バージョン 1912 以降では、Citrix HDX Monitor (最小バージョン 3.11) を使用してアクティブな Microsoft Teams 通話を監視できます。Citrix Virtual Apps and Desktops 製品 ISO には、フォルダー layout\image-full\Support\HDX Monitor に最新の hdxmonitor.msi が含まれています。

詳細については、Knowledge Center の記事 CTX253754 の「Monitoring」を参照してください。

トラブルシューティング

このセクションでは、Microsoft Teams の最適化を使用する際に発生する可能性のある問題のトラブルシューティングのヒントを提供します。詳細については、CTX253754 を参照してください。

仮想配信エージェント上で

BCR_x64.msi によって4つのサービスがインストールされます。VDA における Microsoft Teams のリダイレクトを担当するのはそのうち2つだけです。

• Citrix HDX Teams Redirection Service は、Microsoft Teams で使用される仮想チャネルを確立する役割を担っています。このサービスは CtxSvcHost.exe に依存して動作します。

• シトリックス HDX HTML5 ビデオリダイレクションサービス は、WebSocketService.exe として動作し、127.0.0.1:9002 TCP でリッスンしています。WebSocketService.exe は、主に以下の2つの機能を実行します。

  i. セキュアな WebSocket のための TLS 終端 は、Microsoft Teams アプリ内のコンポーネントである vdiCitrixPeerConnection.js からセキュアな WebSocket 接続を受信します。Process Monitor でこれを追跡できます。証明書の詳細については、セクション TLS and HTML5 video redirection, and browser content redirection を参照してください。

  一部のアンチウイルスソフトウェアおよびデスクトップセキュリティソフトウェアは、WebSocketService.exeとその証明書の適切な機能を妨げることがあります。Citrix HDX HTML5ビデオリダイレクトサービスがservices.mscコンソールで実行されている場合でも、netstatで確認できるように、localhost 127.0.0.1:9002 TCPソケットはリッスンモードになっていません。サービスを再起動しようとすると、ハングします（「停止中…」）。WebSocketService.exeプロセスに適切な除外を適用してください。

  

  ii. ユーザーセッションマッピング。 Microsoft Teamsアプリケーションが起動すると、WebSocketService.exeはVDAのユーザーセッションでWebSocketAgent.exeプロセスを開始します。WebSocketService.exeはLocalSystemアカウントとしてセッション0で実行されます。

  

  netstatを使用して、WebSocketService.exeサービスがVDAでアクティブなリッスン状態にあるかどうかを確認できます。

  管理者権限のコマンドプロンプトウィンドウからnetstat -anob -p tcpを実行します。

  

  接続が成功すると、状態はESTABLISHEDに変わります。

  

重要：

WebSocketService.exeは、127.0.0.1:9001と127.0.0.1:9002の2つのTCPソケットでリッスンします。ポート9001はブラウザコンテンツリダイレクトとHTML5ビデオリダイレクトに使用されます。ポート9002はMicrosoft Teamsリダイレクトに使用されます。Teams.exeとWebSocketService.exe間の直接通信を妨げる可能性のあるプロキシ構成がVDAのWindows OSにないことを確認してください。場合によっては、Internet Explorer 11で明示的なプロキシ（インターネットオプション > 接続 > LAN の設定 > プロキシサーバー）を構成すると、接続が割り当てられたプロキシサーバーを経由する可能性があります。手動および明示的なプロキシ設定を使用する場合は、ローカルアドレスにはプロキシサーバーを使用しないがチェックされていることを確認してください。

サービスの場所と説明

シトリックス ワークスペース アプリ

ユーザーのエンドポイントでは、Windows版Citrix WorkspaceアプリがHdxTeams.exeまたはHdxRtcEngine.exeという新しいサービスをインスタンス化します。これは、VDAでMicrosoft Teamsが起動し、ユーザーがセルフプレビューで通話または周辺機器へのアクセスを試みたときに実行されます。このサービスが表示されない場合は、以下を確認してください。

1. 少なくともWindows版Workspaceアプリバージョン1905がインストールされていることを確認してください。WorkspaceアプリのインストールパスにHdxTeams.exeまたはHdxRtcEngine.exeとwebrpc.dllバイナリが表示されますか？
2. ステップ1を検証済みの場合、HdxTeams.exeまたはHdxRtcEngine.exeが起動しているかを確認するには、以下を実行します。
   1. ブイディーエー上でマイクロソフト Teamsを終了します。
   2. VDA上でサービス管理コンソール (services.msc) を起動します。
   3. シトリックス HDX チームズ リダイレクト サービスを停止します。
   4. ICA®セッションを切断します。
   5. ICAセッションに接続します。
   6. Citrix HDX Teams リダイレクト サービスを開始します。
   7. Citrix HDX HTML5 ビデオ リダイレクト サービスを再起動します。
   8. VDA上でMicrosoft Teamsアプリケーションを起動します。
3. クライアントエンドポイントでHdxTeams.exeまたはHdxRtcEngine.exeがまだ起動していない場合は、以下を実行します。
   1. VDAを再起動します。
   2. クライアントエンドポイントを再起動します。

サポート

CitrixとMicrosoftは、Microsoft Teamsの最適化を使用してCitrix Virtual Apps and Desktops™からMicrosoft Teamsを配信することを共同でサポートしています。この共同サポートは、両社間の緊密な連携の結果です。有効なサポート契約があり、このソリューションで問題が発生した場合は、問題の原因となっていると思われるコードのベンダーにサポートチケットをオープンしてください。つまり、TeamsについてはMicrosoft、最適化コンポーネントについてはCitrixです。 CitrixまたはMicrosoftがチケットを受け取り、問題をトリアージし、必要に応じてエスカレートします。各社のサポートチームに連絡する必要はありません。

問題が発生した場合は、Teams UIで[ヘルプ] > [問題の報告]をクリックすることをお勧めします。VDA側のログは、技術的な問題をより迅速に解決するために、CitrixとMicrosoft間で自動的に共有されます。

ログの収集

HDXメディアエンジンのログは、ユーザーのマシン（VDA上ではない）で見つけることができます。問題が発生した場合は、必ずサポートケースにログを添付してください。

Windows イベントログ:

You can locate Windows logs at %TEMP% inside the HDXTeams folder (AppData/Local/Temp/HDXTeams or AppData/Local/Temp/HdxRtcEngine). Look for a .txt file called webrpc_Day_Month_timestamp_Year.txt. If you are using newer versions of Citrix Workspace app, for example Citrix Workspace app 2009.5 or later, store the logs in AppData\Local\Temp\HdxRtcEngine.

各セッションは、ログ用に個別のフォルダーを作成します。

Macログ:

1. VDWEBRTCログ - 仮想チャネルの実行を記録します。

   場所:/Users/<User Name>/Library/Logs/Citrix Workspace/CitrixViewer_<Y_M_D_H_M_S>.txt

2. HdxRtcEngineログ - HdxRtcEngine上のプロセスの実行を記録します。

   場所: $TMPDIR/hdxrtcengine/<W_M_D_H_M_S_Y>/hdxrtcengine.log

   HdxRtcEngine ログはデフォルトで有効になっています。

3. Webrpc ログ - webrtc ライブラリのラップアップの実行を記録する最も重要なログです。

   場所: /Users/<USERNAME>/Library/Logs/HdxRtcEngine/<W_M_D_H_M_S_Y>/webrpc.log

Linux ログファイル:

Linux ログは /tmp/webrpc/<current date>/ and /tmp/hdxrtcengine/<current date>/ フォルダーにあります。 Webrtc ログ: /tmp/webrpc/<current date>/webrtc.log カーネルログ: /var/log/syslog

ICE/STUN/TURN/ logs:

通話を確立する際には、次の4つのICEフェーズが必要です。

• 候補の収集
• 候補の交換
• 接続性チェック (STUN バインド要求)
• 候補の昇格

HdxRtcEngine.exe ログには、関連するInteractive Connectivity Establishment (ICE) エントリが含まれています。これらのエントリは、通話設定が成功するために必要です。収集段階のサンプルスニペットを以下に示します。

RPCStubs Info: -> device id = \\?\display#int3470#4&1835d135&0&uid13424#{65e8773d-8f56-11d0-a3b9-00a0c9223196}\{bf89b5a5-61f7-4127-a279-e187013d7caf} label = Microsoft Camera Front groupId =

webrtcapi.RTCPeerConnection Info: createOffer. audio = 1 video = 1
webrtcapi.RTCPeerConnection Info: setLocalDescription.
>>> begin:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnSignalingChange. signaling state = HaveLocalOffer

webrtcapi.RTCPeerConnection Info: OnIceGatheringChange. state = Gathering

[…]
>>> begin:sdp
candidate:840548147 1 udp 2122194687 10.108.124.215 56927 typ host generation 0 ufrag oVk6 network-id 1
<<< end:sdp
[…]
>>> begin:sdp
candidate:1938109490 1 udp 24911871 52.114.xxx.xxx 52786 typ relay raddr 73.205.xxx.x rport 25651 generation 0 ufrag dDML network-id 1 network-cost 10
<<< end:sdp
[…]
>>> begin:sdp
candidate:4271145120 1 udp 1685987071 66.xxx.xxx.xxx 55839 typ srflx raddr 10.108.124.215 rport 55839 generation 0 ufrag uAVH network-id 1
<<< end:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnIceGatheringChange. state = Complete webrtcapi.RTCPeerConnection Info: setRemoteDescription.
>>> begin:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnSignalingChange. signaling state = HaveRemotelOffer

<!--NeedCopy-->

複数のICE候補がある場合、優先順位は次のとおりです。

1. ホスト
2. ピア反射型
3. サーバーリフレクシブ
4. トランスポートリレー

問題が発生し、それを一貫して再現できる場合は、Microsoft Teamsでヘルプ > 問題の報告をクリックすることをお勧めします。Microsoftにケースをオープンした場合、技術的な問題を解決するために、ログはCitrixとMicrosoftの間で共有されます。 Citrixサポートに問い合わせる前にCDFトレースをキャプチャすることも有益です。詳細については、Knowledge Centerの記事CDFcontrolを参照してください。

CDF Tracesの収集に関する推奨事項については、Knowledge Centerの記事CDF Tracesの収集に関する推奨事項を参照してください。

VDA側のCDFトレース - 以下のCDFトレースプロバイダーを有効にしてください:

Workspaceアプリ側のCDFトレース - 以下のCDFトレースプロバイダーを有効にしてください:

• IcaClient_DriversVd_TeamsRedir (optional)
• IcaClient_Multimedia_HdxTeams (シトリックス ワークスペース アプリ 2012 以降が必要です)