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

# 在 WorkSpaces 个人版中启用诊断日志上传
<a name="enable-diagnostic-log-uploads"></a>

要排查 WorkSpaces 客户端问题，请启用自动诊断日志上传功能。目前，Windows、macOS、Linux 和 Web Access 客户端支持此项功能。

**注意**  
WorkSpaces 客户端诊断日志上传功能目前在 AWS GovCloud（美国西部）区域不提供。

## 诊断日志上传
<a name="diagnostic-log-uploads"></a>

借助诊断日志上传功能，您可以在不中断 WorkSpaces 客户端使用的情况下，直接将 WorkSpaces 客户端日志文件上传到 WorkSpaces 以排查相关问题。如果您为用户启用诊断日志上传，或者让您的用户自行启用该功能，则日志文件将自动发送到 WorkSpaces。您可以在 WorkSpaces 流式传输会话之前或期间启用诊断日志上传。

要从托管设备自动上传诊断日志，请安装支持诊断上传的 WorkSpaces 客户端。默认情况下，日志上传处于启用状态。您可以通过以下任一方式修改设置：

### 选项 1：使用 AWS 控制台
<a name="diagnostic-log-console"></a>

1. 打开 WorkSpaces 控制台，网址为：[https://console.aws.amazon.com/workspaces/v2/home](https://console.aws.amazon.com/workspaces/v2/home)。

1. 在导航窗格中，选择**目录**。

1. 选择要启用诊断日志的目录名称。

1. 向下滚动到**自助服务权限**。

1. 选择**查看详细信息**

1. 选择**编辑**。

1. 选择**诊断日志上传**。

1. 选择**保存**。

### 选项 2：使用 API 调用
<a name="diagnostic-log-api"></a>

您可以编辑目录设置以启用或禁用 WorkSpaces Windows、macOS 和 Linux 客户端，以便使用 API 调用自动上传诊断日志。如果启用，则当客户端出现问题时，日志将发送到 WorkSpaces，而无需用户交互。有关更多信息，请参阅 [WorkSpaces API 参考](https://docs.aws.amazon.com/workspaces/latest/api/API_ClientProperties.html)。

您也可以让用户选择是否在安装客户端后启用自动诊断日志上传。有关更多信息，请参阅 [WorkSpaces Windows 客户端应用程序](https://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)、[WorkSpaces macOS 客户端应用程序](https://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)以及 [WorkSpaces Linux 客户端应用程序](https://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html)。

**注意**  
诊断日志不包含敏感信息。您可以在目录级别为用户禁用自动诊断日志上传，或者允许您的用户自行禁用这些功能。
要访问诊断日志上传功能，您需要安装以下版本的 WorkSpaces 客户端：  
Windows 客户端 5.4.0 或更高版本
macOS 客户端 5.8.0 或更高版本
Ubuntu 22.04 客户端 2023.1
Ubuntu 20.04 客户端 2023.1
也可以使用 Web Access 客户端访问诊断日志上传功能