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

最終公開日 : Nov 13, 2026

Teamsの監視

このセクションでは、HDX を使用した Microsoft Teams の最適化を監視するためのガイドラインを提供します。 最適化モードで実行しており、HdxRtcEngine.exe がクライアントマシンで実行されている場合、VDA 上の WebSocketAgent.exe というプロセスがセッションで実行されています。アプリケーションを表示するには、Director の アクティビティマネージャー を使用します。
](/en-us/citrix-virtual-apps-desktops/2311/media/teams-activity-manager.png)
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つだけです。
ブラウザコンテンツリダイレクトによってインストールされる4つのサービス
  • 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 で追跡できます。証明書の詳細については、「Controller と VDA 間の通信」の「TLS と HTML5 ビデオのリダイレクト、およびブラウザコンテンツのリダイレクト」セクションを参照してください。
    一部のアンチウイルスソフトウェアおよびデスクトップセキュリティソフトウェアは、WebSocketService.exeとその証明書の正常な機能に干渉します。Citrix HDX HTML5 Video Redirectionサービスがservices.mscコンソールで実行されている場合でも、netstatで確認すると、localhost 127.0.0.1:9002 TCPソケットがリスニングモードになっていません。サービスを再起動しようとすると、ハングアップします(「停止中…」)。WebSocketService.exeプロセスに適切な除外設定を適用してください。
    「プロセスモニター」(/en-us/citrix-virtual-apps-desktops/2311/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/2311/media/websocketservice-websocketagent.png)
    VDAでWebSocketService.exeサービスがアクティブなリスニング状態にあるかどうかを確認するには、netstatを使用できます。
    昇格されたコマンドプロンプトウィンドウからnetstat -anob -p tcpを実行します。
    「netstatの例を実行」(/en-us/citrix-virtual-apps-desktops/2311/media/teams-netstat.png)
    接続が成功すると、状態はESTABLISHEDに変わります。
    「netstatの成功例」(/en-us/citrix-virtual-apps-desktops/2311/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が起動し、ユーザーがセルフプレビューで周辺機器を呼び出したりアクセスしようとしたときに発生します。このサービスが表示されない場合は、以下を確認してください。
  1. Windows用Workspaceアプリバージョン1905以降がインストールされていることを確認してください。WorkspaceアプリのインストールパスにHdxTeams.exeまたはHdxRtcEngine.exeとwebrpc.dllバイナリが表示されますか?
  2. ステップ1を検証した場合は、HdxTeams.exeまたはHdxRtcEngine.exeが起動しているかどうかを確認するために、以下を実行してください。
    1. VDAでMicrosoft Teamsを終了します。
    2. VDAでservices.mscを開始します。
    3. Citrix HDX Teamsリダイレクトサービスを停止します。
    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ログ:
Windowsログは、%TEMP%内の HDXTeams フォルダー(AppData/Local/Temp/HDXTeamsまたはAppData/Local/Temp/HdxRtcEngine)にあります。webrpc_Day_Month_timestamp_Year.txtという名前の.txtファイルを探してください。Citrix Workspaceアプリ2009.5以降などの新しいバージョンを使用している場合は、ログを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/ログ:
通話確立時には、次の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候補がある場合、優先順位は次のとおりです。
  1. ホスト
  2. ピアリフレクシブ
  3. サーバーリフレクシブ
  4. トランスポートリレー
問題が発生し、それを一貫して再現できる場合は、Microsoft Teams で ヘルプ > 問題の報告 をクリックすることをお勧めします。Microsoft にケースをオープンした場合、技術的な問題を解決するためにログは Citrix と Microsoft の間で共有されます。 Citrix サポートに問い合わせる前に CDF トレースをキャプチャすることも有益です。詳細については、Knowledge Center の記事 CDFcontrol を参照してください。
CDF トレース収集の推奨事項については、Knowledge Center の記事 Recommendations for Collecting the CDF Traces を参照してください。
VDA側CDFトレース - 次のCDFトレースプロバイダーを有効にします。
VDA側CDFトレース
Workspaceアプリ側CDFトレース - 次のCDFトレースプロバイダーを有効にします。
Workspace App 側の CDF トレース(/en-us/citrix-virtual-apps-desktops/2311/media/team-cwa-cdf-traces.png)
  • IcaClient_DriversVd_TeamsRedir (オプション)
  • IcaClient_Multimedia_HdxTeams (Citrix Workspace app 2012 以降が必要)