本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用日誌檔
<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\\GSettings\\com\\nicesoftware\\dcv\\log\\** 金鑰。

1. 按兩下以開啟 **level** 參數。在 **Value data (數值資料)** 中，取決於所需的詳細資訊等級，輸入 `error`、`warn`、`info` 或 `debug`。

1. 選擇 **OK (確定)** 並關閉 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'"
   ```

**注意**  
請確定您使用的是雙引號和單引號。