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

# 使用日志文件
<a name="troubleshooting-logs"></a>

可以使用 Amazon DCV 日志文件找出和解决 Amazon DCV 服务器问题。可以在 Amazon DCV 服务器上的以下位置中找到 Amazon DCV 日志文件：
+ Windows 服务器

  ```
  C:\ProgramData\NICE\dcv\log\
  ```
**注意**  
默认情况下，`ProgramData` 文件夹可能会隐藏。如果未看到 `ProgramData` 文件夹，请将文件浏览器设置为显示隐藏项目。或者，在地址栏中输入 `%programdata%`，然后按 **Enter** 键。
+ Linux 和 macOS 服务器

  ```
  /var/log/dcv/
  ```

可能存在多个名称相似的文件。数字后缀标识文件的年限。这些数字会随着文件变旧而变大。

在排查连接问题时，`server.log` 文件是最相关的。提交支持请求时，最好附上整个文件夹，但可以排除较旧的文件以限制附件大小。

Amazon DCV 服务器允许您配置日志文件的详细程度。提供了以下详细程度等级：
+ `error` - 提供最少的详细信息。仅包括错误。
+ `warn` - 包括错误和警告。
+ `info` - 默认详细程度。包括错误、警告和信息消息。
+ `debug` - 提供最多的详细信息。提供有助于调试问题的详细信息。

**Topics**
+ [更改日志文件详细程度](#change-verbosity)

## 更改日志文件详细程度
<a name="change-verbosity"></a>

更改详细程度可让您调整日志的详细程度，从而帮助您更有效地诊断和解决问题。提高日志详细程度可以捕获有关系统的更精细的信息。降低日志详细程度可以优化存储和增强性能。

### 对于 Windows：
<a name="change-verbosity-windows"></a>

对于 2023.0 版本之后的 Amazon DCV 版本，最好通过命令行配置日志文件的详细程度。对于较早的版本，您必须使用 Windows 注册表编辑器配置 `level` 参数。

**版本 2023.0 及更高版本**

1. 打开命令提示符并以管理员身份运行。

1. 转到安装目录：

   ```
   C:\Program Files\NICE\DCV\Server\bin
   ```

1. 输入以下命令以设置级别：

   ```
   dcv set-config --section log --key level "'LEVEL'"
   ```

1. 输入以下命令以启用调试：

   ```
   dcv set-config --section log --key level "'debug'"
   ```

**注意**  
确保同时使用了双引号和单引号。

**版本 2022.2 及更早版本**

1. 打开 Windows 注册表编辑器。

1. 导航到 **HKEY\_USERS\\ S-1-5-18\\ Software\\\\ com\\ n icesoftwareGSettings\\** dcv\\ log\\ key。

1. 通过双击打开 **level** 参数。对于**数值数据**，键入 `error`、`warn`、`info` 或 `debug`，具体取决于所需的详细程度等级。

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

### 对于 Linux
<a name="change-verbosity-linux"></a>

对于 2023.0 版本之后的 Amazon DCV 版本，最好通过命令行配置日志文件的详细程度。对于较早的版本，您必须在 `dcv.conf` 文件中配置 `level` 参数。

**版本 2023.0 及更高版本**

1. 打开终端。

1. 输入以下命令以设置级别：

   ```
   sudo dcv set-config --section log --key level "'LEVEL'"
   ```

1. 输入以下命令以启用调试：

   ```
   sudo dcv set-config --section log --key level "'debug'"
   ```

**注意**  
确保同时使用了双引号和单引号。

**版本 2022.2 及更早版本**

1. 导航到 `/etc/dcv/`，并使用您常用的文本编辑器打开 `dcv.conf`。

1. 找到 `level` 部分中的 `[log]` 参数，并将现有详细程度等级替换为 `error`、`warn`、`info` 或 `debug`。

   ```
   [log]
   level="{{verbosity_level}}"
   ```

1. 保存并关闭 文件。

### 对于 macOS
<a name="change-verbosity-macos"></a>

1. 打开终端。

1. 输入以下命令以设置级别：

   ```
   sudo dcv set-config --section log --key level "'LEVEL'"
   ```

1. 输入以下命令以启用调试：

   ```
   sudo dcv set-config --section log --key level "'debug'"
   ```

**注意**  
确保同时使用了双引号和单引号。