EC2 フリート イベントをモニタリングする Amazon EventBridge を作成する
EC2 フリートの状態変更に関する通知が送信されると、その通知のためのイベントが、JSON ファイルとして Amazon EventBridge に対し送信されます。EventBridge ルールを作成し、イベントパターンがルールに一致したときに実行するアクションを自動化できます。EventBridge がルールで定義されているパターンに一致するイベントパターンを検出すると、EventBridge はルールで指定されているターゲットを呼び出します。
次のフィールドは、ルールで定義されているイベントパターンになります。
"source": "aws.ec2fleet"
-
イベントが EC2 フリート からのものであることを特定します。
"detail-type": "
EC2 Fleet State Change
"-
イベントタイプを特定します。
"detail": { "sub-type": "
submitted
" }-
イベントのサブタイプを特定します。
EC2 フリートのイベントの一覧とイベントデータの例については、「」を参照してください。EC2 フリート イベントタイプ
通知を送信する EventBridge ルールを作成する
次の例では、Amazon EC2 が EC2 フリート状態変更通知を発するたびに、E メール、テキストメッセージ、またはモバイルプッシュ通知を送信する EventBridge ルールを作成します。この例のシグナルは EC2 Fleet State Change
イベントとして送信され、ルールによって定義されたアクションがトリガーされます。
EventBridge ルールを作成する前に、E メール、テキストメッセージ、またはモバイルプッシュ通知用の Amazon SNS トピックを作成する必要があります。
EventBridge ルールを作成して EC2 フリート状態が変更されたときに通知を送信するには
-
Amazon EventBridge コンソール (https://console.aws.amazon.com/events/
) を開きます。 -
[Create rule] を選択します。
-
[Define rule detail] (詳細の定義) で、次の操作を行います。
-
ルールの [Name (名前)] を入力し、必要に応じて説明を入力します。
ルールには、同じリージョン内および同じイベントバス上の別のルールと同じ名前を付けることはできません。
-
[イベントバス] として、[デフォルト] を選択します。アカウント内の AWS のサービスで生成されたイベントは、常に、そのアカウントのデフォルトのイベントバスに送られます。
-
ルールタイプ では、イベントパターンを持つルール] を選択します。
-
[Next] を選択します。
-
-
[Build event pattern] (イベントパターンの作成) で、次の操作を行います。
-
[Event source] (イベントソース) で、[AWS events or EventBridge partner events] ( イベントまたは EventBridge パートナーイベント) を選択します。
-
この例では [Event pattern] (イベントパターン) で、
EC2 Fleet Instance Change
イベントと一致するように以下のイベントパターンを指定します。{ "source": ["aws.ec2fleet"], "detail-type": ["EC2 Fleet Instance Change"] }
イベントパターンを追加するには、以下のように [Event pattern form] (イベントパターンフォーム) を選択してテンプレートを使用するか、[Custom pattern (JSON editor)] (カスタムパターン (JSON エディター)) を選択して独自のパターンを指定します。
-
テンプレートを使用してイベントパターンを作成するには、以下の操作を行います。
-
[Event pattern form] (イベントパターンフォーム) を選択します。
-
[イベントパターンフォーム] では、AWS[サービス] を選択します。
-
[AWS Service] ( サービス) で、[EC2 Fleet] (EC2 フリート) を選択します。
-
[Event type] (イベントタイプ) で、[EC2 Fleet Instance Change] (EC2 フリートインスタンスの変更) を選択します。
-
テンプレートをカスタマイズするには、[Edit pattern] (パターンを編集) を選択した上で、この例のイベントパターンに合わせた変更を行います。
-
-
(代替案) 以下の操作を行って、カスタムイベントパターンを指定します。
-
[Custom pattern (JSON editor)] (カスタムパターン (JSON エディター)) を選択します。
-
[Event pattern] (イベントパターン) ボックスに、この例のイベントパターンを追加します。
-
-
-
[Next] を選択します。
-
-
[Select target(s)] (ターゲットを選択) で、以下の操作を行います。
-
ターゲットタイプ] では、AWSサービス] を選択します。
-
イベントの発生時に E メール、テキストメッセージ、またはモバイルプッシュ通知を送信するために、[Select a target] (ターゲットを選択) で、[SNS topic] (SNS トピック) を選択します。
-
[Topic (トピック)] で、既存のトピックを選択します。先ず、Amazon SNS コンソールを使用して Amazon SNS トピックを作成する必要があります。詳細については、Amazon Simple Notification Service デベロッパーガイド のAmazon SNS を使用した Application-to-Person (A2P) メッセージングを参照してください。
-
(オプション) [Additional settings] (追加設定) で、その他の設定を行うこともできます。詳細については、「Amazon EventBridge ユーザーガイド」の「イベントに反応する Amazon EventBridge ルールの作成」(ステップ 16) を参照してください。
-
[Next] を選択します。
-
-
(オプション) 必要な場合は、[Tags] (タグ) で 1 つ以上のタグを作成したルールに割り当て、[Next] (次へ) を選択します。
-
[Review and create] (確認して作成) で、以下の操作を行いす。
-
ルールの詳細を確認し、必要な場合は変更を行います。
-
ルールの作成を選択します。
-
詳細については、「Amazon EventBridge ユーザーガイド」の「Amazon EventBridge ルール」と「Amazon EventBridge イベントパターン」を参照してください。
Lambda 関数をトリガーする EventBridge ルールの作成
次の例では、Amazon EC2 が EC2 フリートインスタンスが起動したときのインスタンス変更通知を発するたびに Lambda 関数をトリガーする EventBridge ルールを作成します。この例のシグナルは EC2 Fleet Instance
Change
イベント、サブタイプ launched
として発され、ルールによって定義されたアクションがトリガーされます。
EventBridge ルールを作成する前に、Lambda 関数を作成する必要があります。
EventBridge ルールで使用する Lambda 関数を作成するには
AWS Lambda コンソール (https://console.aws.amazon.com/lambda/
) を開きます。 -
[関数の作成] を選択します。
-
関数の名前を入力し、コードを設定し、[Create function (関数の作成)] を選択します。
Lambda の使用の詳細については、AWS Lambda デベロッパーガイドの「コンソールで Lambda 関数を作成する」を参照してください。
EC2 フリート のインスタンスの状態が変更されたときに Lambda 関数をトリガーする EventBridge ルールを作成するには
-
Amazon EventBridge コンソール (https://console.aws.amazon.com/events/
) を開きます。 -
[Create rule] を選択します。
-
[Define rule detail] (詳細の定義) で、次の操作を行います。
-
ルールの [Name (名前)] を入力し、必要に応じて説明を入力します。
ルールには、同じリージョン内および同じイベントバス上の別のルールと同じ名前を付けることはできません。
-
[イベントバス] として、[デフォルト] を選択します。アカウント内の AWS のサービスで生成されたイベントは、常に、そのアカウントのデフォルトのイベントバスに送られます。
-
ルールタイプ では、イベントパターンを持つルール] を選択します。
-
[Next] を選択します。
-
-
[Build event pattern] (イベントパターンの作成) で、次の操作を行います。
-
[Event source] (イベントソース) で、[AWS events or EventBridge partner events] ( イベントまたは EventBridge パートナーイベント) を選択します。
-
この例では [Event pattern] (イベントパターン) で
EC2 Fleet Instance Change
イベントとlaunched
サブタイプに一致するよう、以下のイベントパターンを指定します。{ "source": ["aws.ec2fleet"], "detail-type": ["EC2 Fleet Instance Change"], "detail": { "sub-type": ["launched"] }
イベントパターンを追加するには、以下のように [Event pattern form] (イベントパターンフォーム) を選択してテンプレートを使用するか、[Custom pattern (JSON editor)] (カスタムパターン (JSON エディター)) を選択して独自のパターンを指定します。
-
テンプレートを使用してイベントパターンを作成するには、以下の操作を行います。
-
[Event pattern form] (イベントパターンフォーム) を選択します。
-
[イベントパターンフォーム] では、AWS[サービス] を選択します。
-
[AWS Service] ( サービス) で、[EC2 Fleet] (EC2 フリート) を選択します。
-
[Event type] (イベントタイプ) で、[EC2 Fleet Instance Change] (EC2 フリートインスタンスの変更) を選択します。
-
[Edit pattern] (パターンの編集) を選択し、サンプルのイベントパターンに一致するように
"detail": {"sub-type": ["launched"]
を追加します。適切な JSON 形式を得るには、前にある角括弧 (]
) の後にコンマ (,
) を入力します。
-
-
(代替案) 以下の操作を行って、カスタムイベントパターンを指定します。
-
[Custom pattern (JSON editor)] (カスタムパターン (JSON エディター)) を選択します。
-
[Event pattern] (イベントパターン) ボックスに、この例のイベントパターンを追加します。
-
-
-
[Next] を選択します。
-
-
[Select target(s)] (ターゲットを選択) で、以下の操作を行います。
-
ターゲットタイプ] では、AWSサービス] を選択します。
-
イベントの発生時に E メール、テキストメッセージ、またはモバイルプッシュ通知を送信するために、[Select a target] (ターゲットを選択) で、[SNS topic] (SNS トピック) を選択します。
-
[Topic] (トピック) で [Lambda function] (Lambda 関数) を選択し、[Function] (関数) では、イベント発生時に応答するように作成した関数を選択します。
-
(オプション) [Additional settings] (追加設定) で、その他の設定を行うこともできます。詳細については、「Amazon EventBridge ユーザーガイド」の「イベントに反応する Amazon EventBridge ルールの作成」(ステップ 16) を参照してください。
-
[Next] を選択します。
-
-
(オプション) 必要な場合は、[Tags] (タグ) で 1 つ以上のタグを作成したルールに割り当て、[Next] (次へ) を選択します。
-
[Review and create] (確認して作成) で、以下の操作を行いす。
-
ルールの詳細を確認し、必要な場合は変更を行います。
-
ルールの作成を選択します。
-
Lambda 関数を作成する方法のチュートリアルと Lambda 関数を実行する EventBridge ルールについては、AWS Lambda デベロッパーガイドの「チュートリアル: EventBridge を使用して Amazon EC2 インスタンスの状態をログに記録する」を参照してください。