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 e diagnóstico
<a name="dotnet-migrating-applications-troubleshooting"></a>

**Experimente a Amazon Q Developer CLI para solução de problemas assistida por IA**  
 A Amazon Q Developer CLI pode ajudar a solucionar problemas de ambiente rapidamente. A Q CLI fornece soluções verificando o status do ambiente, analisando eventos, analisando logs e fazendo perguntas esclarecedoras. Para obter mais informações e orientações detalhadas, consulte Solução de problemas de [ambientes do Elastic Beanstalk com o Amazon](https://aws.amazon.com/blogs/devops/troubleshooting-elastic-beanstalk-environments-with-amazon-q-developer-cli/) Q Developer CLI nos blogs. AWS 

Esta seção fornece orientação para solucionar problemas comuns que podem surgir durante a migração de aplicações IIS para o Elastic Beanstalk.

## Associando um EC2 par de chaves ao seu ambiente
<a name="dotnet-migrating-applications-troubleshooting-keypair"></a>

Você pode fazer login com segurança nas instâncias do Amazon Elastic Compute Cloud (Amazon EC2) provisionadas para seu aplicativo Elastic Beanstalk com um par de chaves da Amazon. EC2 Para obter instruções sobre como criar um par de chaves, consulte [Como criar um par de chaves usando a Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#having-ec2-create-your-key-pair) no *Guia EC2 do usuário da Amazon*.

Especificar um nome de chave para **eb migrate** tem o efeito de fazer seu ambiente Elastic Beanstalk estar associado ao par de chaves. Por motivos de segurança, isso não abrirá a porta 3389 no grupo de segurança de suas EC2 instâncias. Você pode associar grupos EC2 de segurança adicionais que permitam o tráfego na porta 3389 até **eb config** depois da migração inicial.

```
PS C:\migrations_workspace> eb migrate  `
    --keyname "my-keypair"  `
    --verbose
```

Quando você cria um par de chaves, a Amazon EC2 armazena uma cópia da sua chave pública. Se você não precisar mais usá-lo para se conectar a nenhuma instância do ambiente, poderá excluí-lo da Amazon EC2. Para obter detalhes, consulte [Excluindo seu par de chaves](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#delete-key-pair) no *Guia do EC2 usuário da Amazon*.

Para obter mais informações sobre como se conectar às EC2 instâncias do Windows Amazon, consulte [Conectando-se à instância do Windows](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connecting_to_windows_instance.html).

## Acesso a logs
<a name="dotnet-migrating-applications-troubleshooting-logs"></a>

O EB CLI fornece um **eb logs** recurso que você pode usar para recuperar registros de um ambiente do Elastic Beanstalk sem fazer login em suas instâncias. EC2 Após a execução de **eb migrate**, você pode emitir o comando **eb logs --zip** que baixará e salvará os logs no diretório `.elasticbeanstalk\logs`.

Como alternativa, você pode visualizar os registros por meio do console do AWS Elastic Beanstalk. Para obter mais informações, consulte [Visualizar logs de instâncias do Amazon EC2 no ambiente do Elastic Beanstalk](using-features.logging.md).

## Acessar artefatos no lado do cliente
<a name="dotnet-migrating-applications-troubleshooting-artifacts"></a>

O comando **eb migrate** armazena registros de aplicações e erros gerados por **msdeploy** dentro de diretórios de artefatos de migração internos.

```
./migrations/
├── latest -> migration_20240308_123456/
└── migration_20240308_123456/
    ├── application.log
    ├── error.log
    └── upload_target\
```

## Monitorar a integridade do ambiente
<a name="dotnet-migrating-applications-troubleshooting-health"></a>

O Elastic Beanstalk ajuda você a monitorar a integridade usando os recursos aprimorados de monitoramento da integridade. É um sistema automatizado de monitoramento de integridade que rastreia continuamente o status operacional de instâncias de aplicaçãos, aproveitando métricas integradas, como utilização da CPU, latência, contagem de solicitações e códigos de resposta.

O sistema de monitoramento de integridade utiliza uma abordagem baseada em agentes para coletar dados em nível de instância e se integra com logs e alertas em tempo real. O Elastic Load Balancing (ELB) e o Auto Scaling respondem dinamicamente às mudanças no status de integridade, garantindo alta disponibilidade e tolerância a falhas. Os modos avançados de monitoramento, incluindo relatórios de integridade aprimorados, fornecem visibilidade granular do comportamento da aplicação, permitindo a solução proativa de problemas e mecanismos de recuperação automática.

Execute o comando **eb health** da EB CLI para exibir a integridade do ambiente. A informação a seguir será exibida.
+ Status de integridade da instância
+ Métricas de resposta da aplicação
+ Utilização dos recursos do sistema
+ Eventos recentes de implantação

## EC2 otimização de desempenho
<a name="dotnet-migrating-applications-troubleshooting-performance"></a>

Por padrão, **eb migrate** seleciona o tipo de instância [c5.2xlarge](https://aws.amazon.com/ec2/instance-types/c5/) para fornecer uma ótima experiência inicial com o Elastic Beanstalk. É possível substituir esse comportamento pelo argumento **--instance-type**:

```
PS C:\migrations_workspace> eb migrate `
    --instance-type "t3.large"
```

Em ambientes de produção, considere os seguintes fatores ao selecionar um tipo de instância:
+ Requisitos de memória das suas aplicações
+ Requisitos de CPU para processar workloads
+ Necessidades de performance da rede
+ Metas de otimização de custos

## Configuração de volumes do EBS
<a name="dotnet-migrating-applications-troubleshooting-ebs"></a>

Por padrão, o Elastic Beanstalk criará somente um volume de dispositivo de bloco raiz (`C:\`) para seu ambiente. Você pode transmitir volumes adicionais de snapshot do Amazon Elastic Block Store com a opção **--ebs-snapshots**:

```
PS C:\migrations_workspace> eb migrate `
    --ebs-snapshots "snap-123456789abc"
```

Para ver exemplos de como configurar mapeamentos de dispositivos de blocos com o Elastic Beanstalk, consulte o artigo do blog [Personalizar volumes efêmeros e do EBS em ambientes do Elastic Beanstalk](https://aws.amazon.com/blogs/devops/customize-ephemeral-and-ebs-volumes-in-elastic-beanstalk-environments/).

Para aplicações com altos requisitos de armazenamento, considere as seguintes opções:
+ Usar volumes do EBS para dados persistentes
+ Implementar o Amazon S3 para conteúdo estático
+ Usando o Amazon FSx para Windows File Server para sistemas de arquivos compartilhados

## Problemas e soluções comuns de
<a name="dotnet-migrating-applications-troubleshooting-common"></a>

**Evento:** *Instalação ausente do Web Deploy*

Se você encontrar erros relacionados ao Web Deploy não ser encontrado, instale o Web Deploy 3.6 ou posterior a partir do [Microsoft Web Platform Installer](https://www.iis.net/downloads/microsoft/web-deploy). O exemplo a seguir exibe uma possível mensagem de erro.

```
Couldn't find msdeploy.exe. Follow instructions here: https://learn.microsoft.com/en-us/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy
```

**Evento:** *problemas de permissão durante a migração*

Se você encontrar erros relacionados à permissão, verifique se está executando a EB CLI com privilégios administrativos. O exemplo a seguir exibe uma possível mensagem de erro.

```
[ERROR] Access to the path 'C:\inetpub\wwwroot\web.config' is denied.
```

**Evento:** *problemas de identidade do grupo de aplicações*

Se a aplicação falhar ao iniciar devido a problemas de identidade do grupo de aplicações, crie um script personalizado para configurar as identidades do grupo de aplicações, conforme mostrado em [Configurações personalizadas do grupo de aplicações](dotnet-migrating-applications-advanced-scenarios.md#dotnet-migrating-applications-advanced-scenarios-apppool).

**Evento:** *Erros de configuração do certificado SSL*

Se associações HTTPS não funcionarem, certifique-se de ter especificado um ARN de certificado do ACM válido utilizando o parâmetro `--ssl-certificates` da opção **eb mibrate**.

**Evento:** *Tempo limite para criação do ambiente*

Se a criação do ambiente expirar, verifique se há falhas específicas na criação de recursos nos CloudFormation eventos no AWS Management Console. As causas comuns incluem problemas de configuração da VPC ou limites de serviços.

## Obter suporte
<a name="dotnet-migrating-applications-troubleshooting-support"></a>

Se você encontrar problemas que não consegue resolver, antes de entrar em contato, AWS Support colete as seguintes informações:
+ ID do ambiente (`eb status`)
+ Registros do aplicativo (`eb logs --zip`)
+ Artefatos de migração de `.\migrations\latest\`
+ Configuração do IIS de origem (saída de `eb migrate explore --verbose`)
+ Mensagens de erro detalhadas

Para obter mais informações sobre solução de problemas com o Elastic Beanstalk, consulte [Solucionar problemas com o ambiente Elastic Beanstalk](troubleshooting.md).