Sammeln eines WorkSpaces Support-Protokoll-Bundles zum Debuggen

Bei der Behebung von WorkSpaces Problemen ist es erforderlich, das Protokollpaket vom betroffenen WorkSpace und dem Host, auf dem der WorkSpaces Client installiert ist, zu sammeln. Es gibt zwei grundlegende Kategorien von Protokollen:

• Serverseitige Protokolle: Die WorkSpace ist in diesem Szenario der Server, daher handelt es sich um Protokolle, die auf der WorkSpace selbst existieren.

• Clientseitige Protokolle: Protokolliert auf dem Gerät, das der Endbenutzer zum Herstellen einer Verbindung mit dem verwendet WorkSpace.

• Nur Windows- und macOS-Clients schreiben Protokolle lokal.

• Null-Clients und iOS-Clients protokollieren nicht.

• Android-Protokolle werden im lokalen Speicher verschlüsselt und automatisch in das WorkSpaces Client-Engineering-Team hochgeladen. Nur dieses Team kann die Protokolle für Android-Geräte überprüfen.

Serverseitige WSP-Protokolle

Alle WSP-Komponenten schreiben ihre Protokolldateien in einen von zwei Ordnern:

• Primärer Standort: C:\ProgramData\Amazon\WSP\ und C:\ProgramData\NICE\dcv\log\

• Speicherort des Archivs: C:\ProgramData\Amazon\WSP\TRANSMITTED\

Ändern der Ausführlichkeit von Protokolldateien unter Windows

Sie können die Ausführlichkeitsstufe der Protokolldatei für WSP Windows WorkSpaces im großen Maßstab konfigurieren, indem Sie die Gruppenrichtlinieneinstellung für die Ausführlichkeitsstufe der Protokolldatei konfigurieren.

Um die Ausführlichkeit der Protokolldatei für einzelne zu ändern WorkSpaces, konfigurieren Sie den h_log_verbosity_options Schlüssel mit dem Windows-Registrierungs-Editor:

1. Öffnen Sie den Windows-Registrierungseditor als Administrator.

2. Navigieren Sie zu \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon.

3. Wenn der WSP Schlüssel nicht vorhanden ist, klicken Sie mit der rechten Maustaste und wählen Sie Neu > Schlüssel und benennen Sie ihn WSP.

4. Navigieren Sie zu \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP.

5. Wenn der h_log_verbosity_options Wert nicht vorhanden ist, klicken Sie mit der rechten Maustaste und wählen Sie Neu > DWORD und benennen Sie ihn h_log_verbosity_options.

6. Klicken Sie auf das neue h_log_verbosity_options DWORD und ändern Sie den Wert je nach erforderlicher Ausführlichkeitsstufe in eine der folgenden Zahlen:

   • 0 – Fehler

   • 1 – Warnung

   • 2 – Informationen

   • 3 – Debuggen

7. Klicken Sie auf OK und schließen Sie den Windows Registrierungs-Editor.

8. Starten Sie die neu WorkSpace.

Serverseitige PCoIP-Protokolle

Alle PCoIP-Komponenten schreiben ihre Protokolldateien in einen von zwei Ordnern:

• Primärer Standort: C:\ProgramData\Teradici\PCoIPAgent\logs

• Archivspeicherort: C:\ProgramData\Teradici\logs

Wenn Sie mit AWS -Support an einem komplexen Problem arbeiten, ist es manchmal erforderlich, den PCoIP-Server-Agenten in den ausführlichen Protokollierungsmodus zu versetzen. So aktivieren Sie dies:

1. Öffnen Sie den folgenden Registrierungsschlüssel: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Teradici\PCoIP\pcoip_admin_defaults

2. Erstellen Sie im pcoip_admin_defaults Schlüssel das folgende 32-Bit-DWORD: pcoip.event_filter_mode

3. Setzen Sie den Wert für pcoip.event_filter_mode auf „3“ (Dez oder Hex).

Als Referenz sind dies die Protokollschwellenwerte, die in diesem DWORD definiert werden können.

• 0 – (CRITIC)

