eb logs - Amazon Elastic Beanstalk
描述语法选项输出示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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