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.

Visualización de los registros de implementación de un entorno de Elastic Beanstalk

Elastic Beanstalk genera un registro de implementación para cada implementación en su entorno. El registro de implementación proporciona una vista cronológica consolidada de lo que ocurrió durante una implementación, incluida la instalación de las dependencias, el resultado de la compilación, el inicio de la aplicación y cualquier error encontrado. Puede usar los registros de implementación para diagnosticar rápidamente las implementaciones fallidas sin necesidad de utilizar SSH en las instancias ni correlacionar varios archivos de registro.

Los registros de implementación se escriben en cada instancia de forma local. En el caso de las implementaciones activadas mediante la consola, la CLI, la API o las actualizaciones gestionadas, una instancia carga su registro de forma continua en Amazon S3 durante la implementación. La consola de Elastic Beanstalk lee el registro de Amazon S3 para que pueda supervisar el progreso sin necesidad de conectarse a la instancia.

Los registros de implementación están diseñados para ser concisos. En caso de éxito, el registro muestra solo los mensajes resumidos (por ejemplo, qué comandos se ejecutaron y qué se completaron). En caso de error, el registro incluye hasta 50 líneas de salida del paso fallido, para que pueda ver el error sin tener que revisar los resultados detallados.

Operaciones admitidas

Los registros de implementación se generan para las siguientes operaciones:

Las operaciones que no modifican el estado de la aplicación o la configuración de las instancias, como la solicitud de registros, el intercambio o la actualización de etiquetas CNAMEs, no generan registros de implementación.

Contenido del registro de implementación

Un registro de implementación captura la siguiente información durante una implementación:

Cuando se produce un error en un paso de implementación, el registro lo marca con un máximo de 50 líneas de salida del paso fallido [ERROR] e incluye hasta 50 líneas de salida. Si el registro de implementación no contiene suficientes detalles, puedes recuperar los registros completos de la instancia (incluidos eb-engine.log los registros de las aplicaciones y los de las aplicaciones) desde la pestaña Registros. eb-hooks.log Para obtener más información, consulte Visualización de registros de instancias de Amazon EC2 en su entorno de Elastic Beanstalk.

Ver los registros de implementación en la consola

La consola de Elastic Beanstalk incluye una pestaña Implementaciones en el panel del entorno en la que puede ver el historial y los registros de las implementaciones.

Visualización del historial de despliegues

Cuando hay una implementación en curso, la pestaña sondea automáticamente las actualizaciones. También puede pulsar el botón de actualización para volver a cargar la lista manualmente.

Ver los detalles y los registros de la implementación

En el caso de las implementaciones en curso, la pestaña de registros se actualiza automáticamente para mostrar las nuevas entradas de registro a medida que se escriben. Una vez completada la implementación, la consola recupera el estado final del registro para garantizar que veas el resultado completo.

Archivos de registro de despliegue en las instancias

Los registros de implementación se escriben en el /var/log/deployments/ directorio de cada instancia. El nombre del archivo de registro depende de cómo se haya activado la implementación:

Elastic Beanstalk rota automáticamente estos archivos y conserva los 50 registros de implementación más recientes en cada instancia.

En el caso de las implementaciones controladas por el flujo de trabajo, el registro se carga en Amazon S3 en la siguiente ruta:

s3://elasticbeanstalk-region-account-id/resources/environments/logs/deployments/environment-id/log-filename

En entornos de varias instancias, la primera instancia que comience a cargarse asume la función de toda la implementación. Esa instancia carga su registro en Amazon S3 durante la implementación. Todas las instancias siguen escribiendo los registros de implementación de forma local.

Las cargas de los registros de implementación tienen un límite de 1 MB por archivo. Si un registro de despliegue supera este tamaño, la versión cargada se trunca con un mensaje que indica que el registro completo está disponible en la instancia.

Inhabilitar las cargas de registros de S3

Para evitar que los registros de implementación se carguen en Amazon S3, defina la siguiente propiedad de entorno en su entorno:

option_settings:
  - namespace:  aws:elasticbeanstalk:application:environment
    option_name:  EB_DEPLOYMENT_LOG_S3_DISABLED
    value:  true

Cuando se establece esta propiedad del entorno, los registros de implementación se siguen escribiendo localmente /var/log/deployments/ en cada instancia, pero no se cargan en Amazon S3 y no estarán disponibles en la pestaña Implementaciones de la consola. También puede establecer esta propiedad en la página de configuración, en Software, o mediante la CLI de EB o AWS CLI.