监视、故障排除和支持 Microsoft Teams

Last published : Nov 13, 2026
Related information
Microsoft Teams（经典版）优化

监视 Teams

本节提供了使用 HDX 监视 Microsoft Teams 优化的指导。 如果您在优化模式下运行，并且 HdxRtcEngine.exe 正在客户端计算机上运行，则 VDA 上名为 WebSocketAgent.exe 的进程将在会话中运行。使用 Director 中的“活动管理器”查看应用程序。
](/en-us/citrix-virtual-apps-desktops/2203-ltsr/media/teams-activity-manager.png)
使用 VDA 最低版本 1912，您可以使用 Citrix HDX Monitor（最低版本 3.11）监控活动的 Teams 呼叫。Citrix Virtual Apps and Desktops 产品 ISO 包含文件夹 layout\image-full\Support\HDX Monitor 中的最新 hdxmonitor.msi。
有关详细信息，请参阅知识中心文章 CTX253754 中的“监视”。

故障排除

本节提供了在使用 Microsoft Teams 优化时可能遇到的问题的故障排除技巧。有关详细信息，请参阅 CTX253754。

在 虚拟交付代理 上

BCR_x64.msi 安装了四个服务。其中只有两个负责 VDA 中的 Microsoft Teams 重定向。
浏览器内容重定向安装的四个服务
  • Citrix HDX Teams 重定向服务建立 Microsoft Teams 中使用的虚拟通道。该服务依赖于 CtxSvcHost.exe。
  • Citrix HDX HTML5 视频重定向服务作为 WebSocketService.exe 运行，侦听 127.0.0.1:9002 TCP。WebSocketService.exe 执行两个主要功能：
    i. 安全 WebSocket 的 TLS 终止从 vdiCitrixPeerConnection.js 接收安全 WebSocket 连接，vdiCitrixPeerConnection.js 是 Microsoft Teams 应用程序中的一个组件。您可以使用进程监视器对其进行跟踪。有关证书的详细信息，请参阅 Controller 和 VDA 之间的通信 下的“TLS 和 HTML5 视频重定向以及浏览器内容重定向”部分。
    某些防病毒和桌面安全软件会干扰 WebSocketService.exe 及其证书的正常运行。尽管 Citrix HDX HTML5 视频重定向服务可能在 services.msc 控制台中运行，但 localhost 127.0.0.1:9002 TCP 套接字从未处于侦听模式，如 netstat 中所示。尝试重新启动服务会导致其挂起（“正在停止…”）。确保为 WebSocketService.exe 进程应用适当的排除项。
    进程监视器
    ii. **用户会话映射。**当 Microsoft Teams 应用程序启动时，WebSocketService.exe 会在 VDA 中用户的会话中启动 WebSocketAgent.exe 进程。WebSocketService.exe 在会话 0 中以 LocalSystem 帐户运行。
    WebSocketAgent.exe 服务
    您可以使用 netstat 检查 WebSocketService.exe 服务在 VDA 中是否处于活动侦听状态。
    从提升的命令提示符窗口运行 netstat -anob -p tcp：
    运行 netstat 示例
    成功连接后，状态将变为 ESTABLISHED：
    成功的 netstat 示例
重要提示：
WebSocketService.exe 侦听两个 TCP 套接字：127.0.0.1:9001 和 127.0.0.1:9002。端口 9001 用于浏览器内容重定向和 HTML5 视频重定向。端口 9002 用于 Microsoft Teams 重定向。确保 VDA 的 Windows 操作系统中没有任何代理配置会阻止 Teams.exe 和 WebSocketService.exe 之间的直接通信。有时，当您在 Internet Explorer 11 中配置显式代理（Internet 选项 > 连接 > 局域网设置 > 代理服务器）时，连接可能会通过分配的代理服务器。使用手动和显式代理设置时，请验证是否选中了对于本地地址不使用代理服务器。

服务位置和说明

服务 Windows Server 操作系统中可执行文件的路径 登录为 描述
Citrix HTML5 视频重定向服务 "C:\Program Files (x86)\Citrix\System32\WebSocketService.exe" /service 本地系统帐户 为多个 HDX 多媒体服务提供在虚拟桌面和端点设备之间执行媒体重定向所需的初始框架。
Citrix HDX 浏览器内容重定向服务 "C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe" -g 浏览器重定向服务 此帐户（本地服务） 提供端点设备和虚拟桌面之间的浏览器内容重定向。
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 重定向。

Citrix Workspace™ 应用程序

在用户的端点上，适用于 Windows 的 Citrix Workspace 应用程序会实例化一个名为 HdxTeams.exe 或 HdxRtcEngine.exe 的新服务。当 Microsoft Teams 在 VDA 中启动且用户尝试在自预览中呼叫或访问外设时，会发生这种情况。如果您没有看到此服务，请检查以下各项：
  1. 确保您至少安装了适用于 Windows 的 Workspace App 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。这种联合支持是两家公司密切合作的结果。如果您拥有有效的支持合同，并且在使用此解决方案时遇到问题，请向您怀疑其代码导致问题的供应商提交支持工单。也就是说，Microsoft 负责 Teams，Citrix 负责优化组件。 Citrix 或 Microsoft 会收到工单，对问题进行分类，并酌情上报。您无需联系两家公司的支持团队。
当您遇到问题时，我们建议您在 Teams UI 中单击“帮助 > 报告问题”。VDA 端日志会在 Citrix 和 Microsoft 之间自动共享，以更快地解决技术问题。

收集日志

HDX 媒体引擎日志可在用户计算机上找到（而非 VDA 上）。如果出现任何问题，请务必将日志附加到您的支持案例中。
Windows 日志：
您可以在 %TEMP% 中 HDXTeams 文件夹内找到 Windows 日志 (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 日志：
您可以在 /tmp/webrpc/<current date>/ and /tmp/hdxrtcengine/<current date>/ 文件夹中找到 Linux 日志。 Webrtc 日志：/tmp/webrpc/<current date>/webrtc.log 内核日志：/var/log/syslog
ICE/STUN/TURN/ 日志：
建立呼叫时，需要以下四个 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
如果存在多个 ICE 候选，则首选顺序为：
  1. 主机
  2. 对等反射
  3. 服务器反射
  4. 传输中继
如果您遇到问题并且可以持续重现，我们建议您在 Teams 中单击帮助 > 报告问题。如果您已向 Microsoft 提交案例，Citrix 和 Microsoft 之间会共享日志以解决技术问题。 在联系 Citrix 支持之前捕获 CDF 跟踪也很有益。有关详细信息，请参阅知识中心文章 CDFcontrol。
有关收集 CDF 跟踪的建议，请参阅知识中心文章 收集 CDF 跟踪的建议。
VDA 端 CDF 跟踪 - 启用以下 CDF 跟踪提供程序：
VDA 端 CDF 跟踪
Workspace 应用程序端 CDF 跟踪 - 启用以下 CDF 跟踪提供程序：
Workspace App 侧 CDF 跟踪
  • IcaClient_DriversVd_TeamsRedir（可选）
  • IcaClient_Multimedia_HdxTeams（需要 Citrix Workspace 应用程序 2012 或更高版本）