eb logs - AWS Elastic Beanstalk
描述语法选项输出示例

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 选项，则默认日志组为以下项之一：

  • Amazon Linux 2 – /aws/elasticbeanstalk/environment-name/var/log/eb-engine.log

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

  • Amazon Linux AMI (AL1) – /aws/elasticbeanstalk/environment-name/var/log/eb-activity.log

    注意

    2022 年 7 月 18 日，Elastic Beanstalk 将基于 Amazon Linux AMI（AL1）的所有平台分支的状态设置为已停用。有关迁移到当前且完全受支持的 Amazon Linux 2023 平台分支的更多信息，请参阅 将 Elastic Beanstalk Linux 应用程序迁移到 Amazon Linux 2023 或 Amazon Linux 2。

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

常用选项

输出

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

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