eb logs

Descripción

El comando eb logs tiene dos propósitos distintos: habilitar o deshabilitar el streaming de registros a CloudWatch Logs y recuperar registros de instancias o los registros de CloudWatch Logs. Con la opción --cloudwatch-logs (-cw), el comando habilita o deshabilita el streaming de registros. Sin esta opción, recupera los registros.

Al recuperar los registros, especifique la opción --all, --zip o --stream para recuperar los registros completas. Si no especifica ninguna de estas opciones, Elastic Beanstalk recupera los registros de finalización.

El comando procesa los registros del entorno especificado o predeterminado. Los registros pertinentes dependen del tipo de contenedor. Si el directorio raíz contiene un archivo platform.yaml donde se especifica una plataforma personalizada, este comando también procesa los registros del entorno del constructor.

Para obtener más información, consulte Uso de Elastic Beanstalk con Amazon CloudWatch Logs.

Sintaxis

Para habilitar o deshabilitar el streaming de registros a CloudWatch Logs:

eb logs --cloudwatch-logs [enable | disable] [--cloudwatch-log-source instance | environment-health | all] [environment-name]

Para recuperar los registros de instancias:

eb logs [-all | --zip | --stream] [--cloudwatch-log-source instance] [--instance instance-id] [--log-group log-group] [environment-name]

Para recuperar los registros de estado de entorno:

eb logs [-all | --zip | --stream] --cloudwatch-log-source environment-health [environment-name]

Opciones

Nombre	Descripción
-cw [enable | disable] o bien --cloudwatch-logs [enable | disable]	Habilita o deshabilita el streaming de registros a CloudWatch Logs. Si no se proporciona ningún argumento, se habilita el streaming de registros. Si tampoco se especifica la opción --cloudwatch-log-source (-cls), el streaming de logs de instancias está habilitado o deshabilitado.
-cls instance | environment-health | all o bien --cloudwatch-log-source instance | environment-health | all	Especifica el origen de los registros al trabajar con CloudWatch Logs. Con el formato de habilitar o deshabilitar, son los registros para los que se habilita o deshabilita el streaming de CloudWatch Logs. Con el formato de recuperación del comando, estos son los registros para recuperar de CloudWatch Logs. Valores válidos: Con --cloudwatch-logs (habilitar o deshabilitar) – instance | environment-health | all Sin --cloudwatch-logs (recuperar) – instance | environment-health Significado de los valores: instance (predeterminado): logs de instancias environment-health: logs de estado de entorno (solo se admite cuando el estado mejorado está habilitado en el entorno) all: ambas orígenes de logs
-a o bien --all	Recupera todos los logs completos y los guarda en el directorio .elasticbeanstalk/logs.
-z o bien --zip	Recupera los logs completos, los comprime en un archivo .zip y guarda el archivo en el directorio .elasticbeanstalk/logs.
--stream	Realiza streaming (salidas de forma continua) de logs completos. Con esta opción, el comando se sigue ejecutando hasta que lo interrumpa (pulse Ctrl+C).
-i instance-id o bien --instance instance-id	Recupera exclusivamente los logs de la instancia especificada.
-g log-group o bien --log-group log-group	Especifica el grupo de registros de CloudWatch Logs desde el que se van a recuperar los registros. La opción solo es válida cuando está habilitada el streaming de registros de instancias a CloudWatch Logs. Si el streaming de logs de instancias está habilitado, y no especifica la opción --log-group, el grupo de logs predeterminado es uno de los siguientes: Amazon Linux 2: /aws/elasticbeanstalk/environment-name/var/log/eb-engine.log Plataformas Windows – /aws/elasticbeanstalk/environment-name/EBDeploy-Log Amazon Linux AMI (AL1): /aws/elasticbeanstalk/environment-name/var/log/eb-activity.log nota El 18 de julio de 2022, Elastic Beanstalk estableció el estado de todas las ramificaciones de la plataforma basadas en la AMI de Amazon Linux (AL1) como retirado. Para obtener más información sobre la migración a una ramificación de la plataforma Amazon Linux 2023 actual y totalmente compatible, consulte Migración de su aplicación de Linux de Elastic Beanstalk a Amazon Linux 2023 o Amazon Linux 2. Para obtener información sobre el grupo de logs correspondiente a cada archivo de log, consulte Cómo Elastic Beanstalk configura CloudWatch Logs.
Opciones comunes

Output

De forma predeterminada, muestra los logs directamente en el terminal. Utiliza un programa de paginación para mostrar la salida. Pulse Q o q para salir.

Con --stream muestra los logs existentes en el terminal y se sigue ejecutando. Pulse Ctrl+C para salir.

Con --all y --zip se guardan los logs en archivos locales y se muestra la ubicación del archivo.

Ejemplos

En el ejemplo siguiente habilita el streaming de registros de instancias a CloudWatch Logs.

$ eb logs -cw enable
Enabling instance log streaming to CloudWatch for your environment
After the environment is updated you can view your logs by following the link:
https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logs:prefix=/aws/elasticbeanstalk/environment-name/
Printing Status:
2018-07-11 21:05:20    INFO: Environment update is starting.
2018-07-11 21:05:27    INFO: Updating environment environment-name's configuration settings.
2018-07-11 21:06:45    INFO: Successfully deployed new configuration to environment.

El siguiente ejemplo recupera los logs de instancias en un archivo .zip.

$ eb logs --zip
Retrieving logs...
Logs were saved to /home/workspace/environment/.elasticbeanstalk/logs/150622_173444.zip