メニュー
AWS Elastic Beanstalk
開発者ガイド (API Version 2010-12-01)

通知とトラブルシューティング

このページには、一般的な問題に対する原因メッセージの例と詳細情報へのリンクが一覧表示されます。いくつかのチェックにわたって持続的に状態に問題があることが検出されると、原因メッセージが環境ダッシュボードに表示され、イベントに記録されます。

デプロイ

Elastic Beanstalk は、環境のデプロイ後の整合性を監視します。ローリングデプロイに失敗した場合、環境のインスタンスで実行されているアプリケーションバージョンが異なっている可能性があります。これは、デプロイが 1 つあるいは複数のバッチで成功しても、すべてのバッチへのデプロイが完了する前に失敗した場合に起こります。

5 つのインスタンスのうち 2 つで正しくないアプリケーションバージョンが検出された。予想されるバージョン「v1」(デプロイ 1)。

環境インスタンスのアプリケーションバージョンが正しくない。予想されるバージョン「v1」(デプロイ 1)。

予想されるアプリケーションバージョンが、環境内のいくつかの、あるいはすべてのインスタンスで起動していない。

正しくないアプリケーションバージョン「v2」(デプロイ 2)。予想されるバージョン「v1」(デプロイ 1)。

インスタンスにデプロイされているアプリケーションが、予想されるバージョンとは異なります。デプロイが失敗すると、予想されるバージョンがもっとも直近の成功したデプロイのバージョンにリセットされます。上記の例では、最初のデプロイ(バージョン「v1」)は成功し、2 番目デプロイ(バージョン「v2」)は失敗しています。「v2」を実行するインスタンスは、正常な状態ではないみなされます。

この問題を解決し、別のデプロイを開始します。機能していた前のバージョンを再度デプロイするか、環境をデプロイ中はヘルスチェックを無視するように設定し、デプロイを強制的に完了させるため新しいバージョンを再度デプロイします。

また、間違ったアプリケーションバージョンを実行しているインスタンスを特定し、終了することもできます。Elastic Beanstalk は、正しいバージョンのインスタンスを起動し、終了させたインスタンスと置き換えます。EB CLI ヘルスコマンドを使って、間違ったアプリケーションバージョンを実行しているインスタンスを識別します。

アプリケーションサーバー

15% of requests are erroring with HTTP 4xx

20% of the requests to the ELB are erroring with HTTP 4xx.

インスタンスまたは環境に対する HTTP リクエストの多くが 4xx エラーを原因として失敗しています。

400 シリーズのステータスコードは、ユーザーが存在しないページをリクエスト(404 File Not Found)するなどの不適切なリクエストをした、またはユーザーにはアクセスする権利がない(403 Forbidden)ことを示します。404 の数が低いことは珍しくありませんが、その数が多いと、存在しないページへの内部リンクまたは外部リンクがあることを意味する場合があります。このような問題は、不適切な内部リンクを修正し、不適切な外部リンクにリダイレクトを追加することによって解決できます。

5% of the requests are failing with HTTP 5xx

3% of the requests to the ELB are failing with HTTP 5xx.

インスタンスまたは環境に対する HTTP リクエストの多くが 500 シリーズのステータスコードを原因として失敗しています。

500 シリーズのステータスコードは、アプリケーションサーバーで内部エラーが発生したことを示します。このような問題は、アプリケーションコードにエラーがあり、迅速にエラーを特定し、修正する必要があることを示します。

95% of CPU is in use

インスタンスについて、ヘルスエージェントが非常に高い CPU 使用率をレポートしており、インスタンスのヘルスステータスが Warning または Degraded に設定されています。

環境をスケールしてインスタンスの負荷を軽減します。

ワーカーインスタンス

20 messages waiting in the queue (25 seconds ago)

リクエストの処理速度よりも速くリクエストがワーカー環境のキューに追加されています。環境をスケールして処理能力を向上させます。

5 messages in Dead Letter Queue (15 seconds ago)

ワーカーリクエストが繰り返し失敗しており、デッドレターキューに追加されています。デッドレターキュー内のリクエストをチェックして、失敗している理由を確認します。

その他のリソース

4 active instances is below Auto Scaling group minimum size 5

環境内で実行されているインスタンスの数が、Auto Scaling group に対して設定されている最小数に達していません。

Auto Scaling group (groupname) notifications have been deleted or modified

Auto Scaling group に対して設定されている通知が Elastic Beanstalk 外部で修正されています。