Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# 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](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html#log_verbosity) 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.
1. Navigieren Sie zu `\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon`.
1. 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`.
1. Navigieren Sie zu `\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP`.
1. 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`.
1. 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
1. Klicken Sie auf **OK** und schließen Sie den Windows Registrierungs-Editor.
1. 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`
1. Erstellen Sie im `pcoip_admin_defaults` Schlüssel das folgende 32-Bit-DWORD: `pcoip.event_filter_mode`
1. 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\$1) verwendet WorkSpacesder WorkSpaces Web-Access-Client den STXHD-Service. Die Protokolle für WorkSpaces Web Access werden unter gespeichert`C:\ProgramData\Amazon\Stxhd\Logs`.
Für WSP (Version 2.0\$1) werden WorkSpacesdie Protokolle für WorkSpaces Web Access unter gespeichert`C:\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](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html#advanced-logging). WorkSpaces
1. Der Endbenutzer sollte dann wie gewohnt eine Verbindung herstellen, seine verwenden und versuchen WorkSpace, das Problem zu reproduzieren.
1. 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.
1. Starten Sie eine administrative Eingabeaufforderung (führen Sie als Administrator aus).
1. 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"
```
1. 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](https://msdn.microsoft.com/en-us/powershell/reference/5.1/microsoft.powershell.utility/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.