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á.
# Solução de problemas do AWS Toolkit for Visual Studio
As seções a seguir contêm informações gerais sobre solução de problemas AWS Toolkit for Visual Studio e como trabalhar com AWS os serviços do kit de ferramentas.
**nota**
As informações sobre instalação e set-up-specific solução de problemas estão disponíveis no tópico [Solução de problemas de instalação](https://docs.aws.amazon.com//toolkit-for-visual-studio/latest/user-guide/setup-troubleshoot.html), localizado neste Guia do usuário.
**Topics**
+ [Práticas recomendadas de solução de problemas](#general-troubleshoot-best-practice)
+ [Visualizar e filtrar as verificações de segurança do Amazon Q](#general-troubleshoot-Q-securityscan)
+ [O AWS kit de ferramentas não está instalado corretamente](#general-troubleshoot-component-initilization)
+ [Configurações de firewall e proxy](#general-troubleshoot-firewall)
## Práticas recomendadas de solução de problemas
As práticas recomendadas a seguir são sugeridas para a solução problemas do AWS Toolkit for Visual Studio .
+ Repare o Visual Studio e reinicie o sistema.
+ Tente recriar seu problema ou erro antes de enviar um relatório.
+ Faça anotações detalhadas de cada etapa, configuração e mensagem de erro durante o processo de recriação.
+ Colete registros AWS do kit de ferramentas. Para obter uma descrição detalhada de como localizar seus registros do AWS Toolkit, consulte o procedimento [Como localizar seus AWS registros](#general-troubleshoot-procedure-logs), localizado neste tópico do guia.
+ Verifique se há solicitações abertas, soluções conhecidas ou relate seu problema não resolvido na seção [AWS Toolkit for Visual Studio Problemas](https://github.com/aws/aws-toolkit-visual-studio/issues) do AWS Toolkit for Visual Studio GitHub repositório.
**Reparar o Visual Studio e reiniciar o sistema**
1. Feche todas as instâncias em execução do Visual Studio.
1. No menu Iniciar do Windows, execute o **instalador do Visual Studio**.
1. Execute a ação de reparo nas instalações afetadas do Visual Studio. Isso permitirá que o Visual Studio recompile seu índice de extensões instaladas.
1. Reinicie o Windows antes de reiniciar o Visual Studio.
**Como localizar seus registros do AWS Toolkit**
1. No menu principal do Visual Studio, expanda **Extensões**.
1. Escolha o **AWS kit de ferramentas para expandir o menu do kit** de AWS ferramentas e, em seguida, escolha **Exibir registros do kit de ferramentas**.
1. Quando a pasta de registros do AWS Toolkit abrir em seu sistema operacional, classifique os arquivos por data e localize qualquer arquivo de log que contenha informações relevantes ao seu problema atual.
## Visualizar e filtrar as verificações de segurança do Amazon Q
Para ver as verificações de segurança do Amazon Q no Visual Studio, abra a **Lista de erros** do Visual Studio expandindo o cabeçalho **Exibir** no menu principal do Visual Studio e selecionando **Lista de erros**.
Por padrão, a **Lista de erros do** Visual Studio exibe todos os avisos e erros da sua base de código. Para filtrar as descobertas da verificação de segurança do Amazon Q da **Lista de erros** do Visual Studio, crie um filtro concluindo o procedimento a seguir.
**nota**
As descobertas da verificação de segurança do Amazon Q só ficam visíveis após a execução de uma verificação de segurança e a detecção de problemas.
As descobertas da verificação de segurança do Amazon Q aparecem como avisos no Visual Studio. Para visualizar as descobertas da verificação de segurança do Amazon Q na **Lista de erros**, a opção **Avisos** no cabeçalho da **Lista de erros** deve ser selecionada.
1. No menu principal do Visual Studio, expanda o cabeçalho **Exibir** e selecione **Lista de erros** para abrir o painel **Lista de erros**.
1. No painel **Lista de erros**, clique com o botão direito da linha do cabeçalho e abra o menu de contexto.
1. No menu de contexto, expanda **Mostrar colunas** e selecione **Ferramenta** no menu expandido.
1. A coluna **Ferramenta** é adicionada à sua **Lista de erros**.
1. No cabeçalho da coluna **Ferramenta**, selecione o ícone **Filtro** e escolha Amazon Q para filtrar as descobertas da verificação de segurança do Amazon Q.
## O AWS kit de ferramentas não está instalado corretamente
**Problema:**
Dentro de um minuto após iniciar o Visual Studio, AWS Toolkit for Visual Studio as seguintes mensagens aparecem no painel de saída e na barra de informações, respectivamente:
`Some Toolkit components could not be initialized. Some functionality may not work during this IDE session.`
`The AWS Toolkit is not properly installed.`
**Solução**:
É possível que a atualização ou instalação de uma extensão tenha causado o desaparecimento de alguns dos arquivos de cache internos do Visual Studio out-of-sync. O procedimento a seguir descreve como recompilar esses arquivos na próxima vez que você inicializar o Visual Studio.
**nota**
É possível que essa solução tenha impacto nas suas personalizações do Visual Studio. Depois de concluir esse procedimento, a extensão do AWS Toolkit deve ser listada como instalada e não reportar mais uma mensagem de erro. Se você continuar enfrentando esse problema depois de concluir as etapas a seguir, consulte o [Problema \$1452](https://github.com/aws/aws-toolkit-visual-studio/issues/452) no AWS Toolkit for Visual Studio GitHub repositório para obter informações adicionais.
1. Instale a versão mais recente do Visual Studio 2022.
**nota**
A versão mínima exigida é 17.11.5.
1. Feche todas as instâncias em execução do Visual Studio.
1. No Windows, abra o **Prompt de Comando do Desenvolvedor** como Administrador.
1. No **Prompt de Comando do Desenvolvedor**, execute o comando `devenv /updateconfiguration /resetExtensions` e aguarde sua conclusão.
1. Depois que o comando for concluído, reinicie o Visual Studio.
1. No Visual Studio, a AWS extensão agora está listada como instalada e não relata mais as mensagens de erro listadas na parte superior desse problema.
## Configurações de firewall e proxy
### Solucionar problemas nas configurações de firewall e proxy
O software de verificações de segurança pode interferir na sua capacidade de baixar arquivos dos servidores de linguagens do kit de ferramentas da AWS , removendo arquivos dos downloads ou impedindo completamente os downloads.
Para verificar suas configurações de firewall e proxy, navegue até [https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json](https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json) em um navegador da Internet instalado no mesmo sistema da sua instância do Visual Studio. Se houver um erro ou se a página não carregar, poderá haver um firewall ou filtro de proxy impedindo que você acesse `aws-toolkit-language-servers.amazonaws.com`.
### Certificados personalizados
O AWS Toolkit for Visual Studio utiliza um servidor de linguagem que é executado no tempo de execução do Node.js. Para obter informações detalhadas sobre como verificar se a sua rede usa um certificado personalizado, consulte o tópico [Definições de configuração e arquivo de credenciais na AWS CLI](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html#cli-config-ca_bundle) no Guia do usuário da *AWS Command Line Interface* versão 1.
Para definir configurações de proxy e um certificado, configure a variável de ambiente `HTTPS_PROXY` e crie variáveis de ambiente do Windows para as chaves `NODE_OPTIONS` e `NODE_EXTRA_CA_CERTS`.
Para configurar a variável de ambiente `HTTPS_PROXY`, conclua as etapas a seguir.
1. No menu principal do Visual Studio, selecione **Ferramentas** e **Opções**.
1. No menu **Opções**, expanda **Kit de ferramentas da AWS ** e escolha **Proxy**.
1. No menu **Proxy**, defina o **Host** e a **Porta**.
**nota**
Para obter informações sobre como configurar o a `HTTPS_PROXY` partir do AWS CLI, consulte o AWS CLI tópico [Usando um proxy HTTP](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-proxy.html) no Guia do *AWS Command Line Interface*Usuário.
Crie variáveis de ambiente do Windows para as chaves a seguir.
+ `NODE_OPTIONS = --use-openssl-ca`
+ `NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs`
**nota**
Para saber mais sobre como extrair certificados-raiz corporativos, consulte o artigo [Exportar um certificado com sua chave privada](https://learn.microsoft.com/en-us/windows-server/identity/ad-cs/export-certificate-private-key) em *learn.microsoft.com*. Para obter informações detalhadas sobre as chaves de variáveis de ambiente do Windows, consulte a [documentação do Node.js v23.3.0](https://nodejs.org/api/cli.html#cli_node_extra_ca_certs_file) em *nodejs.org*.
### Permitir listagem e etapas adicionais
Além de interferir nos servidores de linguagem do AWS Toolkit, as configurações do firewall podem impedir que o Amazon Q faça o upload para o Amazon S3 e chame a API do serviço. Para minimizar o potencial desses erros, recomendamos permitir o acesso de saída à internet na **porta 443 (HTTPS)** para os seguintes endpoints:
+ `https://codewhisperer.us-east-1.amazonaws.com/`
+ `https://amazonq-code-transformation-us-east-1-c6160f047e0.s3.amazonaws.com/`
+ `https://aws-toolkit-language-servers.amazonaws.com/`
+ `https://q.us-east-1.amazonaws.com`
+ `https://client-telemetry.us-east-1.amazonaws.com`
+ `https://cognito-identity.us-east-1.amazonaws.com`
+ `https://oidc.us-east-1.amazonaws.com`
Para obter uma lista detalhada dos endpoints, consulte o tópico [Atualizar firewalls e gateways para permitir o acesso](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/endpoints.html) neste Guia do usuário. Para obter informações detalhadas sobre como configurar um proxy corporativo para o Amazon Q, consulte o tópico [Configurar um proxy corporativo no Amazon Q](https://docs.aws.amazon.com//amazonq/latest/qdeveloper-ug/firewall.html#corp-proxy) no *Guia do usuário do Amazon Q Developer*. Se você continuar enfrentando problemas de firewall e proxy, colete os registros do AWS kit de ferramentas e entre em contato com a AWS Toolkit for Visual Studio equipe por meio da seção de [AWS Toolkit for Visual Studio problemas](https://github.com/aws/aws-toolkit-visual-studio/issues) do AWS Toolkit for Visual Studio GitHub repositório. Para obter detalhes sobre como coletar os registros do AWS kit de ferramentas, consulte as informações na seção de **melhores práticas de solução** de problemas deste tópico do Guia do usuário.