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

チームズを監視する

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

Microsoft Teams の最適化ステータスは、Director の [ユーザーの詳細] ページ > [セッションの詳細] パネル > [MS Teams Optimization] フィールドで確認できます。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 つだけです。

• Citrix HDX Teams リダイレクトサービス は、Microsoft Teams で使用される仮想チャネルを確立します。このサービスは CtxSvcHost.exe に依存しています。

• Citrix HDX HTML5 ビデオ リダイレクトサービス は、127.0.0.1:9002 TCP でリッスンする WebSocketService.exe として実行されます。WebSocketService.exe は、主に次の 2 つの機能を実行します。

  i. セキュアな WebSocket の TLS 終端は、Microsoft Teams アプリ内のコンポーネントである vdiCitrixPeerConnection.js からセキュアな WebSocket 接続を受信します。Process Monitor で追跡できます。証明書の詳細については、[TLS and HTML5 video redirection, and browser content redirection] (TLS と HTML5 ビデオのリダイレクト、およびブラウザコンテンツのリダイレクト) のセクションを参照してください。

  一部のアンチウイルスおよびデスクトップセキュリティソフトウェアは、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で実行されます。

  

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

  管理者権限のコマンドプロンプトウィンドウから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という新しいサービスをインスタンス化します。これは、Microsoft TeamsがVDAで起動され、ユーザーがセルフプレビューで周辺機器を呼び出したりアクセスしようとしたときに発生します。このサービスが表示されない場合は、以下を確認してください。

1. Windows版Workspaceアプリバージョン1905以降がインストールされていることを確認してください。WorkspaceアプリのインストールパスにHdxTeams.exeまたはHdxRtcEngine.exeとwebrpc.dllバイナリが表示されますか？
2. 手順1を検証した場合は、HdxTeams.exeまたはHdxRtcEngine.exeが起動されているかを確認するために、以下を実行してください。
   1. VDA上のマイクロソフト チームズを終了します。
   2. VDA上でservices.mscを起動してください。
   3. Citrix HDX チームズ Redirection サービスを停止してください。
   4. ICA®セッションを切断します。
   5. ICAセッションに接続します。
   6. シトリックス HDX チームズ リダイレクション サービスを開始します。
   7. シトリックス HDX HTML5 ビデオ リダイレクション サービスを再起動します。
   8. VDA上でマイクロソフト 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上ではない）で見つけることができます。問題が発生した場合は、必ずサポートケースにログを添付してください。

ウィンドウズ ログ:

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 ログは /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 ログには、関連する対話型接続確立 (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トレースの収集に関する推奨事項については、Knowledge Centerの記事「CDFトレース収集の推奨事項」を参照してください。

VDA 側の CDF トレース - 次の CDF トレースプロバイダーを有効にします:

Workspace アプリ側の CDF トレース - 次の CDF トレースプロバイダーを有効にします:

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