Microsoft Teams の監視、トラブルシューティング、サポート
チームズの監視
このセクションでは、HDX を使用した Microsoft Teams の最適化を監視するためのガイドラインを提供します。
最適化モードで実行しており、クライアントマシンで HdxRtcEngine.exe が実行されている場合、VDA 上の WebSocketAgent.exe というプロセスがセッションで実行されます。Director の Activity Manager を使用してアプリケーションを確認します。
VDA の最小バージョン 1912 以降では、Citrix HDX Monitor (最小バージョン 3.11) を使用してアクティブな Teams 通話を監視できます。Citrix Virtual Apps and Desktops 製品 ISO には、layout\image-full\Support\HDX Monitor フォルダーに最新の hdxmonitor.msi が含まれています。
詳細については、Knowledge Center の記事 CTX253754 の「監視」を参照してください。
トラブルシューティング
このセクションでは、Microsoft Teams の最適化を使用する際に発生する可能性のある問題のトラブルシューティングのヒントを提供します。詳細については、CTX253754 を参照してください。
仮想デリバリーエージェント上で
BCR_x64.msi によって 4 つのサービスがインストールされます。VDA での Microsoft Teams リダイレクトを担当するのはそのうちの 2 つだけです。
-
Citrix HDX Teams Redirection Service establishes the virtual channel used in Microsoft Teams. The service relies on CtxSvcHost.exe.
-
Citrix HDX HTML5 Video Redirection Service runs as WebSocketService.exe listening on 127.0.0.1:9002 TCP. WebSocketService.exe performs two main functions:
i. セキュアな WebSocket の TLS 終端 は、Microsoft Teams アプリ内のコンポーネントである vdiCitrixPeerConnection.js からセキュアな WebSocket 接続を受信します。Process Monitor で追跡できます。証明書の詳細については、Controller と VDA 間の通信 の「TLS と HTML5 ビデオリダイレクト、およびブラウザコンテンツリダイレクト」セクションを参照してください。
一部のアンチウイルスソフトウェアやデスクトップセキュリティソフトウェアは、
WebSocketService.exeとその証明書の適切な機能に干渉します。Citrix HDX HTML5 Video Redirection サービスがservices.mscコンソールで実行されている場合でも、netstat で確認すると、localhost127.0.0.1:9002TCP ソケットはリスニングモードになっていません。サービスを再起動しようとすると、ハングアップします（「停止中…」）。WebSocketService.exeプロセスに適切な除外を適用してください。「プロセスモニター」(/ja-jp/citrix-virtual-apps-desktops/2203-ltsr/media/team-process-monitor.png)
ii. ユーザーセッションマッピング。 Microsoft Teamsアプリケーションが起動すると、WebSocketService.exeはVDAのユーザーセッションでWebSocketAgent.exeプロセスを開始します。WebSocketService.exeはLocalSystemアカウントとしてセッション0で実行されます。
netstatを使用して、WebSocketService.exeサービスがVDAでアクティブなリスニング状態にあるかどうかを確認できます。昇格されたコマンドプロンプトウィンドウから
netstat -anob -p tcpを実行します。netstatコマンドの実行例(/ja-jp/citrix-virtual-apps-desktops/2203-ltsr/media/teams-netstat.png)
接続が成功すると、状態はESTABLISHEDに変わります。
成功したnetstatの例(/ja-jp/citrix-virtual-apps-desktops/2203-ltsr/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でマイクロソフトチームズを終了します。
- ブイディーエーでservices.mscを起動します。
- Citrix HDX Teams リダイレクトサービスを停止します。
- ICA®セッションを切断します。
- ICAセッションを接続します。
- Citrix HDX Teams リダイレクトサービスを開始します。
- Citrix HDX HTML5 ビデオ リダイレクション サービスを再起動します。
- VDAでマイクロソフト チームズを起動します。
- クライアントエンドポイントでHdxTeams.exeまたはHdxRtcEngine.exeがまだ起動していない場合は、以下を実行してください。
- VDAを再起動します。
- クライアントエンドポイントを再起動します。
サポート
CitrixとMicrosoftは、Microsoft Teamsの最適化を使用して、Citrix Virtual Apps and Desktops™からのMicrosoft Teamsの配信を共同でサポートしています。この共同サポートは、両社間の緊密な連携の結果です。有効なサポート契約があり、このソリューションで問題が発生した場合は、問題の原因となっていると思われるコードのベンダーにサポートチケットをオープンしてください。つまり、TeamsについてはMicrosoft、最適化コンポーネントについてはCitrixです。 CitrixまたはMicrosoftがチケットを受け取り、問題をトリアージし、必要に応じてエスカレートします。各社のサポートチームに連絡する必要はありません。
問題が発生した場合は、Teams UIで[ヘルプ] > [問題の報告]をクリックすることをお勧めします。技術的な問題をより迅速に解決するために、VDA側のログはCitrixとMicrosoft間で自動的に共有されます。
ログの収集
HDXメディアエンジンログは、ユーザーのマシン（VDA上ではない）で見つけることができます。問題が発生した場合は、必ずサポートケースにログを添付してください。
ウィンドウズログ:
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ログ:
-
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ログは/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
<!--NeedCopy-->
複数のICE候補がある場合、優先順位は次のとおりです。
- ホスト
- ピアリフレクシブ
- サーバリフレクシブ
- トランスポートリレー
問題が発生し、それを一貫して再現できる場合は、Teamsで[ヘルプ] > [問題の報告]をクリックすることをお勧めします。Microsoftにケースをオープンした場合、技術的な問題を解決するために、ログはCitrixとMicrosoftの間で共有されます。 Citrixサポートに問い合わせる前にCDFトレースをキャプチャすることも有益です。詳細については、Knowledge Centerの記事CDFcontrolを参照してください。
CDFトレースの収集に関する推奨事項については、Knowledge Centerの記事CDFトレースの収集に関する推奨事項を参照してください。
VDA側CDFトレース - 次のCDFトレースプロバイダーを有効にします。
Workspaceアプリ側CDFトレース - 次のCDFトレースプロバイダーを有効にします。
- IcaClient_DriversVd_TeamsRedir (optional)
- IcaClient_Multimedia_HdxTeams (requires Citrix Workspace app 2012 or later)