チュートリアル: EventBridge を使用して Amazon EC2 インスタンスの状態をログに記録する

Amazon EC2 インスタンスの状態の変化をログに記録する AWS Lambda 関数を作成できます。そうすると、状態の遷移や、関心のある 1 つ以上の状態への遷移があるたびに Lambda 関数を実行するルールを作成します。このチュートリアルでは、新しいインスタンスが起動されるたびにログに記録します。

ステップ 1: AWS Lambda 関数を作成する

状態変更イベントのログを記録する Lambda 関数を作成します。ステップ 2 でルールを作成するときに、この関数を指定します。

Lambda 関数を作成するには

1. AWS Lambda コンソール (https://console.aws.amazon.com/lambda/) を開きます。

2. 関数の作成 を選択します。

3. Author from scratch（製作者を最初から） を選択します。

4. Lambda 関数の名前と説明を入力します。例えば、関数名を LogEC2InstanceStateChange とします。

5. 残りのオプションはデフォルトのまま、[Create function] (関数の作成) を選択します。

6. 関数ページの [Code] (コード) タブで、index.js をダブルクリックします。

7. 既存のコードを以下のコードに置き換えます。

   'use strict';
   
   exports.handler = (event, context, callback) => {
       console.log('LogEC2InstanceStateChange');
       console.log('Received event:', JSON.stringify(event, null, 2));
       callback(null, 'Finished');
   };

8. [Deploy‬] (デプロイ) をクリックします。

ステップ 2: ルールを作成する

ステップ 1 で作成した Lambda 関数を実行するルールを作成します。Amazon EC2 インスタンスを起動すると、このルールが実行されます。

EventBridge ルールを作成するには

1. Amazon EventBridge コンソール (https://console.aws.amazon.com/events/) を開きます。

2. ナビゲーションペインで [Rules] (ルール) を選択します。

3. [‬Create rule]‭ (ルールの作成) を選択します。

4. ルールの名前と説明を入力します。例えば、ルール TestRule に名前を付けます

5. [Event bus] (イベントバス) では、このルールに関連付けるイベントバスを選択します。このルールをアカウントからのイベントと一致させるには、[default] (デフォルト) を選択します。アカウントの AWS サービスがイベントを発行すると、常にアカウントのデフォルトのイベントバスに移動します。

6. [Rule type] (ルールタイプ) では、[Rule with an event pattern] (イベントパターンを持つルール) を選択します。

7. [Next] (次へ) をクリックします。

8. [Event source] (イベントソース) では、AWS[services] (サービス) を選択します。

9. [Event pattern] (イベントパターン) の場合は、次のいずれかを実行します。

   1. [Event source] (イベントソース) では、ドロップダウンリストから [ EC2] を選択します。

   2. [Event type] (イベントタイプ) として、ドロップダウンリストから[EC2 Instance State-change Notification] (EC2 インスタンス状態変更通知) を選択します。

   3. [Specific states(s)] (特定の状態) を選択して、ドロップダウンリストから [running] (実行中) を選択します。

   4. [Any instance] (任意のインスタンス) を選択します。

10. [Next] (次へ) をクリックします。

11. [Target types] (ターゲットタイプ) では、AWS[services] (サービス) を選択します。

12. ターゲットの選択では、ドロップダウンリストから [Lambda function] (Lambda 関数) を選択します。

13. [Function] (関数) で、[Step 1: Create a Lambda function] (ステップ 1：Lambda 関数を作成する) セクションで作成した Lambda 関数を選択します。この例では、LogEC2InstanceStateChange を選択します。

14. [Next] (次へ) をクリックします。

15. [Next] (次へ) をクリックします。

16. ルールの詳細を確認し、[Create rule] (ルールの作成) を選択します。

ステップ 3: ルールをテストする

Amazon EC2 コンソールを使用して Amazon EC2 インスタンスを停止することで、ルールをテストできます。インスタンスが停止されるまで数分間待ったら、CloudWatch コンソールで AWS Lambda メトリクスを調べて、関数が実行されたことを確認します。

インスタンスを停止してルールをテストするには

1. Amazon EC2 コンソール (https://console.aws.amazon.com/ec2/) を開きます。

2. インスタンスを起動します。詳細については、『Linux インスタンス用 Amazon EC2 ユーザーガイド』の「インスタンスの起動」を参照してください。

3. インスタンスを停止します。詳細については、『Linux インスタンス用 Amazon EC2 ユーザーガイド』の「インスタンスの停止と開始」を参照してください。

4. Lambda 関数からの出力を表示するには、以下の操作を実行します。

   1. CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/) を開きます。

   2. ナビゲーションペインで [ログ] を選択します。

   3. Lambda 関数 (/aws/lambda/function-name) のロググループの名前を選択します。

   4. 停止したインスタンスの関数によって提供されるデータを表示するログのストリーム名を選択します。

5. (オプション) 終了したら、停止したインスタンスを終了します。詳細については、「Linux インスタンス用 Amazon EC2 ユーザーガイド」の「インスタンスの終了」を参照してください。

ステップ 4: 成功を確認する

CloudWatch ログに Lambda イベントがある場合、このチュートリアルは正常に完了しています。イベントが CloudWatch ログにない場合は、ルールが正常に作成されたことを確認してトラブルシューティングを開始し、ルールが正しく見える場合は、Lambda 関数のコードが正しいことを確認します。

ステップ 5: リソースをクリーンアップする

このチュートリアル用に作成したリソースは、保存を希望しない限り、すぐに削除できます。使用しなくなった AWS リソースを削除することで、AWS アカウントに請求される料金が発生しないようにできます。

EventBridge ルールを削除するには

1. Eventbridge コンソールの [Rules] (ルール) ページを開きます。

2. 作成したルールを選択します。

3. [Delete] (削除) をクリックします。

4. [Delete] (削除) をクリックします。

Lambda 関数を削除するには

1. Lambda コンソールの [Functions] (関数) ページを開きます。

2. 作成した関数を選択します。

3. [Actions] (アクション) で、[Delete] (削除) を選択します。

4. [削除] を選択します。