AWS Elastic Beanstalk
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

eb logs

描述

eb logs 命令具有两种不同的用途:启用或禁用日志流式传输到 CloudWatch Logs 和检索实例日志或 CloudWatch Logs 日志。此命令与 --cloudwatch-logs (-cw) 选项结合使用时启用或禁用日志流式传输。如果没有此选项,则它将检索日志。

检索日志时,请指定 --all--zip--stream 选项以检索全部日志。如果未指定上述任何选项,则 Elastic Beanstalk 将检索结尾日志。

此命令将处理指定或默认环境的日志。相关日志因容器类型而异。如果根目录包含一个指定自定义平台的 platform.yaml 文件,则此命令还会处理生成器环境的日志。

有关更多信息,请参阅 将 Elastic Beanstalk 用于 Amazon CloudWatch Logs

语法

启用或禁用至 CloudWatch Logs 的日志流式传输:

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

检索实例日志:

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

检索环境运行状况日志:

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

选项

名称

描述

-cw [enable | disable]

--cloudwatch-logs [enable | disable]

启用或禁用至 CloudWatch Logs 的日志流式传输。如果未提供任何参数,则将启用日志流式传输。此外,如果未指定 --cloudwatch-log-source (-cls) 选项,则将启用或禁用实例日志流式传输。

-cls instance | environment-health | all

--cloudwatch-log-source instance | environment-health | all

与 CloudWatch Logs 结合使用时,请指定日志的源。使用此命令的启用或禁用形式时,这些是要为之启用或禁用 CloudWatch Logs 流式传输的日志。使用此命令的检索形式时,这些是要从 CloudWatch Logs 中检索的日志。

有效值:

  • --cloudwatch-logs(启用或禁用)– instance | environment-health | all

  • 没有 --cloudwatch-logs(检索)– instance | environment-health

值含义:

  • instance(默认)– 实例日志

  • environment-health – 环境运行状况日志(仅当环境中启用增强型运行状况时受支持)

  • all – 两种日志源

-a

--all

检索全部日志并将它们保存到 .elasticbeanstalk/logs 目录中。

-z

--zip

检索全部日志,将它们压缩为一个 .zip 文件,然后将该文件保存到 .elasticbeanstalk/logs 目录中。

--stream

流式传输 (持续输出) 全部日志。与此选项结合使用时,此命令在中断之前将一直运行(按 Ctrl+C)。

-i instance-id

--instance instance-id

仅检索指定实例的日志。

-g log-group

--log-group log-group

指定要从中检索日志的 CloudWatch Logs 日志组。此选项仅当启用至 CloudWatch Logs 的实例日志流式传输时有效。

如果启用了实例日志流式传输,并且未指定 --log-group 选项,则默认日志组为以下项之一:

  • Linux 平台 – /aws/elasticbeanstalk/environment-name/var/log/eb-activity.log

  • Windows 平台 – /aws/elasticbeanstalk/environment-name/EBDeploy-Log

有关每个日志文件对应的日志组的信息,请参阅 Elastic Beanstalk 如何设置 CloudWatch Logs

常用选项

输出

默认情况下,直接在终端显示日志。使用分页程序显示输出。按 Qq 退出。

使用 --stream 时,在终端显示现有日志并保持运行。按 Ctrl+C 退出。

使用 --all--zip 时,将日志保存到本地文件并显示文件位置。

示例

以下示例启用至 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.

以下示例将实例日志检索到 .zip 文件中。

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

本页内容: