故障排除

超文本标记语言5 日志

适用于 HTML5 的 Citrix Workspace 应用程序为用户设备生成的日志提供时间戳。

注意：

• 为帮助解决问题，您可以查看适用于 HTML5 的 Citrix Workspace 应用程序会话日志。

日志页面允许用户执行以下操作：

• 启用日志记录： 启用日志记录以查看 HTML5 日志。
• 禁用日志记录： 禁用日志记录以停止会话中的日志记录。
• 查看日志： 查看为会话生成的日志。
• 清除日志： 删除会话中生成的日志文件。
• 下载日志文件： 将日志文件下载到所需位置。

Citrix Workspace 应用程序支持为正在进行的虚拟桌面和应用程序会话收集日志。以前，您只能在正在进行的会话期间选择开始日志记录后，为启动的会话收集日志。现在，日志将为正在进行的会话和后续会话收集，直到您选择停止日志记录。

移动设备的故障排除增强功能

通过点击获取日志选项，您可以快速访问会话日志文件。日志记录选项已从日志记录重命名为获取日志。当您从辅助菜单中选择获取日志时，日志文件会下载到您的设备上，而不是在新浏览器选项卡中打开。

注意：

您可以收集当前正在进行的会话以及最多前五个会话的日志。

如何收集日志

要收集适用于 HTML5 的 Citrix Workspace 应用程序客户端日志，请执行以下操作：

1. 登录适用于超文本标记语言5的 Citrix Workspace 应用程序。

2. 按如下方式访问“日志文件”页面：
   • For Citrix Workspace app versions 1908 and later, open a new tab and navigate to siteurl/Clients/HTML5Client/src/SessionWindow.html#engineType=log, where siteurl is the URL of the Workspace for Web site, for example, https://server.domain/Citrix/StoreWeb.
   • For Citrix Workspace app versions 1907 and earlier, open a new tab and navigate to siteurl/Clients/HTML5Client/src/ViewLog.html, where siteurl is the URL of the Citrix Workspace for Web site, for example, https://server.domain/Citrix/StoreWeb.

3. 在“日志文件”页面上，单击“开始日志记录”。

   

   日志记录将为下一次会话启动启用，而不是为当前活动会话（如果有）启用。

4. 登录 Citrix Workspace 应用程序并启动您的虚拟应用程序会话，然后重现问题以收集日志。继续在该会话中操作以重现问题。

5. 一旦问题重现，请关闭会话。

6. 为适用于 HTML5 的 Citrix Workspace 应用程序会话生成的日志文件将显示在日志记录页面中。

   

7. 单击箭头按钮以下载并保存日志文件。

   日志文件(/zh-cn/citrix-workspace-app-for-html5/media/logfiles_arrow.png)

注意：

• 要启用和查看 Citrix Workspace app for HTML5 日志，可以使用会话工具栏菜单中的“日志记录”选项。

日志记录工具栏(/zh-cn/citrix-workspace-app-for-html5/media/loggingtoolbar.png)

如何收集控制台日志

要收集 思杰 HTML5 工作区应用 控制台日志，请执行以下操作：

1. 在运行会话的浏览器选项卡上打开“开发人员工具”。例如，在 Google Chrome 浏览器中，“开发人员工具”可以在“更多工具”选项下找到。

   开发人员工具(/zh-cn/citrix-workspace-app-for-html5/media/developertool.png)

2. 在打开的开发人员工具中单击“控制台”。

3. 右键单击并选择“另存为”选项以保存所有日志。

   控制台(/zh-cn/citrix-workspace-app-for-html5/media/console.png)

如何收集 USB 重定向日志

要启用日志记录并收集与 USB 重定向相关问题的日志，请执行以下操作：

启用日志

1. 编辑 configuration.js 文件并导航到 HTML5_CONFIG 部分。

2. Add the value moreLogs{‘usb’: true}. This setting is relevant to the StoreFront. The configuration.js file is at C:\program Files\Citrix <actual path>\HTML5Client.

收集日志

要收集日志，请参阅 如何收集日志。

设备日志

要收集设备日志，请在 Google Chrome 浏览器中打开一个新选项卡，然后输入 chrome://device-log 并共享日志。

How to collect Microsoft Teams optimization logs

