Mengumpulkan bundel log WorkSpaces dukungan untuk debugging

Saat memecahkan WorkSpaces masalah, perlu untuk mengumpulkan bundel log dari yang terpengaruh WorkSpace dan host tempat WorkSpaces klien diinstal. Ada dua kategori dasar log:

• Log sisi server: Ini WorkSpace adalah server dalam skenario ini, jadi ini adalah log yang hidup dengan sendirinya. WorkSpace

• Log sisi klien: Log pada perangkat yang digunakan pengguna akhir untuk terhubung ke file. WorkSpace

• Hanya klien Windows dan macOS yang menulis log secara lokal.

• Nol klien dan klien iOS tidak log.

• Log Android dienkripsi di penyimpanan lokal dan diunggah secara otomatis ke tim rekayasa WorkSpaces klien. Hanya tim yang dapat meninjau log untuk perangkat Android.

Log sisi server WSP

Semua komponen WSP menulis file log mereka ke salah satu dari dua folder:

• Lokasi utama: C:\ProgramData\Amazon\WSP\ dan C:\ProgramData\NICE\dcv\log\

• Lokasi arsip: C:\ProgramData\Amazon\WSP\TRANSMITTED\

Mengubah verbositas file log pada Windows

Anda dapat mengonfigurasi tingkat verbositas file log untuk WSP Windows dalam skala besar dengan mengonfigurasi pengaturan Kebijakan Grup WorkSpaces tingkat verbositas log.

Untuk mengubah verbositas file log untuk individu WorkSpaces, konfigurasikan h_log_verbosity_options kunci menggunakan Windows Registry Editor:

1. Buka Windows Registry Editor sebagai administrator.

2. Navigasi ke \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon.

3. Jika WSP kunci tidak ada, klik kanan dan pilih New > Key dan beri nama. WSP

4. Navigasi ke \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP.

5. Jika h_log_verbosity_options nilainya tidak ada, klik kanan dan pilih New > DWORD dan beri nama. h_log_verbosity_options

6. Klik h_log_verbosity_options DWORD baru dan ubah Nilai ke salah satu angka berikut tergantung pada tingkat verbositas yang diperlukan:

   • 0 - Kesalahan

   • 1 - Peringatan

   • 2 — Info

   • 3 - Debug

7. Pilih OK dan tutup Windows Registry Editor.

8. Mulai ulang WorkSpace.

Log sisi server PCoIP

Semua komponen PCoIP menulis file log mereka ke salah satu dari dua folder:

• Lokasi utama: C:\ProgramData\Teradici\PCoIPAgent\logs

• Lokasi arsip: C:\ProgramData\Teradici\logs

Terkadang ketika bekerja dengan AWS Dukungan masalah yang kompleks, perlu untuk menempatkan agen Server PCoIP ke mode logging verbose. Untuk mengaktifkan ini:

1. Buka kunci registri berikut: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Teradici\PCoIP\pcoip_admin_defaults

2. Pada pcoip_admin_defaults kuncinya, buat DWORD 32-bit berikut: pcoip.event_filter_mode

3. Tetapkan nilai pcoip.event_filter_mode untuk “3” (Des atau Hex).

Sebagai referensi, ini adalah ambang log yang dapat didefinisikan dalam DWORD ini.

• 0 — (KRITIS)

• 1 - (KESALAHAN)

• 2 — (INFO)

• 3 - (Debug)

Jika pcoip_admin_default DWORD tidak ada, level log secara 2 default. Disarankan untuk mengembalikan nilai ke DWORD setelah tidak lagi membutuhkan log verbose, karena mereka jauh lebih besar dan akan mengkonsumsi ruang disk yang tidak perlu. 2

WebAccess log sisi server

Untuk PCoIP dan WSP (versi 1.0+) WorkSpaces, klien Akses WorkSpaces Web menggunakan layanan STXHD. Log untuk Akses WorkSpaces Web disimpan diC:\ProgramData\Amazon\Stxhd\Logs.

Untuk WSP (versi 2.0+) WorkSpaces, log untuk Akses WorkSpaces Web disimpan di. C:\ProgramData\Amazon\WSP\

Log sisi klien

Log ini berasal dari WorkSpaces klien yang terhubung dengan pengguna, sehingga log berada di komputer pengguna akhir. Lokasi file log untuk Windows dan Mac adalah:

• 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

Untuk membantu memecahkan masalah yang mungkin dialami pengguna, aktifkan pencatatan lanjutan yang dapat digunakan pada klien Amazon WorkSpaces mana pun. Pencatatan lanjutan diaktifkan untuk setiap sesi klien berikutnya hingga dinonaktifkan.

1. Sebelum menghubungkan ke WorkSpace, pengguna akhir harus mengaktifkan pencatatan lanjutan untuk WorkSpaces klien mereka.

2. Pengguna akhir kemudian harus terhubung seperti biasa, menggunakannya WorkSpace, dan mencoba mereproduksi masalah.

3. Pendataan lanjutan menghasilkan berkas log yang berisi informasi diagnostik dan detail tingkat debugging, termasuk data performa verbose.

Pengaturan ini berlanjut hingga dimatikan secara eksplisit. Setelah pengguna berhasil mereproduksi masalah dengan login verbose, pengaturan ini harus dinonaktifkan, karena menghasilkan file log besar.

Koleksi bundel log sisi server otomatis untuk Windows

Get-WorkSpaceLogs.ps1Skrip ini membantu untuk mengumpulkan bundel log sisi server dengan cepat untuk. AWS Dukungan Skrip dapat diminta AWS Dukungan dengan memintanya dalam kasus dukungan:

1. Connect ke WorkSpace menggunakan klien atau menggunakan Remote Desktop Protocol (RDP).

2. Mulai Command Prompt administratif (jalankan sebagai administrator).

3. Luncurkan skrip dari Command Prompt dengan perintah berikut:

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

4. Skrip membuat bundel log di desktop pengguna.

   Script membuat file zip dengan folder berikut:

   • C - Berisi file dari Program Files, Program Files (x86), ProgramData, dan Windows yang terkait dengan Skylight, EC2config, Teradici, Event viewer, dan log Windows (Panther dan lainnya).

   • CliXML - Berisi file XMLyang dapat diimpor di Powershell dengan menggunakan Import-CliXML untuk penyaringan interaktif. Lihat Import-Clixml.

   • Config - Log terperinci untuk setiap pemeriksaan yang dilakukan

   • ScriptLogs— Log tentang eksekusi skrip (tidak relevan dengan penyelidikan, tetapi berguna untuk men-debug apa yang dilakukan skrip).

   • tmp —Folder sementara (harus kosong).

   • Jejak — Pengambilan paket dilakukan selama pengumpulan log.