製品ドキュメント
Citrix DaaS™
PDFを表示

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

April 6, 2026
寄稿者: 
C C

Teams の監視

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

Activity Manager で Teams を監視

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 を参照してください。

Virtual Delivery Agent

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 ソケットがリッスンモードになっていないことがあります。サービスを再起動しようとすると、ハングアップします（「Stopping…」）。WebSocketService.exe プロセスに適切な除外を適用していることを確認してください。

    プロセスモニター

    ii. ユーザーセッションマッピング。 Microsoft Teams アプリケーションが起動すると、WebSocketService.exe は VDA のユーザーセッションで WebSocketAgent.exe プロセスを開始します。WebSocketService.exe は Session 0 で LocalSystem アカウントとして実行されます。

    WebSocketAgent.exe サービス

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

    昇格されたコマンドプロンプトウィンドウから netstat -anob -p tcp を実行します。

    netstat の実行例

    接続が成功すると、状態は ESTABLISHED に変わります。

    netstat の成功例

重要:

WebSocketService.exe は、2 つの TCP ソケット (127.0.0.1:9001 と 127.0.0.1:9002) でリッスンします。ポート 9001 はブラウザーコンテンツリダイレクトと HTML5 ビデオリダイレクトに使用されます。ポート 9002 は Microsoft Teams リダイレクトに使用されます。Teams.exe と WebSocketService.exe 間の直接通信を妨げる可能性のあるプロキシ構成が VDA の Windows OS にないことを確認してください。Internet Explorer 11 で明示的なプロキシを構成すると（インターネットオプション > 接続 > LAN の設定 > プロキシサーバー）、接続が割り当てられたプロキシサーバーを経由する場合があります。手動および明示的なプロキシ設定を使用する場合は、ローカルアドレスにはプロキシサーバーを使用しない がチェックされていることを確認してください。

サービスの位置と説明

サービス Windows Server OS の実行可能ファイルのパス ログオンアカウント 説明
Citrix HTML5 Video Redirection Service “C:\Program Files (x86)\Citrix\System32\WebSocketService.exe” /service ローカルシステムアカウント 仮想デスクトップとエンドポイントデバイス間のメディアリダイレクトを実行するために必要な初期フレームワークを複数の HDX マルチメディアサービスに提供します。
Citrix HDX Browser Redirection Service “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs このアカウント（ローカルサービス） エンドポイントデバイスと仮想デスクトップ間のブラウザーコンテンツリダイレクトを提供します。
Citrix Port Forwarding Service “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs このアカウント（ローカルサービス） ブラウザーコンテンツリダイレクトのために、エンドポイントデバイスと仮想デスクトップ間のポート転送を提供します。
Citrix HDX Teams Redirection Service “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs ローカルシステムアカウント エンドポイントデバイスと仮想デスクトップ間の Microsoft Teams リダイレクトを提供します。

Citrix Workspace™ アプリ

ユーザーのエンドポイントでは、Windows 用 Citrix Workspace アプリが HdxTeams.exe と呼ばれる新しいサービスをインスタンス化します。これは、Microsoft Teams が VDA で起動され、ユーザーがセルフプレビューで通話または周辺機器へのアクセスを試みたときに発生します。このサービスが表示されない場合は、以下を確認してください。

  1. Windows 用 Workspace アプリバージョン 1905 以降がインストールされていることを確認します。Workspace アプリのインストールパスに HdxTeams.exe と webrpc.dll バイナリが表示されますか。
  2. 手順 1 を検証した場合は、HdxTeams.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 を開始します。
    1. Citrix HDX HTML5 Video Redirection Service を再起動します。
    1. VDA で Microsoft Teams を起動します。
    1. クライアントエンドポイントで HdxTeams.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>/および/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候補がある場合、優先順位は次のとおりです。

  1. ホスト
  2. ピアリフレクシブ
  3. サーバリフレクシブ
  4. トランスポートリレー

問題が発生し、それを一貫して再現できる場合は、Teamsで [ヘルプ] > [問題の報告] をクリックすることをお勧めします。Microsoftでケースをオープンした場合、技術的な問題を解決するためにログがCitrixとMicrosoft間で共有されます。 Citrixサポートに連絡する前にCDFトレースをキャプチャすることも有益です。詳細については、Knowledge Centerの記事「CDFcontrol」を参照してください。

CDFトレース収集の推奨事項については、Knowledge Centerの記事「CDFトレース収集の推奨事項」を参照してください。

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

VDA側CDFトレース

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

Workspaceアプリ側CDFトレース

  • IcaClient_DriversVd_TeamsRedir (オプション)
  • IcaClient_Multimedia_HdxTeams (Citrix Workspaceアプリ2012以降が必要)
Microsoft Teams の監視、トラブルシューティング、サポート
April 6, 2026
寄稿者: 
C C
April 6, 2026
寄稿者: 
C C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.