Raccolta di un pacchetto di registri di supporto per il debug WorkSpaces

Durante la risoluzione dei WorkSpaces problemi, è necessario raccogliere il pacchetto di log dall'host interessato WorkSpace e dall'host su cui è installato il client. WorkSpaces Esistono due categorie fondamentali di log:

• Registri lato server: in questo scenario WorkSpace si tratta del server, quindi si tratta di registri che risiedono autonomamente. WorkSpace

• Log lato client: consente di accedere al dispositivo utilizzato dall'utente finale per connettersi a. WorkSpace

• Solo i client Windows e macOS scrivono i log localmente.

• I client Zero e i client iOS non si registrano.

• I log Android sono crittografati nella memoria locale e caricati automaticamente nel team di progettazione del WorkSpaces cliente. Solo quel team può esaminare i log per i dispositivi Android.

Registri lato server WSP

Tutti i componenti WSP scrivono i propri file di registro in una delle due cartelle seguenti:

• Ubicazione principale: C:\ProgramData\Amazon\WSP\ e C:\ProgramData\NICE\dcv\log\

• Ubicazione dell'archivio: C:\ProgramData\Amazon\WSP\TRANSMITTED\

Modifica della verbosità dei file di registro in Windows

È possibile configurare il livello di verbosità del file di registro per Windows WSP su larga scala configurando l'impostazione dei Criteri di WorkSpaces gruppo per il livello di verbosità del file di registro.

Per modificare la verbosità del file di registro per singolo utente WorkSpaces, configura la chiave utilizzando l'editor del registro di Windows: h_log_verbosity_options

1. Apri l'editor del Registro di sistema come amministratore.

2. Accedi a \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon.

3. Se la WSP chiave non esiste, fate clic con il pulsante destro del mouse e scegliete Nuovo > Chiave e assegnatele un nome. WSP

4. Accedi a \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP.

5. Se il h_log_verbosity_options valore non esiste, fate clic con il pulsante destro del mouse e scegliete Nuovo > DWORD e assegnategli un h_log_verbosity_options nome.

6. Fate clic sul nuovo h_log_verbosity_options DWORD e modificate il valore in uno dei seguenti numeri a seconda del livello di dettaglio richiesto:

   • 0 — Errore

   • 1 — Avvertenza

   • 2 — Informazioni

   • 3 — Eseguire il debug

7. Seleziona OK e chiudi l'editor del Registro di sistema di Windows.

8. Riavviare il. WorkSpace

Registri PCoIP lato server

Tutti i componenti PCoIP scrivono i propri file di registro in una delle due cartelle:

• Ubicazione principale: C:\ProgramData\Teradici\PCoIPAgent\logs

• Ubicazione dell'archivio: C:\ProgramData\Teradici\logs

A volte, quando si lavora Supporto AWS su un problema complesso, è necessario mettere l'agente del server PCoIP in modalità di registrazione dettagliata. Per abilitare questa funzionalità:

1. Apri la seguente chiave di registro: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Teradici\PCoIP\pcoip_admin_defaults

2. Nella pcoip_admin_defaults chiave, create il seguente DWORD a 32 bit: pcoip.event_filter_mode

3. Imposta il valore pcoip.event_filter_mode per «3» (Dec o Hex).

Per riferimento, queste sono le soglie di registro che possono essere definite in questo DWORD.

• 0 — (CRITICO)

• 1 — (ERRORE)

• 2 — (INFORMAZIONI)

• 3 — (Debug)

Se il pcoip_admin_default DWORD non esiste, il livello di registro è predefinito2. Si consiglia di ripristinare un valore di 2 nel file DWORD dopo che non sono più necessari registri dettagliati, poiché sono molto più grandi e occupano spazio su disco inutilmente.

WebAccess registri lato server

Per PCoIP e WSP (versione 1.0+) WorkSpaces, il client WorkSpaces Web Access utilizza il servizio STXHD. I log per Web Access sono archiviati in. WorkSpaces C:\ProgramData\Amazon\Stxhd\Logs

Per WSP (versione 2.0+) WorkSpaces, i log per WorkSpaces Web Access sono archiviati in. C:\ProgramData\Amazon\WSP\

Registri lato client

Questi registri provengono dal WorkSpaces client con cui l'utente si connette, quindi si trovano sul computer dell'utente finale. Le posizioni dei file di registro per Windows e Mac sono:

• 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

Per aiutare a risolvere i problemi che gli utenti potrebbero riscontrare, abilita la registrazione avanzata che può essere utilizzata su qualsiasi client Amazon. WorkSpaces La registrazione avanzata è abilitata per ogni sessione client successiva fino a quando non viene disabilitata.

1. Prima di connettersi a WorkSpace, l'utente finale deve abilitare la registrazione avanzata per il proprio WorkSpaces client.

2. L'utente finale deve quindi connettersi come al solito, utilizzare il proprio WorkSpace e provare a riprodurre il problema.

3. La registrazione avanzata genera file di log che contengono informazioni di diagnostica e dettagli a livello di debug, inclusi dati dettagliati sulle prestazioni.

Questa impostazione persiste fino a quando non viene disattivata esplicitamente. Dopo che l'utente ha riprodotto correttamente il problema relativo all'accesso dettagliato, questa impostazione deve essere disabilitata, poiché genera file di registro di grandi dimensioni.

Raccolta automatizzata di pacchetti di log lato server per Windows

Lo Get-WorkSpaceLogs.ps1 script è utile per raccogliere rapidamente un pacchetto di log lato server per. Supporto AWS Lo script può essere richiesto Supporto AWS richiedendolo in un caso di supporto:

1. Connect al client o WorkSpace utilizzando Remote Desktop Protocol (RDP).

2. Avvia un prompt dei comandi amministrativo (eseguilo come amministratore).

3. Avvia lo script dal prompt dei comandi con il seguente comando:

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

4. Lo script crea un pacchetto di log sul desktop dell'utente.

   Lo script crea un file zip con le seguenti cartelle:

   • C — Contiene i file di Program Files, Program Files (x86) e Windows relativi a Skylight ProgramData, EC2Config, Teradici, Event Viewer e ai registri di Windows (Panther e altri).

   • CliXML — Contiene file XML che possono essere importati in Powershell utilizzando per il filtraggio interattivo. Import-CliXML Fare riferimento a Import-Clixml.

   • Config: log dettagliati per ogni controllo eseguito

   • ScriptLogs— Registri sull'esecuzione dello script (non rilevanti per l'indagine, ma utili per eseguire il debug di ciò che fa lo script).

   • tmp — Cartella temporanea (dovrebbe essere vuota).

   • Traces — Acquisizione dei pacchetti effettuata durante la raccolta dei log.