本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 收集用於偵錯的 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\`
### 變更視窗上的記錄檔詳細程度
您可以設定記錄詳細程度層級群組原則設定，以大**規模**設定 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. 選擇 **OK (確定)** 並關閉 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`至 DWORD，因為它們會大得多，而且會不必要地消耗磁碟空間。
## WebAccess 伺服器端記
對於 PCoIP 和 WSP（1.0 以上版本） WorkSpaces， WorkSpaces 網頁存取用戶端會使用 STXHD 服務。 WorkSpaces Web 存取的記錄會儲存在`C:\ProgramData\Amazon\Stxhd\Logs`。
對於 WSP (2.0 版以上) WorkSpaces， WorkSpaces 網頁存取的記錄會儲存在。`C:\ProgramData\Amazon\WSP\`
## 用戶端記錄
這些記錄檔來自使用者連線的用 WorkSpaces 戶端，因此記錄檔位於使用者的電腦上。視窗和 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) Connect 線至。
1. 啟動管理命令提示符（以管理員身份運行）。
1. 使用下列命令，從命令提示字元啟動指令碼：
```
powershell.exe -NoLogo -ExecutionPolicy RemoteSigned -NoProfile -File "C:\Program Files\Amazon\WorkSpacesConfig\Scripts\Get-WorkSpaceLogs.ps1"
```
1. 指令碼會在使用者的桌面上建立記錄服務包。
該腳本創建一個包含以下文件夾的 zip 文件：
+ **Ç**-包含從程序文件的文件, 程序文件 (x86), ProgramData, 和視窗有關天窗, EC2Config, 圖表, 事件查看器, 和 Windows 日誌 (豹和其他人).
+ **CLIxml** — 包含 XML 檔案，這些檔案可以使用`Import-CliXML`互動式篩選匯入。請參閱匯[入檔](https://msdn.microsoft.com/en-us/powershell/reference/5.1/microsoft.powershell.utility/import-clixml)案。
+ **Config** — 每次執行的檢查的詳細記錄
+ **ScriptLogs**— 有關指令碼執行的記錄檔 (與調查無關，但對於偵錯指令碼的作用很有用)。
+ **tmp** — 暫存資料夾 (應該是空的)。
+ **追蹤** — 在記錄收集期間完成的封包擷取。