チュートリアル: EventBridge を使用して Amazon EC2 インスタンスの状態をログに記録する - Amazon EventBridge
ステップ 1: AWS Lambda 関数を作成するステップ 2: ルールを作成するステップ 3: ルールをテストするステップ 4: 成功を確認するステップ 5: リソースをクリーンアップする

チュートリアル: 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. ナビゲーションペインで ルール] を選択します。

  3. ルールの作成 を選択します。

  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. インスタンスを起動します。詳細については、「Amazon EC2 ユーザーガイド」の「Amazon EC2 インスタンスの起動」を参照してください。

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

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

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

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

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

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

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

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

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

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

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

EventBridge ルールを削除するには

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

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

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

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

Lambda 関数を削除するには

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

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

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

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