Microsoft Teamsの監視、トラブルシューティング、サポート
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つのサービスがインストールされます。そのうち2つだけが、VDA での Microsoft Teams リダイレクトを担当します。
ブラウザコンテンツリダイレクトによってインストールされる4つのサービス (/en-us/citrix-virtual-apps-desktops/2411/media/team-services.png)
-
Citrix HDX Teams Redirection Serviceは、Microsoft Teamsで使用される仮想チャネルを確立します。このサービスはCtxSvcHost.exeに依存しています。
-
Citrix HDX HTML5 Video Redirection Service は、127.0.0.1:9002 TCP でリッスンする WebSocketService.exe として実行されます。WebSocketService.exe は主に2つの機能を実行します。i. セキュアな WebSocket のための TLS 終端 は、Microsoft Teams アプリ内のコンポーネントである vdiCitrixPeerConnection.js からセキュアな WebSocket 接続を受信します。Process Monitor でこれを追跡できます。証明書の詳細については、セクション (TLS および HTML5 ビデオリダイレクト、ブラウザコンテンツリダイレクト) を参照してください。一部のアンチウイルスソフトウェアやデスクトップセキュリティソフトウェアは、
WebSocketService.exeとその証明書の適切な機能を妨げます。Citrix HDX HTML5ビデオリダイレクトサービスがservices.mscコンソールで実行されている場合でも、netstatで確認できるように、localhost127.0.0.1:9002TCPソケットはリスニングモードになっていません。サービスを再起動しようとするとハングします(「停止中…」)。WebSocketService.exeプロセスに適切な除外を適用していることを確認してください。「プロセスモニター」(/en-us/citrix-virtual-apps-desktops/2411/media/team-process-monitor.png)ii. ユーザーセッションマッピング。 Microsoft Teamsアプリケーションが起動すると、WebSocketService.exeはVDAのユーザーセッションでWebSocketAgent.exeプロセスを開始します。WebSocketService.exeはLocalSystemアカウントとしてセッション0で実行されます。「WebSocketAgent.exeサービス」(/en-us/citrix-virtual-apps-desktops/2411/media/websocketservice-websocketagent.png)netstatを使用して、WebSocketService.exeサービスがVDAでアクティブなリスニング状態にあるかどうかを確認できます。管理者として実行しているコマンドプロンプトウィンドウからnetstat -anob -p tcpを実行します。
接続が成功すると、状態はESTABLISHEDに変わります。「netstatの成功例」(/en-us/citrix-virtual-apps-desktops/2411/media/teams-netstat-success.png)
重要:
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 Server OSの実行可能ファイルへのパス | ログオンアカウント | 説明 |
|---|---|---|---|
| Citrix HTML5ビデオ リダイレクトサービス | "C:\Program Files (x86)\Citrix\System32\WebSocketService.exe" /service | ローカルシステムアカウント | 仮想デスクトップとエンドポイントデバイス間でメディアリダイレクトを実行するために必要な初期フレームワークを、複数のHDXマルチメディアサービスに提供します。 |
| Citrix HDX ブラウザ リダイレクトサービス | "C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe" -g BrowserRedirSvcs | このアカウント (ローカルサービス) | エンドポイントデバイスと仮想デスクトップ間でブラウザコンテンツリダイレクトを提供します。 |
| Citrix ポートフォワーディングサービス | "C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe" -g PortFwdSvcs | このアカウント (ローカルサービス) | ブラウザコンテンツリダイレクトのために、エンドポイントデバイスと仮想デスクトップ間でポート転送を提供します。 |
| Citrix HDX Teams リダイレクトサービス | "C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe" -g TeamsSvcs | ローカルシステムアカウント | エンドポイントデバイスと仮想デスクトップ間でMicrosoft Teamsのリダイレクトを提供します。 |
シトリックス ワークスペース アプリ
ユーザーのエンドポイントでは、Windows版Citrix WorkspaceアプリがHdxTeams.exeまたはHdxRtcEngine.exeという新しいサービスをインスタンス化します。これは、VDAでMicrosoft Teamsが起動し、ユーザーがセルフプレビューで通話しようとしたり、周辺機器にアクセスしようとしたりするときに行われます。このサービスが表示されない場合は、以下を確認してください。
-
Windows 用 Workspace アプリ バージョン 1905 以降がインストールされていることを確認します。Workspace アプリのインストールパスに HdxTeams.exe または HdxRtcEngine.exe と webrpc.dll バイナリが表示されますか?
-
手順1を確認したら、HdxTeams.exe または HdxRtcEngine.exe が起動しているかどうかを確認するために、次の操作を行います。
-
VDA 上の Microsoft Teams を終了します。
-
VDA で services.msc を起動します。
-
Citrix HDX Teams Redirection Service を停止します。
-
ICA® セッションを切断します。
-
ICA セッションを接続します。
-
Citrix HDX Teams Redirection Service を開始します。
-
Citrix HDX HTML5 Video Redirection Service を再起動します。
-
VDA 上で Microsoft Teams を起動します。
-
-
クライアントエンドポイントで HdxTeams.exe または HdxRtcEngine.exe が起動しない場合は、次の操作を行います。
-
VDA を再起動します。
-
クライアントエンドポイントを再起動します。
-
サポート
CitrixとMicrosoftは、Microsoft Teamsの最適化を使用して、Citrix Virtual Apps and Desktops™からのMicrosoft Teamsの提供を共同でサポートしています。この共同サポートは、両社間の緊密な連携の結果です。有効なサポート契約があり、このソリューションで問題が発生した場合は、問題の原因となっていると思われるコードのベンダーにサポートチケットをオープンしてください。つまり、TeamsについてはMicrosoft、最適化コンポーネントについてはCitrixです。 CitrixまたはMicrosoftがチケットを受け取り、問題をトリアージし、必要に応じてエスカレートします。各社のサポートチームに連絡する必要はありません。
ログの収集
HDXメディアエンジンログは、ユーザーのマシン(VDA上ではない)で見つけることができます。問題が発生した場合は、必ずサポートケースにログを添付してください。
Windowsログ:
Windowsログは、HDXTeamsフォルダー内の%TEMP%にあります(AppData/Local/Temp/HDXTeamsまたはAppData/Local/Temp/HdxRtcEngine)。webrpc_Day_Month_timestamp_Year.txtという名前の.txtファイルを探してください。Citrix Workspaceアプリの新しいバージョン(Citrix Workspaceアプリ2009.5以降など)を使用している場合は、ログをAppData\Local\Temp\HdxRtcEngineに保存します。
各セッションはログ用の個別のフォルダーを作成します。
Macログ:
-
VDWEBRTCログ - 仮想チャネルの実行を記録します。場所:
/Users/<User Name>/Library/Logs/Citrix Workspace/CitrixViewer_<Y_M_D_H_M_S>.txt -
HdxRtcEngineログ - HdxRtcEngine上のプロセスの実行を記録します。場所:
$TMPDIR/hdxrtcengine/<W_M_D_H_M_S_Y>/hdxrtcengine.logHdxRtcEngineログはデフォルトで有効になっています。 -
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/ログ:
通話の確立時には、次の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
複数の ICE 候補がある場合、優先順位は次のとおりです。
-
ホスト
-
ピア反射型
-
サーバー反射型
-
トランスポートリレー
問題が発生し、それを一貫して再現できる場合は、Microsoft Teams で ヘルプ > 問題の報告 をクリックすることをお勧めします。Microsoft にケースを登録した場合、技術的な問題を解決するためにログが Citrix と Microsoft の間で共有されます。 Citrix Support に問い合わせる前に CDF トレースをキャプチャすることも役立ちます。詳細については、Knowledge Center の記事 CDFcontrol を参照してください。
CDF トレースを収集するための推奨事項については、Knowledge Center の記事 Recommendations for Collecting the CDF Traces を参照してください。
VDA側のCDFトレース - 次のCDFトレースプロバイダーを有効にします。
Workspaceアプリ側のCDFトレース - 次のCDFトレースプロバイダーを有効にします。
-
IcaClient_DriversVd_TeamsRedir (オプション)
-
IcaClient_Multimedia_HdxTeams (Citrix Workspaceアプリ2012以降が必要)