Solución de los 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 los problemas y diagnóstico

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

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

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

Acceso a los artefactos del cliente

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

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. El ELB (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 fallos. 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

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

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.

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

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 Configuració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 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

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.