Solución de problemas y diagnóstico - AWS Elastic Beanstalk

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 problemas y diagnóstico

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

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 en la Guía del EC2 usuario de Amazon.

Especificar un nombre clave 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 instancia. EC2 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 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.

Acceder a los registros

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 ejecutareb migrate, puede ejecutar el eb logs --zip comando 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 los registros de EC2 las instancias de Amazon en su entorno de Elastic Beanstalk.

Acceder a los artefactos del lado del cliente

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

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

Supervisar el estado del entorno

Elastic Beanstalk le ayuda a monitorear el estado mediante las capacidades mejoradas de monitoreo del estado. Se trata de un sistema automatizado de supervisión 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 instancia y se integra con el registro y las alertas en tiempo real. Elastic Load Balancing (ELB) y Auto Scaling responden de forma dinámica a los cambios en el estado de salud, lo que garantiza una alta disponibilidad y tolerancia a los 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 eb health comando CLI de EB para mostrar el estado del entorno. Se muestra la siguiente información:

  • Estado de una instancia

  • Métricas de respuesta de las aplicaciones

  • Utilización de los recursos del sistema

  • Eventos de implementación recientes

EC2 optimización del rendimiento

De forma predeterminada, eb migrate selecciona el tipo de instancia c5.2xlarge 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 estos factores al seleccionar un tipo de instancia:

  • Requisitos de memoria de sus aplicaciones

  • Requisitos de CPU para procesar cargas de trabajo

  • Necesidades de rendimiento de la red

  • Objetivos de optimización de costos

Configuración de volúmenes de EBS

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

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 Personalizar volúmenes efímeros y de EBS en entornos de Elastic Beanstalk.

Para las aplicaciones con requisitos de almacenamiento elevados, considere 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

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. 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 la siguienteConfiguración personalizada del grupo de aplicaciones.

Evento: errores de configuración del certificado SSL

Si los enlaces HTTPS no funcionan, asegúrese de haber especificado un ARN de certificado ACM válido mediante el parámetro option. eb mibrate --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 AWS CloudFormation los eventos en la consola AWS de administración para ver si hay errores específicos en la creación de recursos. 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

Si encuentra problemas que no puede resolver, AWS Support recopile la siguiente información antes de ponerse en contacto con usted:

  • ID de entorno (eb status)

  • Registros de la aplicación (eb logs --zip)

  • Artefactos de migración de .\migrations\latest\

  • Configuración de IIS de origen (salida deeb migrate explore --verbose)

  • Mensajes de error detallados

Para obtener más información sobre la solución de problemas de Elastic Beanstalk, consulte. Solución de problemas del entorno de Elastic Beanstalk