本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 收集用于调试的 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 的[日志文件详细](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html#log_verbosity)级别。
要更改个人日志文件的详细程度 WorkSpaces，请使用 Windows 注册表编辑器配置`h_log_verbosity_options`密钥：
1. 以管理员身份打开 Windows 注册表编辑器。
1. 导航到 `\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon`。
1. 如果`WSP`密钥不存在，请右键单击并选择 “**新建**” > “**密钥**” 并命名它`WSP`。
1. 导航到 `\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP`。
1. 如果该`h_log_verbosity_options`值不存在，请右键单击并选择 “**新建**” > “**DWORD**”，然后将其`h_log_verbosity_options`命名。
1. 单击新的 `h_log_verbosity_options` **DWORD** 并将**值**更改为以下数字之一，具体取决于所需的详细程度：
+ 0 — 错误
+ 1 — 警告
+ 2 — 信息
+ 3 — 调试
1. 选择**确定**，并关闭 Windows 注册表编辑器。
1. 重新启动 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`
1. 在`pcoip_admin_defaults`密钥中，创建以下 32 位 DWORD：`pcoip.event_filter_mode`
1. 将的值设置`pcoip.event_filter_mode`为 “`3`”（十进制或十六进制）。
作为参考，这些是可以在此 DWORD 中定义的日志阈值。
+ 0 —（严重）
+ 1 —（错误）
+ 2 —（信息）
+ 3 —（调试）
如果 `pcoip_admin_default` DWORD 不存在，则`2`默认情况下为日志级别。建议在 DWORD 不再需要冗余日志后将其恢复`2`为的值，因为这些日志要大得多，并且会不必要地消耗磁盘空间。
## WebAccess 服务器端日志
对于 PCoIP 和 WSP（版本 1.0\$1） WorkSpaces， WorkSpaces Web Access 客户端使用 STXHD 服务。 WorkSpaces Web 访问的日志存储在`C:\ProgramData\Amazon\Stxhd\Logs`。
对于 WSP（版本 2.0\$1） 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 客户端[启用高级日志记录](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html#advanced-logging)。
1. 然后，最终用户应照常连接，使用他们的 WorkSpace，并尝试重现问题。
1. 高级日志记录将生成包含诊断信息和调试级别详细信息（包括详细的性能数据）的日志文件。
在明确关闭之前，此设置一直有效。用户成功重现详细登录问题后，应禁用此设置，因为它会生成较大的日志文件。
## 适用于 Windows 的自动服务器端日志包收集
该`Get-WorkSpaceLogs.ps1`脚本有助于快速收集服务器端日志包。 AWS 支持可以通过在支持案例中请求脚本 AWS 支持 来请求脚本：
1. 使用客户端或 WorkSpace 使用远程桌面协议 (RDP) 连接到。
1. 启动管理命令提示符（以管理员身份运行）。
1. 使用以下命令从命令提示符启动脚本：
```
powershell.exe -NoLogo -ExecutionPolicy RemoteSigned -NoProfile -File "C:\Program Files\Amazon\WorkSpacesConfig\Scripts\Get-WorkSpaceLogs.ps1"
```
1. 该脚本在用户的桌面上创建日志包。
该脚本创建一个包含以下文件夹的 zip 文件：
+ **C** — 包含程序文件、程序文件 (x86) 和 Windows 中与 Skylight ProgramData、ec2Config、Teradici、事件查看器和 Windows 日志（Panther 等）相关的文件。
+ **cliXML** — 包含可用于交互式筛选的 XML 文件，这些文件可以导入 Powershell 中。`Import-CliXML`请参阅 Import [-Clixml](https://msdn.microsoft.com/en-us/powershell/reference/5.1/microsoft.powershell.utility/import-clixml)。
+ **Config**-所执行的每项检查的详细日志
+ **ScriptLogs**— 有关脚本执行的日志（与调查无关，但对于调试脚本的作用很有用）。
+ **tmp** —临时文件夹（应为空）。
+ **跟踪**-在日志收集期间完成的数据包捕获。