Recopilación de un paquete de registros de WorkSpaces soporte para la depuración

Al solucionar WorkSpaces problemas, es necesario recopilar el paquete de registros del afectado WorkSpace y del host en el que está instalado el WorkSpaces cliente. Existen dos categorías fundamentales de registros:

• Registros del lado del servidor: El WorkSpace es el servidor en este escenario, por lo que se trata de registros que residen en sí mismos. WorkSpace

• Registros del lado del cliente: se registran en el dispositivo que el usuario final está utilizando para conectarse al. WorkSpace

• Solo los clientes de Windows y macOS escriben registros localmente.

• Los clientes cero y los clientes iOS no registran.

• Los registros de Android se cifran en el almacenamiento local y se cargan automáticamente al equipo de ingeniería del WorkSpaces cliente. Solo ese equipo puede revisar los registros de los dispositivos Android.

Registros del lado del servidor WSP

Todos los componentes del WSP escriben sus archivos de registro en una de estas dos carpetas:

• Ubicación principal: C:\ProgramData\Amazon\WSP\ y C:\ProgramData\NICE\dcv\log\

• Ubicación del archivo: C:\ProgramData\Amazon\WSP\TRANSMITTED\

Cambiar la verbosidad del archivo de registro en Windows

Puede configurar el nivel de verbosidad del archivo de registro para WSP Windows a escala configurando la configuración de política de grupo del WorkSpaces nivel de verbosidad del registro.

Para cambiar la verbosidad del archivo de registro individual WorkSpaces, configure la clave mediante el Editor del h_log_verbosity_options Registro de Windows:

1. Abra el Editor del Registro de Windows como administrador.

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

3. Si la WSP clave no existe, haga clic con el botón derecho del ratón y seleccione Nuevo > Clave y asígnele un nombre. WSP

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

5. Si el h_log_verbosity_options valor no existe, haga clic con el botón derecho del ratón y seleccione Nuevo > DWORD y asígnele un h_log_verbosity_options nombre.

6. Haga clic en el nuevo h_log_verbosity_options DWORD y cambie el valor a uno de los siguientes números en función del nivel de verbosidad requerido:

   • 0 — Error

   • 1 — Advertencia

   • 2 — Información

   • 3 — Depurar

7. Haga clic en Aceptar y cierre el Editor del Registro de Windows.

8. Reinicie el WorkSpace.

Registros del lado del servidor PCoIP

Todos los componentes del PCoIP escriben sus archivos de registro en una de estas dos carpetas:

• Ubicación principal: C:\ProgramData\Teradici\PCoIPAgent\logs

• Ubicación del archivo: C:\ProgramData\Teradici\logs

A veces, cuando se trabaja con AWS Support un problema complejo, es necesario poner el agente del servidor PCoIP en modo de registro detallado. Para habilitar esto:

1. Abra la siguiente clave de registro: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Teradici\PCoIP\pcoip_admin_defaults

2. En la pcoip_admin_defaults clave, cree el siguiente DWORD de 32 bits: pcoip.event_filter_mode

3. Establezca el valor de pcoip.event_filter_mode en «3» (Dec o Hex).

Como referencia, estos son los umbrales de registro que se pueden definir en este DWORD.

• 0 — (CRÍTICO)

• 1 — (ERROR)

• 2 — (INFORMACIÓN)

• 3 — (Depurar)

Si el pcoip_admin_default DWORD no existe, el nivel de registro es el 2 predeterminado. Se recomienda restaurar el valor de 2 DWORD cuando ya no necesite registros detallados, ya que son mucho más grandes y consumirán espacio en disco innecesariamente.

WebAccess registros del lado del servidor

Para PCoIP y WSP (versión 1.0+) WorkSpaces, el cliente de acceso WorkSpaces web utiliza el servicio STXHD. Los registros del acceso web se almacenan en WorkSpaces . C:\ProgramData\Amazon\Stxhd\Logs

En el caso de WSP (versión 2.0+) WorkSpaces, los registros de WorkSpaces Web Access se almacenan en. C:\ProgramData\Amazon\WSP\

Registros del lado del cliente

Estos registros provienen del WorkSpaces cliente con el que se conecta el usuario, por lo que se encuentran en el ordenador del usuario final. Las ubicaciones de los archivos de registro para Windows y Mac son:

• 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

Para ayudar a solucionar los problemas que puedan experimentar los usuarios, habilita el registro avanzado que se puede utilizar en cualquier WorkSpaces cliente de Amazon. El registro avanzado está habilitado para cada sesión posterior del cliente hasta que se desactiva.

1. Antes de conectarse a WorkSpace, el usuario final debe habilitar el registro avanzado para su WorkSpaces cliente.

2. A continuación, el usuario final debe conectarse como de costumbre WorkSpace, utilizar el suyo e intentar reproducir el problema.

3. El registro avanzado genera archivos de registro que contienen información de diagnóstico y detalles de depuración, incluidos datos detallados de rendimiento.

Esta configuración se mantiene hasta que se desactive de forma explícita. Una vez que el usuario haya reproducido correctamente el problema con el inicio de sesión detallado, esta configuración debe deshabilitarse, ya que genera archivos de registro de gran tamaño.

Recopilación automática de paquetes de registros del lado del servidor para Windows

El Get-WorkSpaceLogs.ps1 script es útil para recopilar rápidamente un paquete de registros del lado del servidor para. AWS Support Se puede solicitar el script AWS Support solicitándolo en un caso de soporte:

1. Conéctese al WorkSpace mediante el cliente o mediante el Protocolo de escritorio remoto (RDP).

2. Inicie una línea de comandos administrativa (ejecútela como administrador).

3. Inicie el script desde la línea de comandos con el siguiente comando:

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

4. El script crea un paquete de registros en el escritorio del usuario.

   El script crea un archivo zip con las siguientes carpetas:

   • C: contiene los archivos de programa, archivos de programa (x86) y Windows relacionados con Skylight ProgramData, EC2Config, Teradici, el visor de eventos y los registros de Windows (Panther y otros).

   • CliXML: contiene archivos XML que se pueden importar a Powershell mediante el filtrado interactivo. Import-CliXML Consulte Import-Clixml.

   • Config: registros detallados de cada comprobación que se realiza

   • ScriptLogs— Registros sobre la ejecución del script (no son relevantes para la investigación, pero son útiles para depurar lo que hace el script).

   • tmp —Carpeta temporal (debe estar vacía).

   • Rastros: la captura de paquetes se realiza durante la recopilación de registros.