Microsoft Teams の監視、トラブルシューティング、サポート
Teams の監視
このセクションでは、HDX を使用した Microsoft Teams の最適化を監視するためのガイドラインを示します。 最適化モードで実行しており、
HdxRtcEngine.exe がクライアントマシンで実行されている場合、VDA 上で WebSocketAgent.exe というプロセスがセッションで実行されます。アプリケーションを確認するには、Director の Activity Manager を使用します。
Activity Manager で Teams を監視 ](/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/teams-activity-manager.png)
Microsoft Teams の最適化ステータスは、Director の ユーザーの詳細ページ > セッションの詳細パネル > MS Teams の最適化フィールドで確認できます。Microsoft Teams が最適化されていることは、クリアなオーディオとビデオなど、より良いユーザーエクスペリエンスのために不可欠です。この機能は、VDA バージョン 2311 以降で利用できます。サポートされている Citrix Workspace™ アプリのバージョンは、「Microsoft Teams の最適化」に記載されています。Director は、Microsoft Teams が公開アプリケーションとして、または公開デスクトップ内で実行されている場合にのみ、Microsoft Teams の最適化ステータスを表示します。 詳細については、「Microsoft Teams の最適化ステータス」を参照してください。
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」の「監視」を参照してください。
トラブルシューティング
このセクションでは、Microsoft Teams の最適化を使用する際に発生する可能性のある問題のトラブルシューティングのヒントを提供します。詳細については、「CTX253754」を参照してください。
バーチャル デリバリー エージェント上で
BCR_x64.msi によって 4 つのサービスがインストールされます。VDA での Microsoft Teams リダイレクトを担当するのはそのうちの 2 つだけです。
ブラウザコンテンツリダイレクトによってインストールされた 4 つのサービス (/en-us/citrix-virtual-apps-desktops/2607-ltsr/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 Video Redirection サービスがservices.mscコンソールで実行されている場合でも、netstat で確認できるように、localhost127.0.0.1:9002TCP ソケットはリスニングモードになりません。サービスを再起動しようとすると、ハングアップします(「停止中…」)。WebSocketService.exeプロセスに適切な除外を適用してください。
ii. **ユーザーセッションマッピング。**Microsoft Teamsアプリケーションが起動すると、WebSocketService.exeはVDAのユーザーセッションでWebSocketAgent.exeプロセスを開始します。WebSocketService.exeはSession 0でLocalSystemアカウントとして実行されます。
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 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という新しいサービスをインスタンス化します。これは、Microsoft TeamsがVDAで起動し、ユーザーがセルフプレビューで通話しようとしたり、周辺機器にアクセスしようとしたりするときに行われます。このサービスが表示されない場合は、以下を確認してください。
-
Windows 用 Workspace App バージョン 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がチケットを受け取り、問題をトリアージし、必要に応じてエスカレートします。各社のサポートチームに連絡する必要はありません。
問題が発生した場合は、Teams UIでヘルプ > 問題の報告をクリックすることをお勧めします。VDA側のログは、技術的な問題をより迅速に解決するために、CitrixとMicrosoft間で自動的に共有されます。
ログの収集
HDXメディアエンジンログは、ユーザーのマシン上(VDA上ではありません)にあります。問題が発生した場合は、必ずサポートケースにログを添付してください。
Windowsログ:
Windowsログは、HDXTeamsフォルダー(AppData/Local/Temp/HDXTeams または AppData/Local/Temp/HdxRtcEngine)内の%TEMP%にあります。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 サポートに問い合わせる前に 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 app 2012以降が必要)