eb logs - AWS Elastic Beanstalk
説明構文オプション出力例

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

eb logs

説明

eb logs コマンドには、CloudWatch Logs へのログストリーミングの有効化または無効化と、インスタンスログまたは CloudWatch Logs ログの取得という 2 つの明確な目的があります。--cloudwatch-logs (-cw) オプションを使用すると、コマンドはログストリーミングを有効または無効にします。このオプションを使用しない場合は、ログを取得します。

ログを取得するときは、完全なログを取得する --all、--zip、または --stream オプションを指定します。これらのオプションを指定しない場合は、Elastic Beanstalk は末尾のログを取得します。

コマンドは、指定された環境またはデフォルト環境のログを処理します。関連するログは、コンテナタイプに応じて異なります。root ディレクトリにカスタムプラットフォームを指定する platform.yaml ファイルが含まれている場合、このコマンドはビルダー環境のログも処理します。

詳細については、「Amazon CloudWatch Logs での Elastic Beanstalk の使用」を参照してください。

構文

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 ログを設定する方法」を参照してください。

一般的なオプション

出力

デフォルトでは、ログはターミナルに直接表示されます。ページングプログラムを使用して出力を表示します。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