View a markdown version of this page

Elastic Beanstalk 環境のデプロイログの表示 - AWS Elastic Beanstalk
サポートされているオペレーションログの内容コンソールインスタンスログファイル

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

Elastic Beanstalk 環境のデプロイログの表示

Elastic Beanstalk は、環境へのデプロイごとにデプロイログを生成します。デプロイログには、依存関係のインストール、ビルド出力、アプリケーションの起動、発生したエラーなど、デプロイ中に何が起こったかの統合された時系列ビューが表示されます。デプロイログを使用すると、SSH をインスタンスにしたり、複数のログファイルを関連付けたりすることなく、失敗したデプロイをすばやく診断できます。

デプロイログは各インスタンスにローカルに書き込まれます。コンソール、CLI、API、またはマネージド更新を介してトリガーされたデプロイの場合、1 つのインスタンスはデプロイ中にログを Amazon S3 に継続的にアップロードします。Elastic Beanstalk コンソールは Amazon S3 からログを読み取るため、インスタンスに接続せずに進行状況をモニタリングできます。

デプロイログは簡潔に設計されています。成功すると、ログには概要メッセージ (実行および完了したコマンドなど) のみが表示されます。失敗した場合、ログには失敗したステップから最大 50 行の出力が含まれるため、詳細な出力をふるい分けることなくエラーを確認できます。

注記

デプロイログは、2026 年 3 月 11 日以降にリリースされた Amazon Linux 2 および Amazon Linux 2023 プラットフォームバージョンで利用できます。 https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-03-11-al2023.htmlWindows プラットフォームは現在サポートされていません。

サポートされているオペレーション

デプロイログは、次のオペレーションに対して生成されます。

  • アプリケーションのデプロイ — 環境に新しいアプリケーションバージョンをデプロイします。

  • 設定の更新 – インスタンスの更新を必要とする環境設定の変更。

  • 環境の作成 – 新しい環境を作成するときの最初のデプロイ。

  • アプリケーションサーバーの再起動 – インスタンスでアプリケーションサーバーを再起動します。

ログのリクエスト、CNAMEs のスワップ、タグの更新など、インスタンスのアプリケーションまたは設定状態を変更しないオペレーションは、デプロイログを生成しません。

デプロイログの内容

デプロイログは、デプロイ中に次の情報をキャプチャします。

  • デプロイライフサイクル – や など、各デプロイフェーズの開始Starting Application deploymentメッセージと完了メッセージCompleted Application deployment。

  • .ebextensions output – 成功すると、実行されたコマンドの名前。失敗した場合、問題の診断に役立つ最後の 50 行のcfn-init出力。

  • プラットフォームフック出力 – 成功すると、実行されたフックスクリプトの名前。失敗した場合、フック出力の最後の 50 行。

  • 依存関係のインストール — npm install、pip install、、 などのパッケージマネージャーからの出力composer installbundle install。成功すると、完了メッセージのみがログに記録されます。失敗した場合、出力の最後の 50 行が含まれます。

  • ビルド出力 – docker build、go build、Java ビルドなどのビルドコマンドからの出力。失敗した場合、出力の最後の 50 行が含まれます。

  • アプリケーション起動出力 – 起動後のアプリケーションからの初期出力。ソースはプラットフォームによって異なります。

    • Docker – docker logsまたは からのコンテナログ docker compose logs

    • Java SE、Go、Node.js、Python、Ruby、.NET – stdout ログを処理する

    • Tomcat – Catalina ログ出力

    • PHP – PHP-FPM マスターとプールのエラーログ

    • ECS – 各タスクコンテナからのコンテナログ

    注記

    アプリケーション出力は、アプリケーションの起動から 2 秒後にキャプチャされます。初期起動メッセージのみが含まれます。アプリケーションが出力の生成に時間がかかる場合、デプロイログには表示されません。完全なアプリケーションログを表示するには、バンドルログをリクエストするか、インスタンスに直接接続します。詳細については、「インスタンスログの表示」を参照してください。

デプロイステップが失敗すると、ログはそれを でマーク[ERROR]し、失敗したステップから最大 50 行の出力を含めます。デプロイログに十分な詳細が含まれていない場合は、 ログタブから完全なインスタンスログ (eb-engine.log、eb-hooks.log、およびアプリケーションログを含む) を取得できます。詳細については、「Elastic Beanstalk 環境の Amazon EC2 インスタンスからのログの表示」を参照してください。

コンソールでのデプロイログの表示

Elastic Beanstalk コンソールには、デプロイ履歴とログを表示できるデプロイタブが環境ダッシュボードに表示されます。

デプロイ履歴の表示

