产品文档
适用于 ChromeOS 的 Citrix Workspace™ 应用程序
查看 PDF

故障排除

April 20, 2026
投稿者: 
C C

如何收集日志

Citrix Workspace app for ChromeOS 为用户设备生成的日志提供时间戳。Citrix Workspace app 支持为正在进行的虚拟桌面和应用程序会话收集日志。

作为最终用户，您可以收集日志以协助故障排除。日志可以在用户设备和计算机上生成。日志可以用于桌面和应用程序。

以前，您只能收集在正在进行的会话期间选择“开始日志记录”后启动的会话的日志。现在，日志会为正在进行的会话和后续会话收集，直到您选择“停止日志记录”。

在用户设备上进行日志记录

要启用日志记录：

  1. 在用户设备上，启动 Citrix Workspace app 并导航到登录页面。

  2. 单击右下角的设置（齿轮）图标。

  3. 在“设置”对话框中，选择“日志记录”>“开始日志记录”。

    收集的日志文件的详细信息列在“设置”对话框中。

  4. 选择“停止日志记录”以结束在用户设备上收集日志。

客户端日志

要收集客户端日志：

  1. 单击 Citrix Workspace app “登录”屏幕右下角的“设置”（齿轮）图标。

    设置

  2. 单击“日志记录”>“开始日志记录”以启用日志收集。

    日志

  3. “开始日志记录”字段更改为“停止日志记录”。此更改表示已启用日志收集。

    关闭“帐户”对话框。

    1. 登录到 Citrix Workspace app 虚拟桌面并启动您的虚拟应用程序会话，然后重现问题以收集日志。

    Citrix Workspace app

    继续在该会话上工作以重现问题。

  1. 问题重现后，关闭会话。

  2. 再次单击“设置”以打开“帐户”对话框。

  3. 选择“日志记录”选项卡。

  4. “日志记录”对话框显示捕获的“日志文件”列表。

    日志文件

  5. 将鼠标移到任何日志文件上方。右侧会出现一个小箭头。

    箭头

  6. 单击箭头以下载并保存一些日志文件。

  7. 单击“下载所有日志”并与管理员或 Citrix® 支持工程师共享。

  8. 单击“停止日志记录”。

注意：

在自助服务终端模式下，文件可以保存到 USB 可移动设备。

增强的日志收集

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

以下是此功能的优点：

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

最终用户体验

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

下载所有日志

控制台日志

要收集控制台日志：

    1. 在 Citrix Workspace app 的 Google Chrome 浏览器中打开 chrome://inspect/#apps 页面。

  1. 在“应用程序”选项卡中，单击“检查”所有与 Citrix Workspace 相关的窗口：SessionWindow.html、Main.html（及其子节点）。

    Chrome 检查

    检查

  2. 对于每个打开的开发人员工具窗口，单击“控制台”。然后，右键单击并选择“另存为”选项以保存整个日志。

  • 控制台

  • USB 重定向日志

  • 要收集 USB 重定向日志：
  1. 按照 使用 Web.config 中适用于 ChromeOS 的步骤操作，并通过以下方式为 USB 启用 moreLogs：
  • 在 StoreFront 上的 web.config 文件中，将 moreLogs 配置值添加到 chromeAppPreferences：
  • chromeAppPreferences ='{"moreLogs":{"usb":true}}'

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

    设备日志

文件传输日志

可以从客户端和服务器检索文件传输日志。

要从客户端检索文件传输日志：

  1. 启动浏览器。
  2. 转至以下 URL 以开始记录： <storefronturl>/clients/html5client/src/viewlog.html 其中 <storefronturl> 是配置了应用商店的 StoreFront 服务器的 FQDN 或 IP 地址。

有关文件传输的详细信息，请参阅 HTML5 和 Chrome 文件传输说明。

Microsoft Teams 优化日志

Microsoft Teams 优化支持最新的 shim 库版本 1.8.0.12。

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

  1. 启动 Microsoft Teams 应用程序并与其中一位用户发起呼叫。

  2. 建立呼叫后，最大化 Microsoft Teams 窗口。

  3. 在会话中打开屏幕键盘，然后单击 Ctrl + Alt + Shift + 1 键。 您现在可以在下载文件夹中查看日志文件。

  4. 打开 MSTeams Diagnostics Log <date><time>_vdi partner.txt 文件，并在 type_script 下搜索 shim 版本。 将 shim 版本与 1.8.0.12 进行比较。

  5. （可选）如果 shim 版本不是 1.8.0.12，请联系您的管理员升级到最新版本。

  • 信息亭模式下的客户端日志

