-
-
-
对 Microsoft Teams 进行监视、故障排除以及为其提供支持
-
-
-
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
监视、故障排除和支持 Microsoft Teams
监视 Teams
本节提供使用 HDX 监视 Microsoft Teams 优化功能的指南。
如果您在优化模式下运行，并且客户端计算机上正在运行 HdxRtcEngine.exe，则 VDA 上的一个名为 WebSocketAgent.exe 的进程正在会话中运行。使用 Director 中的“活动管理器”查看应用程序。
可以在 Director > “用户详细信息”页面 > “会话详细信息”面板 > “MS Teams 优化”字段中查看 Microsoft Teams 优化状态。优化 Microsoft Teams 对于获得更好的用户体验（例如清晰的音频和视频）至关重要。此功能适用于 VDA 2311 及更高版本。支持的 Citrix Workspace™ app 版本列在“Microsoft Teams 优化”中。仅当 Microsoft Teams 作为已发布的应用程序或在已发布的桌面中运行时，Director 才会显示 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。
有关详细信息，请参阅知识中心文章 CTX253754 中的“监视”部分。
故障排除
本节提供在使用 Microsoft Teams 优化功能时可能遇到的问题的故障排除提示。有关详细信息，请参阅 CTX253754。
在 Virtual Delivery Agent 上
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执行两个主要功能：
-
安全 WebSockets 的 TLS 终止从
vdiCitrixPeerConnection.js接收安全 WebSocket 连接，vdiCitrixPeerConnection.js是 Microsoft Teams 应用程序中的一个组件。您可以使用 Process Monitor 跟踪它。有关证书的详细信息，请参阅“TLS 和 HTML5 视频重定向以及浏览器内容重定向”部分。某些防病毒和桌面安全软件会干扰
WebSocketService.exe及其证书的正常运行。虽然 Citrix HDX HTML5 视频重定向服务可能在services.msc控制台中运行，但netstat中显示的本地主机127.0.0.1:9002TCP 套接字从未处于侦听模式。尝试重新启动服务会导致其挂起（“正在停止…”）。请确保为WebSocketService.exe进程应用适当的排除项。
-
用户会话映射。当 Microsoft Teams 应用程序启动时，
WebSocketService.exe会在 VDA 中用户的会话中启动WebSocketAgent.exe进程。WebSocketService.exe在会话 0 中作为 LocalSystem 帐户运行。
您可以使用
netstat检查WebSocketService.exe服务在 VDA 中是否处于活动侦听状态。从提升的命令提示符窗口运行
netstat -anob -p tcp：
成功连接后，状态将变为 ESTABLISHED：
重要提示：
WebSocketService.exe侦听两个 TCP 套接字：127.0.0.1:9001和127.0.0.1:9002。端口9001用于浏览器内容重定向和 HTML5 视频重定向。端口9002用于 Microsoft Teams 重定向。请确保 VDA 的 Windows OS 中没有任何代理配置会阻止Teams.exe和WebSocketService.exe之间的直接通信。有时，当您在 Internet Explorer 11 中配置显式代理（“Internet 选项”>“连接”>“LAN 设置”>“代理服务器”）时，连接可能会流经指定的代理服务器。使用手动和显式代理设置时，请验证是否已选中“绕过本地地址的代理服务器”。
服务位置和说明
| 服务 | Windows Server OS 中的可执行文件路径 | 登录身份 | 说明 |
|---|---|---|---|
| Citrix HTML5 视频重定向服务 | “C:\Program Files (x86)\Citrix\System32\WebSocketService.exe” /service | Local System 帐户 | 提供多个 HDX 多媒体服务，其中包含在虚拟桌面和端点设备之间执行媒体重定向所需的初始框架。 |
| Citrix HDX 浏览器重定向服务 | “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs | 此帐户 (local service) | 提供端点设备和虚拟桌面之间的浏览器内容重定向。 |
| Citrix 端口转发服务 | “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs | 此帐户 (local service) | 提供端点设备和虚拟桌面之间的端口转发以实现浏览器内容重定向。 |
| Citrix HDX Teams 重定向服务 | “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs | Local System 帐户 | 提供端点设备和虚拟桌面之间的 Microsoft Teams 重定向。 |
Citrix Workspace app
在用户的端点上，适用于 Windows 的 Citrix Workspace app 会实例化一个名为 HdxTeams.exe 或 HdxRtcEngine.exe 的新服务。当 Microsoft Teams 在 VDA 中启动并且用户尝试在自预览中呼叫或访问外围设备时，就会发生这种情况。如果您没有看到此服务，请检查以下各项：
- 请确保您至少安装了适用于 Windows 的 Workspace App 1905 版本。您是否在 Workspace app 安装路径中看到
HdxTeams.exe或HdxRtcEngine.exe以及webrpc.dll二进制文件？ - 如果您已验证步骤 1，请执行以下操作以检查
HdxTeams.exe或HdxRtcEngine.exe是否正在启动。- 退出 VDA 上的 Microsoft Teams。
- 在 VDA 上启动
services.msc。 - 停止 Citrix HDX Teams 重定向服务。
- 断开 ICA® 会话。
- 连接 ICA 会话。
- 启动 Citrix HDX Teams 重定向服务。
- 重新启动 Citrix HDX HTML5 视频重定向服务。
- 在 VDA 上启动 Microsoft Teams。
- 如果您仍然没有看到
HdxTeams.exe或HdxRtcEngine.exe在客户端端点上启动，请执行以下操作：- 重新启动 VDA。
- 重新启动客户端端点。
支持
Citrix 和 Microsoft 联合支持通过 Microsoft Teams 优化功能，从 Citrix Virtual Apps and Desktops™ 交付 Microsoft Teams。这种联合支持是两家公司紧密合作的成果。如果用户拥有有效的支持合同，并且在使用此解决方案时遇到问题，请向怀疑导致问题的代码供应商提交支持工单。即，Microsoft 负责 Teams，Citrix 负责优化组件。 Citrix 或 Microsoft 将接收工单，对问题进行分类，并酌情升级。用户无需联系两家公司的支持团队。
如果遇到问题，建议在 Teams UI 中单击 “帮助”>“报告问题”。VDA 端的日志会在 Citrix 和 Microsoft 之间自动共享，以更快地解决技术问题。
收集日志
HDX media engine 日志可在用户计算机上找到（而非 VDA 上）。如果出现任何问题，请务必将日志附加到支持案例中。
Windows 日志：
Windows 日志位于 %TEMP% 中 HDXTeams 文件夹内 (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 日志：
-
VDWEBRTC 日志 - 记录虚拟通道的执行。
位置：
/Users/<User Name>/Library/Logs/Citrix Workspace/CitrixViewer_<Y_M_D_H_M_S>.txt -
HdxRtcEngine 日志 - 记录 HdxRtcEngine 上进程的执行。
位置：
$TMPDIR/hdxrtcengine/<W_M_D_H_M_S_Y>/hdxrtcengine.logHdxRtcEngine 日志默认启用。
-
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/ 日志：
建立呼叫时，需要以下四个 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 候选，则首选顺序为：
- 主机
- 对等反射
- 服务器反射
- 传输中继
如果遇到问题并且可以持续重现，建议在 Microsoft Teams 中单击 “帮助”>“报告问题”。如果用户已向 Microsoft 提交案例，日志会在 Citrix 和 Microsoft 之间共享，以解决技术问题。 在联系 Citrix Support 之前捕获 CDF 跟踪也很有益。有关详细信息，请参阅知识中心文章 CDFcontrol。
有关收集 CDF 跟踪的建议，请参阅知识中心文章 Recommendations for Collecting the CDF Traces。
VDA 侧 CDF 跟踪 - 启用以下 CDF 跟踪提供程序：
Workspace 应用程序侧 CDF 跟踪 - 启用以下 CDF 跟踪提供程序：
- IcaClient_DriversVd_TeamsRedir（可选）
- IcaClient_Multimedia_HdxTeams（需要 Citrix Workspace 应用程序 2012 或更高版本）
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.