Coletando um pacote de registros de WorkSpaces suporte para depuração

Ao solucionar WorkSpaces problemas, é necessário reunir o pacote de registros do host afetado WorkSpace e do host em que o WorkSpaces cliente está instalado. Há duas categorias fundamentais de registros:

• Registros do lado do servidor: WorkSpace é o servidor nesse cenário, portanto, esses são registros que residem nele mesmo. WorkSpace

• Registros do lado do cliente: Registros no dispositivo que o usuário final está usando para se conectar ao. WorkSpace

• Somente clientes Windows e macOS gravam registros localmente.

• Clientes zero e clientes iOS não se registram.

• Os registros do Android são criptografados no armazenamento local e enviados automaticamente para a equipe de engenharia WorkSpaces do cliente. Somente essa equipe pode revisar os registros dos dispositivos Android.

Registros do lado do servidor do WSP

Todos os componentes do WSP gravam seus arquivos de log em uma das duas pastas:

• Localização principal: C:\ProgramData\Amazon\WSP\ e C:\ProgramData\NICE\dcv\log\

• Local de arquivamento: C:\ProgramData\Amazon\WSP\TRANSMITTED\

Alterando a verbosidade do arquivo de log no Windows

Você pode configurar o nível de detalhamento do arquivo de log para Windows do WSP WorkSpaces em grande escala definindo a configuração da Política de Grupo do nível de detalhamento do log.

Para alterar a verbosidade do arquivo de log para um indivíduo WorkSpaces, configure a h_log_verbosity_options chave usando o Editor do Registro do Windows:

1. Abra o Editor do registro do Windows como administrador.

2. Acesse \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon.

3. Se a WSP chave não existir, clique com o botão direito do mouse e escolha Novo > Chave e dê um nome a elaWSP.

4. Acesse \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP.

5. Se o h_log_verbosity_options valor não existir, clique com o botão direito do mouse e escolha Novo > DWORD e dê um nome a ele. h_log_verbosity_options

6. Clique no novo h_log_verbosity_options DWORD e altere o Valor para um dos seguintes números, dependendo do nível de detalhamento necessário:

   • 0 — Erro

   • 1 — Advertência

   • 2 — Informações

   • 3 — Depurar

7. Escolha OK e feche o Editor do Registro do Windows.

8. Reinicie WorkSpace o.

Registros do lado do servidor PCoIP

Todos os componentes do PCoIP gravam seus arquivos de log em uma das duas pastas:

• Localização principal: C:\ProgramData\Teradici\PCoIPAgent\logs

• Local de arquivamento: C:\ProgramData\Teradici\logs

Às vezes, ao AWS Support trabalhar com um problema complexo, é necessário colocar o agente do servidor PCoIP no modo de registro detalhado. Para habilitar isso:

1. Abra a seguinte chave de registro: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Teradici\PCoIP\pcoip_admin_defaults

2. Na pcoip_admin_defaults chave, crie o seguinte DWORD de 32 bits: pcoip.event_filter_mode

3. Defina o valor pcoip.event_filter_mode para “3” (Dec ou Hex).

Para referência, esses são os limites de log que podem ser definidos neste DWORD.

• 0 — (CRÍTICO)

• 1 — (ERRO)

• 2 — (INFORMAÇÕES)

• 3 — (Depuração)

Se o pcoip_admin_default DWORD não existir, o nível do log será, 2 por padrão. É recomendável restaurar um valor de 2 para o DWORD depois que ele não precisar mais de registros detalhados, pois eles são muito maiores e consumirão espaço em disco desnecessariamente.

WebAccess registros do lado do servidor

Para PCoIP e WSP (versão 1.0+) WorkSpaces, o cliente WorkSpaces Web Access usa o serviço STXHD. Os registros do WorkSpaces Web Access são armazenados emC:\ProgramData\Amazon\Stxhd\Logs.

Para o WSP (versão 2.0+) WorkSpaces, os registros do WorkSpaces Web Access são armazenados em. C:\ProgramData\Amazon\WSP\

Registros do lado do cliente

Esses registros vêm do WorkSpaces cliente ao qual o usuário se conecta, então os registros estão no computador do usuário final. Os locais dos arquivos de log para Windows e Mac são:

• 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 ajudar a solucionar problemas que os usuários possam enfrentar, ative o registro avançado que pode ser usado em qualquer WorkSpaces cliente da Amazon. O registro avançado é ativado para cada sessão subseqüente do cliente até que seja desativado.

1. Antes de se conectar ao WorkSpace, o usuário final deve habilitar o registro avançado para seu WorkSpaces cliente.

2. O usuário final deve então se conectar normalmente, usar o deles WorkSpace e tentar reproduzir o problema.

3. O registro em log avançado gera arquivos de log que contêm informações de diagnóstico e detalhes no nível da depuração, incluindo dados de desempenho detalhados.

Essa configuração persiste até que seja explicitamente desativada. Depois que o usuário reproduzir com êxito o problema com o login detalhado, essa configuração deverá ser desativada, pois gera arquivos de log grandes.

Coleção automatizada de pacotes de registros do lado do servidor para Windows

O Get-WorkSpaceLogs.ps1 script é útil para reunir rapidamente um pacote de registros do lado do servidor para. AWS Support O script pode ser solicitado AWS Support solicitando-o em um caso de suporte:

1. Conecte-se ao WorkSpace usando o cliente ou usando o Remote Desktop Protocol (RDP).

2. Inicie um prompt de comando administrativo (executado como administrador).

3. Inicie o script a partir do prompt de comando com o seguinte comando:

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

4. O script cria um pacote de registros na área de trabalho do usuário.

   O script cria um arquivo zip com as seguintes pastas:

   • C — Contém os arquivos de Arquivos de Programas, Arquivos de Programas (x86) e Windows relacionados ao Skylight ProgramData, EC2Config, Teradici, Visualizador de eventos e registros do Windows (Panther e outros).

   • CliXML — contém arquivos XML que podem ser importados no Powershell usando Import-CliXML para filtragem interativa. Consulte Import-Clixml.

   • Config — Registros detalhados para cada verificação que é realizada

   • ScriptLogs— Registros sobre a execução do script (não relevantes para a investigação, mas úteis para depurar o que o script faz).

   • tmp — Pasta temporária (deve estar vazia).

   • Traços — Captura de pacotes feita durante a coleta de registros.