产品文档
Citrix Virtual Apps and Desktops 7 2402 LTSR
查看 PDF

监控、故障排除和支持微软团队

May 31, 2026
投稿者: 
C C

监控微软团队

本节提供了使用 HDX 监控 Microsoft Teams 优化的指南。 如果您在优化模式下运行，并且 HdxRtcEngine.exe 正在客户端计算机上运行，则 VDA 上名为 WebSocketAgent.exe 的进程正在会话中运行。使用 Director 中的 Activity Manager 查看应用程序。

在活动管理器中监控 Teams ](/zh-cn/citrix-virtual-apps-desktops/2402-ltsr/media/teams-activity-manager.png)

可以在 Director > 用户详细信息页面 > 会话详细信息面板 > MS Teams 优化字段中查看 Microsoft Teams 优化状态。优化 Microsoft Teams 对于提供更好的用户体验（例如清晰的音频和视频）至关重要。此功能适用于 VDA 2311 及更高版本。支持的 Citrix Workspace™ 应用程序版本列在“Microsoft Teams 优化”中。仅当 Microsoft Teams 作为已发布的应用程序或在已发布的桌面中运行时，Director 才会显示 Microsoft Teams 优化状态。 有关详细信息，请参阅 Microsoft Teams 优化状态。

当 VDA 最低版本为 1912 时，您可以使用 Citrix HDX 监视器（最低版本 3.11）监控活跃的微软 Teams 通话。Citrix 虚拟应用和桌面 产品 ISO 包含文件夹 layout\image-full\Support\HDX Monitor 中的最新 hdxmonitor.msi。 当 VDA 最低版本为 1912 时，您可以使用 Citrix HDX 监视器（最低版本 3.11）监控活跃的微软 Teams 通话。Citrix 虚拟应用和桌面 产品 ISO 包含文件夹 layout\image-full\Support\HDX Monitor 中的最新 hdxmonitor.msi。

有关详细信息，请参阅知识中心文章 CTX253754 中的 监控。

故障排除

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

在虚拟投递代理上

BCR_x64.msi 安装了四个服务。其中只有两个负责 VDA 中的 Microsoft Teams 重定向。

浏览器内容重定向安装的四个服务

  • Citrix HDX Teams 重定向服务建立在微软 Teams 中使用的虚拟通道。该服务依赖于 CtxSvcHost.exe。

  • 赛特斯 高清体验 超文本标记语言第五版 视频重定向服务作为 WebSocketService.exe 运行，侦听 127.0.0.1:9002 传输控制协议。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. User session mapping. When the Microsoft Teams application starts, WebSocketService.exe starts the WebSocketAgent.exe process in the user’s session in the VDA. WebSocketService.exe runs in Session 0 as a LocalSystem account.

    WebSocketAgent.exe service

    您可以使用 netstat 检查 WebSocketService.exe 服务在 VDA 中是否处于活动侦听状态。

    从提升的命令提示符窗口运行 netstat -anob -p tcp：

    运行 netstat 命令的示例

    成功连接后，状态变为 ESTABLISHED：

    成功的网络状态统计命令示例

重要：

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 BrowserRedirSvcs 此帐户（本地服务） 在端点设备和虚拟桌面之间提供浏览器内容重定向。
Citrix 端口转发服务 “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs 此帐户（本地服务） 在端点设备和虚拟桌面之间为浏览器内容重定向提供端口转发。
Citrix HDX 团队重定向服务 “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs 本地系统帐户 在端点设备和虚拟桌面之间提供 Microsoft Teams 重定向。

思杰工作区应用程序

在用户的端点设备上，适用于 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. Start services.msc on VDA.
    3. 停止 Citrix HDX Teams 应用程序重定向服务。
    4. 断开 ICA® 会话连接。
    5. 连接 ICA 会话。
    6. 启动 思杰 HDX Teams 重定向服务。
    7. 重新启动 Citrix HDX HTML5 视频重定向服务。
    8. 在 虚拟交付代理 上启动 微软 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。您需要查找一个以 .txt 为文件扩展名的文本日志文件，该文件的命名格式通常为 webrpc_Day_Month_timestamp_Year.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/ logs:

建立呼叫时，需要以下四个 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 跟踪也很有益。有关详细信息，请参阅知识中心文章 CDFcontrol。

有关收集 CDF 跟踪的建议，请参阅知识中心文章 收集 CDF 跟踪的建议。

VDA 侧 CDF 跟踪 - 启用以下 CDF 跟踪提供程序：

VDA 侧 CDF 跟踪文件

Workspace 应用程序侧 CDF 跟踪 - 启用以下 CDF 跟踪提供程序：

工作区应用程序侧 CDF 跟踪

  • IcaClient_DriversVd_TeamsRedir (optional)
  • IcaClient_Multimedia_HdxTeams (requires Citrix Workspace app 2012 or later)
监控、故障排除和支持微软团队
May 31, 2026
投稿者: 
C C
May 31, 2026
投稿者: 
C C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.