

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Coletando um pacote de registros de WorkSpaces suporte para depuração
<a name="collecting-a-workspaces-support-log-bundle-for-debugging"></a>

 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
<a name="wsp-server-side-logs"></a>

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
<a name="changing-log-file-verbosity-windows"></a>

 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](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html#log_verbosity). 

 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. 

1.  Acesse `\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon`. 

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

1.  Acesse `\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP`. 

1.  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` 

1.  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 

1.  Escolha **OK** e feche o Editor do Registro do Windows. 

1.  Reinicie WorkSpace o. 

## Registros do lado do servidor PCoIP
<a name="pcoip-server-side-logs"></a>

 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`

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

1.  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
<a name="webaccess-server-side-logs"></a>

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

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

## Registros do lado do cliente
<a name="client-side-logs"></a>

 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](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html#advanced-logging) para seu WorkSpaces cliente. 

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

1.  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
<a name="automated-server-side-log-bundle-collection-for-windows"></a>

 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). 

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

1.  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"
   ```

1.  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](https://msdn.microsoft.com/en-us/powershell/reference/5.1/microsoft.powershell.utility/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. 