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

Amazon EventBridge で Elastic Beanstalk を使用する

Amazon EventBridge を使用すると、Elastic Beanstalk リソースをモニタリングし、他の AWS のサービスを使用するターゲットアクションを起動するための、イベント駆動型のルールを設定できます。たとえば、実稼働環境のヘルスステータスが Warning に変わるたびに、それを Amazon SNS トピックに伝達することで、E メール通知を送信させるルールを設定できます。または、環境のヘルスステータスが Degraded または Severe 状態に変わった場合に通知を Slack に渡すように、Lambda 関数を設定することができます。

Amazon EventBridge でルールを作成して、次の Elastic Beanstalk イベントのいずれかに反応させることが可能です。

関心のある特定の Elastic Beanstalk イベントをキャプチャするには、そのイベント固有のパターンを定義し、イベントを検出する EventBridge がそれを照合できるようにます。イベントパターンは、一致するイベントと同じ構造をしています。イベントのパターンでは、照合する対象のフィールドを引用符で囲み、検出したい値を指定します。イベントは、ベストエフォートベースで発生します。通常の運用状況下では、Elastic Beanstalk から EventBridge にほぼリアルタイムで配信されます。ただし、イベントの配信を遅らせたり妨げたりする状況が発生する場合もあります。

Elastic Beanstalk イベントに含まれるフィールドと、そこで使用される可能性のある文字列値のリストについては、「Elastic Beanstalk イベントフィールドマッピング」を参照してください。EventBridge ルールがイベントパターンでどのように機能するかについては、「EventBridge のイベントとイベントパターン」を参照してください。

EventBridge を使用した Elastic Beanstalk リソースの監視

EventBridge を使用してルールを作成すると、Elastic Beanstalk がリソースに対してイベントを発生したときに実行されるアクションを定義できます。たとえば、環境のステータスが変化するたびに E メールメッセージを送信するルールを作成できます。

EventBridge コンソールには、Elastic Beanstalk イベントパターンを作成するために、事前定義済みのパターンがオプションとして用意されています。ルールの作成時に EventBridge コンソールでこのオプションを選択すると、Elastic Beanstalk イベントパターンをすばやく作成することが可能です。ユーザーが必要なのは、イベントフィールドと値の選択のみです。選択を行うと、コンソールによってイベントパターンが作成され、表示されます。また、作成されたイベントパターンを手動で編集し、カスタムパターンとして保存することもできます。コンソールには、詳細なサンプルイベントも表示されるので、これをコピーして、作成中のイベントパターンに貼り付けることもできます。

EventBridge コンソールにイベントパターンを入力またはコピーする場合は、コンソールの [カスタムパターン] オプションを選択します。これにより、前述したフィールドと値を選択する手順を実行する必要がなくなります。このトピックでは、イベントマッチングパターンと Elastic Beanstalk イベントの両方の例をご紹介します。

Elastic Beanstalk イベントパターンの例

イベントパターンは、一致するイベントと同じ構造をしています。イベントのパターンでは、照合する対象のフィールドを引用符で囲み、検出したい値を指定します。

Elastic Beanstalk イベントの例

リソースステータスの変更に対する Elastic Beanstalk イベントの例を次に示します。

{ 
   "version":"0",
   "id":"1234a678-1b23-c123-12fd3f456e78",
   "detail-type":"Elastic Beanstalk resource status change",
   "source":"aws.elasticbeanstalk",
   "account":"111122223333",
   "time":"2020-11-03T00:31:54Z",
   "region":"us-east-1",
   "resources":[
      "arn:was:elasticbeanstalk:us-east-1:111122223333:environment/myApplication/myEnvironment"
   ],
   "detail":{
      "Status":"Environment creation started",
      "EventDate":1604363513951,
      "ApplicationName":"myApplication",
      "Message":"createEnvironment is starting.",
      "EnvironmentName":"myEnvironment",
      "Severity":"INFO"
   }
}

ヘルスステータスの変更に対する Elastic Beanstalk イベントの例を次に示します。

{ 
   "version":"0",
   "id":"1234a678-1b23-c123-12fd3f456e78",
   "detail-type":"Health status change",
   "source":"aws.elasticbeanstalk",
   "account":"111122223333",
   "time":"2020-11-03T00:34:48Z",
   "region":"us-east-1",
   "resources":[
      "arn:was:elasticbeanstalk:us-east-1:111122223333:environment/myApplication/myEnvironment"
   ],
   "detail":{
      "Status":"Environment health changed",
      "EventDate":1604363687870,
      "ApplicationName":"myApplication",
      "Message":"Environment health has transitioned from Pending to Ok. Initialization completed 1 second ago and took 2 minutes.",
      "EnvironmentName":"myEnvironment",
      "Severity":"INFO"
   }
}

Elastic Beanstalk イベントフィールドマッピング

次の表は、Elastic Beanstalk イベントフィールドおよびそれに使用可能な文字列値と EventBridge detail-type フィールドのマッピングを示しています。EventBridge が、サービスのイベントパターンをどのように使用するかの詳細については、「EventBridge のイベントとイベントパターン」を参照してください。