Collecte d'un ensemble de journaux de WorkSpaces support pour le débogage

Lors de la résolution WorkSpaces des problèmes, il est nécessaire de rassembler le bundle de journaux auprès de l'hôte concerné WorkSpace et auprès de l'hôte sur lequel le WorkSpaces client est installé. Il existe deux catégories fondamentales de journaux :

• Journaux côté serveur : dans ce scénario, il s' WorkSpace agit du serveur, ce sont donc des journaux qui vivent sur lui-même. WorkSpace

• Journaux côté client : se connecte à l'appareil que l'utilisateur final utilise pour se connecter au. WorkSpace

• Seuls les clients Windows et macOS rédigent des journaux localement.

• Aucun client et les clients iOS ne se connectent pas.

• Les journaux Android sont chiffrés sur le stockage local et téléchargés automatiquement vers l'équipe d'ingénierie du WorkSpaces client. Seule cette équipe peut consulter les journaux des appareils Android.

Journaux côté serveur du WSP

Tous les composants du WSP écrivent leurs fichiers journaux dans l'un des deux dossiers suivants :

• Emplacement principal : C:\ProgramData\Amazon\WSP\ et C:\ProgramData\NICE\dcv\log\

• Emplacement de l'archive : C:\ProgramData\Amazon\WSP\TRANSMITTED\

Modification de la verbosité des fichiers journaux sous Windows

Vous pouvez configurer le niveau de verbosité du fichier journal pour WSP Windows WorkSpaces à grande échelle en configurant le paramètre de stratégie de groupe au niveau de verbosité du journal.

Pour modifier la verbosité du fichier journal pour un individu WorkSpaces, configurez la h_log_verbosity_options clé à l'aide de l'éditeur de registre Windows :

1. Ouvrez l'Éditeur du Registre Windows en tant qu'administrateur.

2. Accédez à \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon.

3. Si la WSP clé n'existe pas, cliquez avec le bouton droit de la souris, choisissez Nouveau > Clé et nommez-laWSP.

4. Accédez à \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP.

5. Si la h_log_verbosity_options valeur n'existe pas, cliquez avec le bouton droit de la souris, choisissez Nouveau > DWORD et nommez-lah_log_verbosity_options.

6. Cliquez sur le nouveau h_log_verbosity_options DWORD et remplacez la valeur par l'un des nombres suivants en fonction du niveau de verbosité requis :

   • 0 — Erreur

   • 1 — Avertissement

   • 2 — Informations

   • 3 — Déboguer

7. Choisissez OK, puis fermez l'Éditeur du Registre Windows.

8. Redémarrez le WorkSpace.

Journaux côté serveur PCoIP

Tous les composants PCoIP écrivent leurs fichiers journaux dans l'un des deux dossiers suivants :

• Emplacement principal : C:\ProgramData\Teradici\PCoIPAgent\logs

• Emplacement de l'archive : C:\ProgramData\Teradici\logs

Lorsque vous travaillez AWS Support sur un problème complexe, il est parfois nécessaire de mettre l'agent du serveur PCoIP en mode de journalisation détaillée. Pour l'activer, procédez comme suit :

1. Ouvrez la clé de registre suivante : HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Teradici\PCoIP\pcoip_admin_defaults

2. Dans la pcoip_admin_defaults clé, créez le DWORD 32 bits suivant : pcoip.event_filter_mode

3. Définissez la valeur pcoip.event_filter_mode de « 3 » (Dec ou Hex).

À titre de référence, il s'agit des seuils de journalisation qui peuvent être définis dans ce DWORD.

• 0 — (CRITIQUE)

• 1 — (ERREUR)

• 2 — (INFORMATIONS)

• 3 — (Débogage)

Si le pcoip_admin_default DWORD n'existe pas, le niveau de journalisation est défini 2 par défaut. Il est recommandé de restaurer la valeur de 2 dans le DWORD une fois que celui-ci n'a plus besoin de journaux détaillés, car ils sont beaucoup plus volumineux et consomment inutilement de l'espace disque.

WebAccess journaux côté serveur

Pour PCoIP et WSP (version 1.0+) WorkSpaces, le client WorkSpaces Web Access utilise le service STXHD. Les journaux de WorkSpaces Web Access sont stockés à l'adresseC:\ProgramData\Amazon\Stxhd\Logs.

Pour WSP (version 2.0+) WorkSpaces, les journaux de WorkSpaces Web Access sont stockés dans. C:\ProgramData\Amazon\WSP\

Journaux côté client

Ces journaux proviennent du WorkSpaces client auquel l'utilisateur se connecte, ils se trouvent donc sur l'ordinateur de l'utilisateur final. Les emplacements des fichiers journaux pour Windows et Mac sont les suivants :

• 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

Pour aider à résoudre les problèmes que les utilisateurs peuvent rencontrer, activez la journalisation avancée qui peut être utilisée sur n'importe quel WorkSpaces client Amazon. La journalisation avancée est activée pour chaque session client suivante jusqu'à ce qu'elle soit désactivée.

1. Avant de se connecter au WorkSpace, l'utilisateur final doit activer la journalisation avancée pour son WorkSpaces client.

2. L'utilisateur final doit ensuite se connecter comme d'habitude, utiliser le sien et tenter de reproduire le problème. WorkSpace

3. La journalisation avancée génère des fichiers journaux qui contiennent des informations de diagnostic et des détails de niveau débogage, avec notamment des données de performance détaillées.

Ce paramètre est conservé jusqu'à ce qu'il soit explicitement désactivé. Une fois que l'utilisateur a réussi à reproduire le problème lié à la connexion détaillée, ce paramètre doit être désactivé, car il génère des fichiers journaux volumineux.

Collecte automatisée de paquets de journaux côté serveur pour Windows

Le Get-WorkSpaceLogs.ps1 script est utile pour rassembler rapidement un ensemble de journaux côté serveur pour. AWS Support Le script peut être demandé AWS Support en le demandant dans un dossier d'assistance :

1. Connectez-vous à l' WorkSpace aide du client ou du protocole RDP (Remote Desktop Protocol).

2. Lancez une invite de commande administrative (exécutée en tant qu'administrateur).

3. Lancez le script depuis l'invite de commande à l'aide de la commande suivante :

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

4. Le script crée un ensemble de journaux sur le bureau de l'utilisateur.

   Le script crée un fichier zip contenant les dossiers suivants :

   • C — Contient les fichiers provenant de Program Files, Program Files (x86) et Windows relatifs à Skylight ProgramData, EC2Config, Teradici, à l'observateur d'événements et aux journaux Windows (Panther et autres).

   • CliXML — Contient des fichiers XML qui peuvent être importés dans Powershell à des Import-CliXML fins de filtrage interactif. Reportez-vous à Import-Clixml.

   • Config — Journaux détaillés pour chaque vérification effectuée

   • ScriptLogs— Journaux relatifs à l'exécution du script (non pertinents pour l'investigation, mais utiles pour débugger le rôle du script).

   • tmp —Dossier temporaire (il doit être vide).

   • Traces — Capture de paquets effectuée lors de la collecte du journal.