Microsoft Teams 优化功能支持最新版本的 shim 库，其版本号为 1.10.0.0。

要了解您当前使用的 shim 版本：

1. 打开 Microsoft Teams 应用程序并与其中一位用户开始通话。

2. 通话建立后，最大化 Microsoft Teams 窗口。

3. 在会话中打开 屏幕键盘，然后单击 Ctrl + Alt + Shift + 1 键。

   您现在可以在 VDA 的下载文件夹中查看日志文件。

4. Open the MSTeams_Diagnostics Log <date><time>.txt file and search for the shim version under type_script. For example, “version”:{“type_script”:”1.10.0.0”}.

增强型日志收集

从版本 2411 开始，用户可以下载 Citrix Workspace™ 应用程序日志的 zip 文件，从而简化日志检索和分析，以实现更好的故障排除和改进的用户体验。

以下是此功能所具备的优点：

• 用户不再需要手动收集单个日志文件。
• 简化的流程使访问日志更加高效。
• 轻松访问全面的日志有助于更快、更有效地进行调试。

始终开启跟踪 (AOT)

适用于 HTML5 的 Citrix Workspace 应用程序现在支持始终开启跟踪 (AOT)，这是 Citrix 提供的一种现代诊断框架，可连续捕获 Citrix Virtual Apps and Desktops 环境中的相关日志数据。此功能通过自动捕获用户会话和系统事件的日志数据来简化 IT 管理员和 Citrix 支持团队的故障排除，从而无需重现问题。

AOT 使日志易于访问和阅读，无需工程级专业知识，从而实现自助诊断，减少对 Citrix 支持的依赖，并缩短平均解决时间。

优点

AOT 通过以下方式为客户提供显著价值：

• 自动捕获用户会话和系统事件的日志数据，无需手动干预
• 无需重现问题，因为日志在正常操作期间会持续收集
• 使日志易于访问和阅读，无需工程级专业知识
• 启用自助诊断，减少对 Citrix 支持的依赖
• 缩短故障排除场景的平均解决时间

使用场景

AOT 适用于以下场景，可融入您的整体体验：

• 主动监控： 持续监控用户会话和系统事件，以便在潜在问题影响用户之前识别它们
• 快速故障排除： 在问题发生时立即访问全面的日志数据，无需等待日志重现
• 自助服务支持： 使 IT 管理员能够使用可访问的日志数据独立诊断和解决常见问题

将 AOT 日志上传到集中式 AOT 日志服务器

AOT 日志服务器是用于收集和存储来自各种 Citrix® 组件的 Always On Tracing (AOT) 日志的集中式目标。它使用 Docker 技术进行容器化，最好部署在 Linux 上，但它也通过 Docker Desktop 支持 Windows 环境。

注意：

适用于 HTML5 2603 的 Citrix Workspace 应用程序现在支持将 AOT 日志上传到集中式日志服务器，适用于路径中包含网关的本地部署。

从适用于 HTML5 2603 的 Citrix Workspace 应用程序开始，您可以通过添加以下配置来禁用 AOT 功能：

{
  "aot": {
    "enabled": false
  }
}
<!--NeedCopy-->

先决条件

此功能仅在您使用以下方式打开会话时可用：

• 思杰虚拟应用和桌面™ 版本 2507 CU1 或更高版本

• 思杰虚拟应用和桌面™ 版本 2511 或更高版本

局限性

如果日志服务器在使用 Mozilla Firefox 和 Apple Safari 浏览器时使用 HTTP，则无法上传 AOT 日志。

如何配置

要进行配置，您必须首先安装并配置日志服务器。有关详细的安装和配置步骤，请参阅安装和配置日志服务器。

安装日志服务器后，系统会在同一位置生成一个 StartLogServer 脚本。在 Windows 上，文件名为 StartLogServer.bat；在 Linux 上，文件名为 StartLogServer.sh。

要启用 Citrix Workspace app for HTML5 与日志服务器之间的通信，您必须通过在日志服务器中启用跨域资源共享 (CORS) 来配置日志服务器以接受 StoreFront FQDN URL。

要启用 CORS：

1. 如果日志服务器正在运行，请使用以下命令将其停止：

   docker stop logserver
   <!--NeedCopy-->

