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

最終公開日 : Nov 13, 2026
Related information
../../multimedia/opt-ms-teams.md

Teamsの監視

このセクションでは、HDX を使用した Microsoft Teams の最適化を監視するためのガイドラインを提供します。 最適化モードで実行しており、HdxRtcEngine.exe がクライアントマシンで実行されている場合、VDA 上で WebSocketAgent.exe と呼ばれるプロセスがセッションで実行されています。Director の アクティビティマネージャー を使用してアプリケーションを確認します。
アクティビティマネージャーでTeamsを監視 ](/en-us/citrix-virtual-apps-desktops/2503/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 の最適化ステータス」(/ja-jp/citrix-virtual-apps-desktops/2503/director/troubleshoot-deployments/user-issues#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 の「監視」を参照してください。

トラブルシューティング

このセクションでは、Microsoft Teams の最適化を使用する際に発生する可能性のある問題に対するトラブルシューティングのヒントを提供します。詳細については、CTX253754 を参照してください。

バーチャル デリバリー エージェント上

BCR_x64.msi によって 4 つのサービスがインストールされます。そのうち 2 つのみが、VDA での Microsoft Teams リダイレクトを担当します。
ブラウザコンテンツリダイレクトによってインストールされる4つのサービス (/en-us/citrix-virtual-apps-desktops/2503/media/team-services.png)
  • 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 および HTML5 ビデオリダイレクト、ブラウザコンテンツリダイレクト) を参照してください。
    一部のアンチウイルスおよびデスクトップセキュリティソフトウェアは、WebSocketService.exeとその証明書の適切な機能に干渉します。Citrix HDX HTML5ビデオリダイレクトサービスがservices.mscコンソールで実行されている場合でも、netstatで確認すると、localhost 127.0.0.1:9002 TCPソケットはリスニングモードになっていません。サービスを再起動しようとすると、ハングアップします（「停止中…」）。WebSocketService.exeプロセスに適切な除外を適用してください。
    「プロセスモニター」(/en-us/citrix-virtual-apps-desktops/2503/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/2503/media/websocketservice-websocketagent.png)
    VDAでWebSocketService.exeサービスがアクティブなリッスン状態にあるかどうかを確認するには、netstatを使用できます。
    昇格されたコマンドプロンプトウィンドウからnetstat -anob -p tcpを実行します。
    netstatの例を実行する
    接続が成功すると、状態はESTABLISHEDに変わります。
    成功したnetstatの例
重要：
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 Redirection Serviceを停止します。
    4. ICA®セッションを切断します。
    5. ICAセッションを接続します。
    6. Citrix HDX Teams Redirection Serviceを開始します。
    7. Citrix HDX HTML5 Video Redirection Serviceを再起動します。
    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ログは、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ログ：
  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/2503/media/team-cwa-cdf-traces.png)
  • IcaClient_DriversVd_TeamsRedir (オプション)
  • IcaClient_Multimedia_HdxTeams (Citrix Workspaceアプリ2012以降が必要)