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 consolidada de lo que ocurrió durante una implementación, de modo que pueda diagnosticar una falla sin tener que recopilar varios registros usted mismo. El contenido del registro y el momento en que esté disponible depende de si el entorno es un entorno de Beanstalk Standard o un entorno de Beanstalk Cluster.

Con Beanstalk Standard, 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 administradas, 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 conectarse a la instancia.

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

Con Beanstalk Cluster, Elastic Beanstalk recopila el registro de implementación una vez finalizada la operación. Reúne los registros de contenedores de cada pod del entorno, junto con los eventos de Kubernetes para el espacio de nombres del entorno, y los carga como un único archivo zip en el depósito de almacenamiento de Amazon S3 de su entorno. La consola de Elastic Beanstalk lee el archivo zip de Amazon S3 y muestra su contenido para que pueda leerlo sin necesidad de conectarse al clúster. La disponibilidad no depende de la versión de la plataforma y Elastic Beanstalk no escribe un archivo de registro de implementación en los nodos.

Operaciones admitidas

Para los entornos de Beanstalk Standard, se generan registros de implementación 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 de CNAME o la actualización de etiquetas, no generan registros de implementación.

En los entornos de Beanstalk Cluster, los registros de implementación se generan para la creación del entorno, la implementación de aplicaciones, las actualizaciones de configuración, el reinicio del servidor de aplicaciones y la finalización del entorno. La terminación de un entorno produce un registro de implementación, lo que no ocurre con Beanstalk Standard. Las actualizaciones de la plataforma gestionada no se aplican, porque un entorno de Beanstalk Cluster ejecuta imágenes de contenedor en lugar de una versión de plataforma.

Elastic Beanstalk recopila el registro de implementación de un entorno de Beanstalk Cluster después de la etapa de implementación. Si una operación falla antes de ese paso, por ejemplo, al crear la imagen del contenedor, crear el clúster, aprovisionar los recursos o generar la especificación de Kubernetes, no hay ningún registro de implementación y los eventos del entorno describen lo que ocurrió. Para obtener más información, consulte Visualización de la transmisión de eventos de un entorno de Elastic Beanstalk.

Contenido del registro de implementación

En los entornos de Beanstalk Standard, 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 una etiqueta [ERROR] e incluye hasta 50 líneas de resultados del paso fallido. Si el registro de implementación no contiene suficientes detalles, puedes recuperar los registros completos de las instancias (incluidos eb-engine.log los registros de las aplicaciones) en 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.

Contenido del registro de implementación para entornos de Beanstalk Cluster

Para un entorno de Beanstalk Cluster, el registro de implementación es un archivo zip. Contiene un archivo de eventos para todo el entorno y un archivo por pod, en un directorio: 1-environment/

1-environment/
  _k8Events.txt
  pod-name.txt

_k8Events.txtalmacena los eventos de Kubernetes en el espacio de nombres del entorno que no están vinculados a un solo pod, como los eventos de programación, volumen, escalado y balanceador de cargas. El subrayado inicial lo ordena primero.

Cada uno pod-name.txt comienza con un =====EVENTS===== bloque que contiene los eventos de ese módulo, primero los más antiguos, seguido de un =====LOGS===== bloque que contiene los registros de cada contenedor del módulo. Los contenedores de inicio aparecen como sus propios bloques contenedores, por lo que cuando un contenedor de inicio falla, se espera que aparezca un registro vacío para el contenedor de la aplicación, en lugar de un segundo problema.

En el caso de un contenedor que se está reiniciando, el =====EVENTS===== bloque de ese pod indica el motivo (por ejemplo,BackOff) y el =====LOGS===== bloque contiene el registro del contenedor en el momento de la recopilación. No se incluye el registro de una instancia anterior del contenedor.

El registro de cada contenedor tiene un límite de 5 MiB, sin límite de líneas. Un registro que llega a la tapa se marca como truncado. Aparte de ese límite, no se elimina nada del registro, independientemente de si la operación se realiza correctamente o no. Si Elastic Beanstalk no puede leer los registros de un contenedor, la recopilación continúa y el bloque de ese contenedor registra el error.

La instalación de dependencias y los resultados de la compilación no figuran en el registro de implementación de un entorno de Beanstalk Cluster. Esto ocurre cuando Elastic Beanstalk crea la imagen de su contenedor. Para obtener más información, consulte Creación de imágenes de contenedores para entornos de Beanstalk Cluster.

Visualización de los registros de implementación en la consola

La consola de Elastic Beanstalk incluye una pestaña de despliegues en el panel de control del entorno donde puede ver el historial y los registros de sus despliegues. El historial de implementaciones muestra las implementaciones de los últimos 42 días (6 semanas).

Visualización del historial de despliegues

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

Visualización de los detalles y registros de la implementación

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

En un entorno de Beanstalk Cluster, el registro de implementación aparece una vez finalizada la operación, por lo que la pestaña de registros no se actualiza mientras se ejecuta la operación. Primero se muestra el archivo de eventos de todo el entorno, seguido de los archivos por pod. Si el archivo zip comprimido ocupa más de 5 MiB, la consola le pedirá que lo descargue de Amazon S3 en lugar de mostrarlo. Este límite se aplica al archivo en su conjunto, no al registro de ningún contenedor individual.

Dónde se almacenan los registros de implementación

Archivos de registro de implementación en instancias de Beanstalk Standard

Los registros de implementación se escriben en el /var/log/deployments/ directorio de cada instancia. El nombre del archivo del 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 de cada instancia.

Para 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 el caso de las implementaciones con inicio automático, el registro se carga en Amazon S3 en un subdirectorio: selfstartup/

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

En el caso de las implementaciones controladas por el flujo de trabajo, la primera instancia que comience a cargarse asume el rol durante toda la implementación. Esa instancia carga su registro en Amazon S3 mientras dure la implementación. En el caso de las implementaciones con inicio automático, cada instancia carga su propio registro de forma independiente. Todas las instancias siguen escribiendo los registros de implementación de forma local.

La carga de los registros de implementación tiene un límite de 1 MB por archivo. Si un registro de implementación 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 la carga de registros de S3

En los entornos estándar de Beanstalk, 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 de 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.

La EB_DEPLOYMENT_LOG_S3_DISABLED propiedad se lee en sus instancias, por lo que no tiene ningún efecto en un entorno de Beanstalk Cluster. Actualmente, no hay forma de impedir que Elastic Beanstalk cargue el registro de implementación de un entorno de Beanstalk Cluster.

Archivos de registro de implementación para entornos de Beanstalk Cluster

Para un entorno de clúster de Beanstalk, Elastic Beanstalk carga el registro de implementación en el depósito de almacenamiento de Amazon S3 de su entorno en la siguiente ruta:

s3://elasticbeanstalk-region-account-id/resources/environments/logs/deployments/environment-id/deployment-environment-name-request-id.zip

Elastic Beanstalk realiza la carga por sí mismo, utilizando la función de operación del entorno, por lo que no se requiere ningún permiso para el perfil de instancia y no es necesario que nada llegue a Amazon S3 desde sus nodos.

La carga es el máximo esfuerzo. Si no se realiza correctamente, la operación se completa, no se genera ningún evento de entorno y la consola indica que el registro de implementación no está disponible.