デプロイ履歴を表示するには

  1. Elastic Beanstalk コンソールを開き、リージョンリストで を選択します AWS リージョン。

  2. ナビゲーションペインで、[環境] を選択し、リストから環境の名前を選択します。

  3. 環境ダッシュボードで、デプロイタブを選択します。

    デプロイタブには、環境のデプロイのテーブルが表示されます。各行には以下の情報が含まれます。

    • リクエスト ID – デプロイの一意の識別子。

    • ステータス – 成功、失敗、または進行中。

    • タイプ – 環境の作成、アプリケーションのデプロイ、設定の更新、マネージドプラットフォームの更新、アプリケーションサーバーの再起動、環境の再構築、環境の復元、環境ドメインのスワップ、環境の終了などのデプロイタイプ。

    • 開始時刻 – デプロイが開始された時刻。

    • 期間 – デプロイの完了にかかった時間。

デプロイが進行中の場合、タブは自動的に更新をポーリングします。更新ボタンを選択して、リストを手動で再ロードすることもできます。

デプロイの詳細とログの表示

デプロイの詳細を表示するには

  1. デプロイタブで、検査するデプロイのリクエスト ID リンクを選択します。

  2. デプロイの詳細ページには、リクエスト ID、ステータス、デプロイタイプ、開始時刻、期間、デプロイポリシーを含む概要セクションが表示されます。デプロイポリシー (一度にすべて、ローリング、追加のバッチによるローリング、イミュータブル、トラフィック分割など) は、デプロイイベントから判断できる場合に表示されます。

  3. 概要の下で、次のいずれかのタブを選択します。

    • イベント – このデプロイに関連するイベントのタイムライン。選択したデプロイのイベントのみを表示するようにフィルタリングされます。

    • デプロイログ – インスタンスからの統合デプロイログ。ログレベルによる検索、フィルタリング、ログファイルのダウンロードを行うことができます。

進行中のデプロイの場合、ログタブは自動的に更新され、新しいログエントリが書き込まれると表示されます。デプロイが完了すると、コンソールは最終的なログ状態を取得し、完全な出力を確認します。

重要

コンソールでデプロイログを表示するには、環境の Amazon S3 ストレージバケット () に対するs3:GetObjectアクセス許可が必要ですelasticbeanstalk-region-account-id。IAM ポリシーにこのアクセス許可が含まれていない場合、デプロイ履歴とイベントは引き続き使用できますが、ログタブにエラーが表示されます。

インスタンスのデプロイログファイル

デプロイログは、各インスタンスの /var/log/deployments/ ディレクトリに書き込まれます。ログファイル名は、デプロイのトリガー方法によって異なります。

  • ワークフロー制御のデプロイ (コンソール、CLI、または API を介してトリガー) – eb-deployment-request-id.log。request-id は一意のデプロイリクエスト ID です。

  • 自己起動デプロイ (インスタンス起動または再起動アプリケーションサーバー) – eb-deployment-unix-timestamp.log。

Elastic Beanstalk はこれらのファイルを自動的にローテーションし、各インスタンスの最新のデプロイログを 50 個保持します。

ワークフロー制御のデプロイの場合、ログは次のパスで Amazon S3 にアップロードされます。

s3://elasticbeanstalk-region-account-id/resources/environments/logs/deployments/environment-id/log-filename

マルチインスタンス環境では、アップロードを開始する最初のインスタンスがデプロイ全体のロールを要求します。そのインスタンスは、デプロイの期間中、ログを Amazon S3 にアップロードします。すべてのインスタンスは、引き続きデプロイログをローカルに書き込みます。

重要

Amazon S3 にデプロイログをアップロードするには、インスタンスプロファイル内の環境の Amazon S3 ストレージバケットに対するs3:PutObjectアクセス許可が必要であり、VPC 設定では Amazon S3 への接続を許可する必要があります。

デプロイログのアップロードは、ファイルあたり 1 MB に制限されます。デプロイログがこのサイズを超えると、アップロードされたバージョンは、インスタンスで完全なログが使用可能であることを示すメッセージで切り捨てられます。

S3 ログアップロードの無効化

デプロイログが Amazon S3 にアップロードされないようにするには、環境に次の環境プロパティを設定します。

option_settings:
  - namespace:  aws:elasticbeanstalk:application:environment
    option_name:  EB_DEPLOYMENT_LOG_S3_DISABLED
    value:  true

この環境プロパティを設定すると、デプロイログは各インスタンス/var/log/deployments/の にローカルに書き込まれますが、Amazon S3 にアップロードされず、コンソールのデプロイタブでは使用できません。このプロパティは、ソフトウェアの設定ページ、または EB CLI または を使用して設定することもできます AWS CLI。