1. 通过编辑 CORS_ORIGINS 参数，将以下环境变量添加到 StartLogServer.bat（或 Linux 上的 StartLogServer.sh）：

   -e CORS_ORIGINS=""
   <!--NeedCopy-->

单个 URL 示例：

   -e CORS_ORIGINS="https://xyz.bvt.local;"
   <!--NeedCopy-->

多个 URL 示例：

   -e CORS_ORIGINS="url1;url2;url3"
   <!--NeedCopy-->

使用分号 (;) 分隔多个 URL。

1. 使用 StartLogServer.bat（或 Linux 上的 StartLogServer.sh）重新启动日志服务器。

最终用户体验

在“日志文件”屏幕上，单击“下载所有日志”。应用程序会收集所有相关的日志文件并将其压缩为 zip 存档。下载的文件采用标准化命名约定，例如 CWA_HTML5_LOGS_[timestamp].zip，以确保清晰度和易于识别。

有关详细信息，请参阅如何收集日志。

在 Citrix Director 中查看端点遥测数据

此功能增强了管理员直接在 Citrix Director 中查看端点遥测数据的能力。

必备条件

• 适用于 HTML5 的 Citrix Workspace 应用程序 2411 及更高版本
• VDA 版本 2411 及更高版本
• 思杰总监

会话启动诊断功能

从 2502 版本开始，我们为会话故障实施了改进的支持流程。现在，服务台管理员可以全面了解故障路径，从而有效地分类并显著减少与会话故障相关的支持案例数量。

有关详细信息，请参阅 Citrix Monitor 文档中的会话启动诊断。

禁用错误对话框中 Citrix Workspace 应用程序日志的下载

从 2505 版本开始，管理员可以隐藏适用于 HTML5 的 Citrix Workspace 应用程序（云和本地）中所有应用程序和桌面会话的错误对话框中的下载日志按钮。

注意：

此功能默认处于禁用状态。换句话说，用户可以选择从错误对话框下载日志。

有关详细信息，请参阅禁用错误对话框中 Citrix Workspace 应用程序日志的下载。

用于排查 Entra ID 单点登录支持 VDA 与 Azure AD 凭据设置的日志

本文介绍了当 SSO 失败且用户在会话启动后收到意外凭据提示时可以收集的日志。

要收集日志：

1. 收集基本的 Citrix Workspace 应用程序日志。有关详细信息，请参阅如何收集日志。

2. 收集 Microsoft 身份验证库 (MSAL) 令牌获取状态的网络跟踪：

   i. 在端点上安装 Charles 或 Fiddler。 ii. 在出现问题的浏览器中登录到 Microsoft Entra ID Store。 iii. 启动 Charles 或 Fiddler 应用程序。 iv. 启动适用于 HTML5 的 Citrix Workspace 应用程序会话。重现问题后，通过单击文件 > 保存 > 所有会话导出 Fiddler 跟踪。这将下载您与 Citrix 共享的跟踪。有关详细信息，请参阅以下屏幕截图：

   

3. 从 VDA 收集所有模块和启动跟踪的 Citrix 诊断工具 (CDF) 跟踪。请按照步骤在系统启动时收集 CDF 跟踪，因为即使 Citrix Workspace 应用程序成功进行功能协商，SSO 也可能失败。

常见问题

在哪里可以找到有关新增功能或增强功能的最新信息

您可以在产品文档中找到有关适用于 HTML5 的 Citrix Workspace 应用程序的最新信息。

如何访问技术预览功能？

要了解技术预览版中的功能，请参阅技术预览版中的功能。

如何就 EAR 提供反馈

要就 EAR 版本提供反馈，请单击 (https://forms.gle/ef3eFFKBk7gvTi1b6)。

如何在 Citrix Workspace 应用程序会话中自定义工具栏

管理员可以通过选择哪些选项对最终用户可见来自定义工具栏。管理员可以使用全局应用程序配置服务对其进行自定义。有关详细信息，请参阅产品文档中的工具栏自定义。

如何为启用 SSL 的 VDA 配置密码套件以与适用于 HTML5 的 Citrix Workspace 应用程序配合使用

要配置密码套件，请参阅适用于 HTML5 的 Citrix Workspace 应用程序文档中的密码套件文章。