

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Solución de los problemas y diagnóstico
<a name="dotnet-migrating-applications-troubleshooting"></a>

**Pruebe la CLI de Amazon Q Developer para solucionar problemas con ayuda de la IA**  
 La CLI de Amazon Q Developer puede ayudarle a solucionar rápidamente los problemas de entorno. La CLI de Q permite solucionar problemas comprobando el estado del entorno, revisando eventos, analizando registros y formulando preguntas aclaratorias. Para obtener más información y tutoriales detallados, consulte [Solución de problemas de entornos de Elastic Beanstalk con Amazon](https://aws.amazon.com/blogs/devops/troubleshooting-elastic-beanstalk-environments-with-amazon-q-developer-cli/) Q Developer CLI en los blogs. AWS 

En esta sección se proporciona orientación para solucionar problemas comunes que pueden surgir durante la migración de aplicaciones de IIS a Elastic Beanstalk.

## Asociación de un par de claves a su entorno EC2
<a name="dotnet-migrating-applications-troubleshooting-keypair"></a>

Puede iniciar sesión de forma segura en las instancias de Amazon Elastic Compute Cloud (Amazon EC2) aprovisionadas para su aplicación de Elastic Beanstalk con un par de claves de Amazon. EC2 Para obtener instrucciones sobre cómo crear un par de claves, consulta [Cómo crear un par de claves con Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#having-ec2-create-your-key-pair) en la *Guía del EC2 usuario de Amazon*.

Especificar un nombre clave para **eb migrate** tiene el efecto de asociar el entorno de Elastic Beanstalk al par de claves. Por motivos de seguridad, esto no abrirá el puerto 3389 en el grupo de seguridad de la EC2 instancia. Puede asociar grupos de EC2 seguridad adicionales que permitan el tráfico en el puerto 3389 **eb config** después de la migración inicial.

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

Cuando creas un par de claves, Amazon EC2 almacena una copia de tu clave pública. Si ya no necesitas usarlo para conectarte a ninguna instancia del entorno, puedes eliminarlo de Amazon EC2. Para obtener más información, [consulta Eliminar un par de claves](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#delete-key-pair) en la *Guía del EC2 usuario de Amazon*.

Para obtener más información sobre cómo conectarse a EC2 instancias de Amazon de Windows, consulte [Conexión a Windows Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connecting_to_windows_instance.html).

## Acceso a los registros
<a name="dotnet-migrating-applications-troubleshooting-logs"></a>

La CLI de EB proporciona **eb logs** una función que puede utilizar para recuperar registros de un entorno de Elastic Beanstalk sin iniciar sesión en sus instancias. EC2 Tras ejecutar **eb migrate**, puede ejecutar el comando **eb logs --zip** que descargará y guardará los registros en el directorio `.elasticbeanstalk\logs`.

Como alternativa, puede ver los registros a través de la consola de AWS Elastic Beanstalk. Para obtener más información, consulte [Visualización de registros de instancias de Amazon EC2 en su entorno de Elastic Beanstalk](using-features.logging.md).

## Acceso a los artefactos del cliente
<a name="dotnet-migrating-applications-troubleshooting-artifacts"></a>

El comando **eb migrate** almacena los registros de aplicaciones y errores generados por los directorios internos de artefactos de migración de **msdeploy**.

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

## Monitoreo del estado del entorno
<a name="dotnet-migrating-applications-troubleshooting-health"></a>

Elastic Beanstalk le permite monitorear el estado mediante las capacidades mejoradas de monitoreo del estado. Se trata de un sistema automatizado de monitoreo del estado que realiza un seguimiento continuo del estado operativo de las instancias de la aplicación y aprovecha las métricas integradas, como la utilización de la CPU, la latencia, el recuento de solicitudes y los códigos de respuesta.

El sistema de monitoreo del estado utiliza un enfoque basado en agentes para recopilar datos a nivel de la instancia y se integra con el registro y las alertas en tiempo real. Elastic Load Balancing (ELB) y el escalado automático responden de forma dinámica a los cambios en el estado, lo que garantiza una alta disponibilidad y tolerancia a errores. Los modos de monitoreo avanzados, que incluyen informes de estado mejorados, proporcionan una visibilidad detallada del comportamiento de las aplicaciones, lo que permite la resolución proactiva de problemas y los mecanismos de recuperación automática.

Ejecute el comando **eb health** de la CLI de EB para mostrar el estado del entorno. Se muestra la siguiente información:
+ Estado de una instancia
+ Métricas de respuesta de la aplicación
+ Utilización de recursos del sistema
+ Eventos recientes de implementación

## EC2 optimización del rendimiento
<a name="dotnet-migrating-applications-troubleshooting-performance"></a>

De forma predeterminada, **eb migrate** selecciona el tipo de instancia [c5.2xlarge](https://aws.amazon.com/ec2/instance-types/c5/) para ofrecer una experiencia óptima por primera vez con Elastic Beanstalk. Puede anular este comportamiento con el argumento **--instance-type**:

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

Para los entornos de producción, tenga en cuenta los siguientes factores a la hora de seleccionar un tipo de instancia:
+ Requisitos de memoria de sus aplicaciones
+ Requisitos de CPU para procesar las cargas de trabajo
+ Necesidades de rendimiento de la red
+ Objetivos de optimización de costos

## Configuración del volumen de EBS
<a name="dotnet-migrating-applications-troubleshooting-ebs"></a>

De forma predeterminada, Elastic Beanstalk creará solo un volumen de dispositivo de bloques raíz (`C:\`) para su entorno. Puede transferir volúmenes de instantáneas adicionales a Amazon Elastic Block Store con la opción **--ebs-snapshots**:

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

Para ver ejemplos de cómo configurar las asignaciones de dispositivos de bloques con Elastic Beanstalk, consulte el artículo del blog [Customize Ephemeral and EBS Volumes in Elastic Beanstalk Environments](https://aws.amazon.com/blogs/devops/customize-ephemeral-and-ebs-volumes-in-elastic-beanstalk-environments/).

Para las aplicaciones con requisitos de almacenamiento elevados, tenga en cuenta las siguientes opciones:
+ Uso de volúmenes de EBS para datos persistentes
+ Implementación de Amazon S3 para contenido estático
+ Uso de Amazon FSx for Windows File Server para sistemas de archivos compartidos

## Problemas y soluciones comunes de
<a name="dotnet-migrating-applications-troubleshooting-common"></a>

**Evento:** *falta la instalación de Web Deploy*

Si encuentra errores relacionados con la falta de localización de Web Deploy, instale Web Deploy 3.6 o una versión posterior desde el [instalador de la plataforma web de Microsoft](https://www.iis.net/downloads/microsoft/web-deploy). En el siguiente ejemplo, se muestra un posible mensaje de error.

```
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 permisos durante la migración*

Si encuentra errores relacionados con los permisos, asegúrese de ejecutar la CLI de EB con privilegios administrativos. En el siguiente ejemplo, se muestra un posible mensaje de error.

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

**Evento:** *problemas de identidad del grupo de aplicaciones*

Si la aplicación no se puede iniciar debido a problemas de identidad del grupo de aplicaciones, cree un script personalizado para configurar las identidades del grupo de aplicaciones, tal y como se muestra en [Configuración personalizada del grupo de aplicaciones](dotnet-migrating-applications-advanced-scenarios.md#dotnet-migrating-applications-advanced-scenarios-apppool).

**Evento:** *errores de configuración del certificado SSL*

Si los enlaces HTTPS no funcionan, asegúrese de haber especificado un ARN de certificado de ACM válido mediante la opción **eb mibrate** del parámetro `--ssl-certificates`.

**Evento:** *tiempo de espera para la creación del entorno*

Si se agota el tiempo de espera para la creación del entorno, compruebe si hay errores específicos en la creación de recursos en los CloudFormation eventos de la consola de AWS administración. Entre las causas más comunes se incluyen los problemas de configuración de la VPC o los límites de servicio.

## Cómo obtener asistencia
<a name="dotnet-migrating-applications-troubleshooting-support"></a>

Si encuentra problemas que no puede resolver, AWS Support recopile la siguiente información antes de ponerse en contacto con usted:
+ ID del entorno (`eb status`)
+ Registros de aplicaciones (`eb logs --zip`)
+ Artefactos de migración de `.\migrations\latest\`
+ Configuración de IIS de origen (salida de `eb migrate explore --verbose`)
+ Mensajes de error detallados

Para obtener más información acerca de la solución de errores de Elastic Beanstalk, consulte [Solución de problemas del entorno de Elastic Beanstalk](troubleshooting.md).