收集用于调试的 WorkSpaces 支持日志包 - 部署的最佳实践 WorkSpaces
WSP 服务器端日志PCoIP 服务器端日志WebAccess 服务器端日志客户端日志适用于 Windows 的自动服务器端日志包收集

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

收集用于调试的 WorkSpaces 支持日志包

在对 WorkSpaces 问题进行故障排除时，必须从受影响的服务器 WorkSpace 和安装 WorkSpaces 客户端的主机处收集日志包。日志有两种基本类别：

  • 服务器端日志：在这种情况下 WorkSpace 是服务器，所以这些日志是独立存在的 WorkSpace 。

  • 客户端日志：最终用户用于连接的设备上的日志。 WorkSpace

  • 只有 Windows 和 macOS 客户端在本地写入日志。

  • 零客户端，iOS 客户端不登录。

  • Android 日志在本地存储上进行加密，并自动上传到 WorkSpaces 客户工程团队。只有该团队才能查看 Android 设备的日志。

WSP 服务器端日志

所有 WSP 组件都将其日志文件写入以下两个文件夹之一：

  • 主要位置：C:\ProgramData\Amazon\WSP\和 C:\ProgramData\NICE\dcv\log\

  • 存档位置：C:\ProgramData\Amazon\WSP\TRANSMITTED\

在 Windows 上更改日志文件的详细程度

您可以通过配置日志详细级别组策略设置来大规模配置 WSP Windows WorkSpaces 的日志文件详细级别。

要更改个人日志文件的详细程度 WorkSpaces，请使用 Windows 注册表编辑器配置h_log_verbosity_options密钥：

  1. 以管理员身份打开 Windows 注册表编辑器。

  2. 导航到 \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon。

  3. 如果WSP密钥不存在，请右键单击并选择 “新建” > “密钥” 并命名它WSP。

  4. 导航到 \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP。

  5. 如果该h_log_verbosity_options值不存在，请右键单击并选择 “新建” > “DWORD”，然后将其h_log_verbosity_options命名。

  6. 单击新的 h_log_verbosity_options DWORD 并将值更改为以下数字之一，具体取决于所需的详细程度：

    • 0 — 错误

    • 1 — 警告

    • 2 — 信息

    • 3 — 调试

  7. 选择确定，并关闭 Windows 注册表编辑器。

  8. 重新启动 WorkSpace。

PCoIP 服务器端日志

所有 PCoIP 组件都将其日志文件写入以下两个文件夹之一：

  • 主要位置：C:\ProgramData\Teradici\PCoIPAgent\logs

  • 存档位置：C:\ProgramData\Teradici\logs

有时， AWS 支持 在处理复杂问题时，需要将 PCoIP Server 代理置于详细日志模式。要启用它，请执行以下操作：

  1. 打开以下注册表项：HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Teradici\PCoIP\pcoip_admin_defaults

  2. 在pcoip_admin_defaults密钥中，创建以下 32 位 DWORD：pcoip.event_filter_mode

  3. 将的值设置pcoip.event_filter_mode为 “3”（十进制或十六进制）。

作为参考，这些是可以在此 DWORD 中定义的日志阈值。

  • 0 —（严重）

  • 1 —（错误）

  • 2 —（信息）

  • 3 —（调试）

如果 pcoip_admin_default DWORD 不存在，则2默认情况下为日志级别。建议在 DWORD 不再需要冗余日志后将其恢复2为的值，因为这些日志要大得多，并且会不必要地消耗磁盘空间。

WebAccess 服务器端日志

对于 PCoIP 和 WSP（版本 1.0+） WorkSpaces， WorkSpaces Web Access 客户端使用 STXHD 服务。 WorkSpaces Web 访问的日志存储在C:\ProgramData\Amazon\Stxhd\Logs。

对于 WSP（版本 2.0+） WorkSpaces， WorkSpaces Web 访问的日志存储在。C:\ProgramData\Amazon\WSP\

客户端日志

这些日志来自用户连接的 WorkSpaces 客户端，因此日志位于最终用户的计算机上。Windows 和 Mac 的日志文件位置为：

  • Windows："%LOCALAPPDATA%\Amazon Web Services\Amazon WorkSpaces\Logs"

  • macOS：~/Library/"Application Support"/"Amazon Web Services"/"Amazon WorkSpaces"/logs

  • Linux：~/.local/share/Amazon Web Services/Amazon WorkSpaces/logs

要帮助解决用户可能遇到的问题，请启用可在任何 Amazon WorkSpaces 客户端上使用的高级日志记录。在禁用之前，将为每个后续客户端会话启用高级日志记录。

  1. 在连接到之前 WorkSpace，最终用户应为其 WorkSpaces 客户端启用高级日志记录。

  2. 然后，最终用户应照常连接，使用他们的 WorkSpace，并尝试重现问题。

  3. 高级日志记录将生成包含诊断信息和调试级别详细信息（包括详细的性能数据）的日志文件。

在明确关闭之前，此设置一直有效。用户成功重现详细登录问题后，应禁用此设置，因为它会生成较大的日志文件。

适用于 Windows 的自动服务器端日志包收集

该Get-WorkSpaceLogs.ps1脚本有助于快速收集服务器端日志包。 AWS 支持可以通过在支持案例中请求脚本 AWS 支持 来请求脚本：

  1. 使用客户端或 WorkSpace 使用远程桌面协议 (RDP) 连接到。

  2. 启动管理命令提示符（以管理员身份运行）。

  3. 使用以下命令从命令提示符启动脚本：

    powershell.exe -NoLogo -ExecutionPolicy RemoteSigned -NoProfile -File "C:\Program Files\Amazon\WorkSpacesConfig\Scripts\Get-WorkSpaceLogs.ps1"

  4. 该脚本在用户的桌面上创建日志包。

    该脚本创建一个包含以下文件夹的 zip 文件：

    • C — 包含程序文件、程序文件 (x86) 和 Windows 中与 Skylight ProgramData、ec2Config、Teradici、事件查看器和 Windows 日志（Panther 等）相关的文件。

    • cliXML — 包含可用于交互式筛选的 XML 文件，这些文件可以导入 Powershell 中。Import-CliXML请参阅 Import -Clixml。

    • Config-所执行的每项检查的详细日志

    • ScriptLogs— 有关脚本执行的日志（与调查无关，但对于调试脚本的作用很有用）。

    • tmp —临时文件夹（应为空）。

    • 跟踪-在日志收集期间完成的数据包捕获。