• 1 – (FEHLER)

• 2 – (INFO)

• 3 – (Debuggen)

Wenn das pcoip_admin_default DWORD nicht vorhanden ist, ist die Protokollebene 2 standardmäßig . Es wird empfohlen, einen Wert von 2 im DWORD wiederherzustellen, nachdem es keine ausführlichen Protokolle mehr benötigt, da sie viel größer sind und unnötig Speicherplatz belegen.

WebAccess serverseitige Protokolle

Für PCoIP und WSP (Version 1.0+) verwendet WorkSpacesder WorkSpaces Web-Access-Client den STXHD-Service. Die Protokolle für WorkSpaces Web Access werden unter gespeichertC:\ProgramData\Amazon\Stxhd\Logs.

Für WSP (Version 2.0+) werden WorkSpacesdie Protokolle für WorkSpaces Web Access unter gespeichertC:\ProgramData\Amazon\WSP\.

Clientseitige Protokolle

Diese Protokolle stammen von dem WorkSpaces Client, mit dem der Benutzer eine Verbindung herstellt, sodass sich die Protokolle auf dem Computer des Endbenutzers befinden. Die Speicherorte der Protokolldateien für Windows und Mac sind:

• 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

Um Probleme zu beheben, die Benutzer möglicherweise haben, aktivieren Sie die erweiterte Protokollierung, die auf jedem Amazon- WorkSpaces Client verwendet werden kann. Die erweiterte Protokollierung ist für jede nachfolgende Clientsitzung aktiviert, bis sie deaktiviert ist.

1. Bevor der Endbenutzer eine Verbindung mit dem herstellt WorkSpace, sollte er die erweiterte Protokollierung für seinen Client aktivieren. WorkSpaces

2. Der Endbenutzer sollte dann wie gewohnt eine Verbindung herstellen, seine verwenden und versuchen WorkSpace, das Problem zu reproduzieren.

3. Die erweiterte Protokollierung erstellt Protokolldateien mit Diagnoseinformationen und Details auf Debugging-Ebene, einschließlich Verbose-Leistungsdaten.

Diese Einstellung bleibt bestehen, bis sie explizit deaktiviert wird. Nachdem der Benutzer das Problem mit der ausführlichen Protokollierung erfolgreich reproduziert hat, sollte diese Einstellung deaktiviert werden, da große Protokolldateien generiert werden.

Automatisierte serverseitige Protokollpaketerfassung für Windows

Das Get-WorkSpaceLogs.ps1 Skript ist hilfreich, um schnell ein serverseitiges Protokollpaket für zu sammeln AWS -Support. Das Skript kann von angefordert werden, AWS -Support indem es in einem Support-Fall angefordert wird:

1. Stellen Sie WorkSpace über den Client oder über das Remote Desktop Protocol (RDP) eine Verbindung mit dem her.

2. Starten Sie eine administrative Eingabeaufforderung (führen Sie als Administrator aus).

3. Starten Sie das Skript über die Eingabeaufforderung mit dem folgenden Befehl:

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

4. Das Skript erstellt ein Protokollpaket auf dem Desktop des Benutzers.

   Das Skript erstellt eine ZIP-Datei mit den folgenden Ordnern:

   • C – Enthält die Dateien aus Programmdateien, Programmdateien (x86) und Windows ProgramDataim Zusammenhang mit Bollight, EC2Config, Teradici, Event Viewer und Windows-Protokollen (Panther und andere).

   • CliXML – Enthält XML-Dateien, die in Powershell importiert werden können, indem Import-CliXML für die interaktive Filterung verwendet wird. Weitere Informationen finden Sie unter Import-Clixml.

   • Config – Detaillierte Protokolle für jede durchgeführte Prüfung

   • ScriptLogs – Protokolliert die Skriptausführung (nicht relevant für die Untersuchung, aber nützlich, um zu debuggen, was das Skript macht).

   • tmp – Vorübergehender Ordner (er sollte leer sein).

   • Ablaufverfolgungen – Die Paketerfassung wurde während der Protokollerfassung durchgeführt.