收集用於偵錯的 WorkSpaces 支援記錄檔服務包 - 部署的最佳做法 WorkSpaces
WSP 伺服器端記錄檔PCoIP 伺服器端記錄檔WebAccess 伺服器端記用戶端記錄適用於 Windows 的自動化伺服器端記錄檔

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

收集用於偵錯的 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 的記錄檔詳細程度層級。

若要變更個人的記錄檔詳細程度 WorkSpaces，請使用 Windows 登錄編輯程式設定機h_log_verbosity_options碼：

  1. 以管理員身分開啟 Windows 登錄編輯程式。

  2. 導覽至 \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon。

  3. 如果WSP金鑰不存在，請按一下滑鼠右鍵，然後選擇「新增」>「機碼」並命名WSP。

  4. 導覽至 \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP。

  5. 如果該h_log_verbosity_options值不存在，請按一下滑鼠右鍵，然後選擇「新增」> DWORD 並將其h_log_verbosity_options命名。

  6. 按一下新 h_log_verbosity_options DWORD，然後根據所需的詳細程度等級，將「值」變更為下列其中一個數字：

    • 0 — 錯誤

    • 1 — 警告

    • 。2-信息。

    • 3 — 除錯

  7. 選擇 OK (確定) 並關閉 Windows 登錄編輯程式。

  8. 重新啟動 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

  2. 在pcoip_admin_defaults索引鍵中，建立下列 32 位元 DWORD：pcoip.event_filter_mode

  3. 將的值設定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 戶端的進階記錄。

  2. 然後，最終用戶應該像往常一樣連接，使用他們的 WorkSpace，並嘗試重現問題。

  3. 進階記錄會產生包含診斷資訊和偵錯層級詳細資料 (包括詳細效能資料) 的日誌。

此設定會一直保留到明確關閉為止。使用者成功重現詳細登入的問題之後，應停用此設定，因為它會產生大型記錄檔。

適用於 Windows 的自動化伺服器端記錄檔

此指Get-WorkSpaceLogs.ps1令碼有助於快速收集的伺服器端記錄檔服務包 AWS 支援。可以 AWS 支援 通過在支持案例中請求腳本來請求腳本：

  1. 使用用戶端或 WorkSpace 使用遠端桌面通訊協定 (RDP) Connect 線至。

  2. 啟動管理命令提示符（以管理員身份運行）。

  3. 使用下列命令，從命令提示字元啟動指令碼：

    powershell.exe -NoLogo -ExecutionPolicy RemoteSigned -NoProfile -File "C:\Program Files\Amazon\WorkSpacesConfig\Scripts\Get-WorkSpaceLogs.ps1"

  4. 指令碼會在使用者的桌面上建立記錄服務包。

    該腳本創建一個包含以下文件夾的 zip 文件：

    • Ç-包含從程序文件的文件, 程序文件 (x86), ProgramData, 和視窗有關天窗, EC2Config, 圖表, 事件查看器, 和 Windows 日誌 (豹和其他人).

    • CLIxml — 包含 XML 檔案，這些檔案可以使用Import-CliXML互動式篩選匯入。請參閱匯入檔案。

    • Config — 每次執行的檢查的詳細記錄

    • ScriptLogs— 有關指令碼執行的記錄檔 (與調查無關，但對於偵錯指令碼的作用很有用)。

    • tmp — 暫存資料夾 (應該是空的)。

    • 追蹤 — 在記錄收集期間完成的封包擷取。