要在信息亭模式下收集日志：

  1. 将可移动 USB 设备连接到 Chromebook。

  2. 下载日志文件。

  3. 将日志文件保存到连接的 USB 设备中。

    日志文件将传输到 USB 设备。

快捷方式

  • 键盘快捷方式 Ctrl+ Alt + Shift +1 可能无法在虚拟桌面中优化的 Microsoft Teams 中使用。作为一种解决方法，请打开屏幕键盘并使用该快捷方式。 [RFHTMCRM-5441]

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

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

先决条件

  • 适用于 ChromeOS 的 Citrix Workspace 应用程序 2411 及更高版本
  • VDA 版本 2411 及更高版本
  • Citrix Director

会话启动诊断

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

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

始终开启跟踪 (AOT)

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

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

优势

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

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

用例

AOT 适用于以下场景中的整体体验：

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

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

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

注意：

  • 在此适用于 ChromeOS 的 Citrix Workspace 应用程序 2511 版本中，AOT 日志仅针对路径中没有网关的本地部署进行捕获。
  • 在适用于 ChromeOS 的 Citrix Workspace 应用程序 2603 中，AOT 日志上传到集中式日志服务器支持路径中没有网关的本地部署和路径中有网关的本地部署。

配置

从适用于 ChromeOS 的 Citrix Workspace 应用程序 2603 开始，您可以通过添加以下配置来禁用 AOT 功能。对于托管设备和用户，管理员可以使用 Google 管理策略禁用 AOT，如下所示：

  1. 登录 Google Admin Policy。

  2. 转至“设备管理”>“Chrome 管理”>“用户设置”。

    注意：

    您也可以将此配置应用于以下各项：

    • “设备”>“Chrome”>“应用和扩展程序”>“用户和浏览器”> 搜索扩展程序 > 扩展程序策略。
    • “设备”>“Chrome”>“应用和扩展程序”>“自助服务终端”> 搜索扩展程序 > 扩展程序策略。
    • “设备”>“Chrome”>“应用和扩展程序”>“托管访客会话”> 搜索扩展程序 > 扩展程序策略。

  3. 在 engine_settings 键下，将以下字符串添加到 policy.txt 文件中。

    确保在 aot 对象下将 "enabled": false 设置为 false。以下是 JSON 数据的示例：

    {
"settings": {
"Value": {
"settings_version": "1.0",
"engine_settings": {
    "aot": {
        "enabled": false
            }
        }
    }
    }
}
<!--NeedCopy-->

先决条件

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

  • Citrix Virtual Apps and Desktops™ 2507 CU1 或更高版本

  • Citrix Virtual Apps and Desktops™ 2511 或更高版本

如何配置

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

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

要在适用于 ChromeOS 的 Citrix Workspace 应用程序与日志服务器之间启用通信，您必须通过在日志服务器中启用跨域资源共享 (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）重新启动日志服务器。

针对使用 Azure AD 凭据设置的 VDA 的 Entra ID 单点登录支持故障排除日志

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

要收集日志：

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

  2. 收集 MSAL 令牌获取状态的网络跟踪：

    i. 打开 Chrome 浏览器并导航到 chrome://net-export/。 ii. 选择“开始记录到磁盘”，然后选择“包括原始字节（将包括 Cookie 和凭据）”选项，如以下屏幕截图所示。选择文件位置。

    开始记录到磁盘

    iii. 启动适用于 ChromeOS 的 Citrix Workspace 应用程序会话以重现该问题并收集跟踪。在 chrome://net-export/ 中选择“停止记录”。

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

已知限制

  • 适用于 ChromeOS 的 Citrix Workspace 应用程序不支持混合启动的 SSO，因为它缺少内存中 ICA 支持。

  • 如果会话启动时间超过 30 秒，AAD SSO 登录可能会失败并提示用户输入凭据。

常见问题

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

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

如何访问技术预览功能

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

如何就 EAR 提供反馈

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

如何从 Chrome 网上应用店安装适用于 ChromeOS 的 Citrix Workspace 应用程序

最终用户可以从 Chrome 网上应用店安装适用于 ChromeOS 的 Citrix Workspace 应用程序。有关详细信息，请参阅产品文档中的从 Chrome 网上应用店安装。

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

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

如何配置 USB 重定向

适用于 ChromeOS 的 Citrix Workspace 应用程序支持各种 USB 外设。借助此新增功能，您可以创建 Google 策略来识别设备的 PID/VID，以使其能够在 Citrix Workspace 应用程序中使用。此支持也适用于新的 USB 设备。要配置此功能，请参阅产品文档中的 USB 配置。

故障排除
April 20, 2026
投稿者: 
C C
April 20, 2026
投稿者: 
C C

在本文中

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