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

# チュートリアル: Eventbridge を使用して Amazon S3 オブジェクトレベル操作のログを記録する
<a name="eb-log-s3-data-events"></a>

[Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) バケットにオブジェクトレベルの API 操作のログを記録することができます。Amazon EventBridge がこれらの[イベント](eb-events.md)と一致するには、[AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html) を使用してこれらのイベントを受信する証跡を設定する必要があります。

このチュートリアルでは、CloudTrail 証跡を作成して [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) 関数を作成し、S3データイベントに応答してその関数を呼び出す[ルール](eb-rules.md)を EventBridgeコンソール で作成します。

**Topics**
+ [ステップ 1: AWS CloudTrail 証跡を設定する](#eb-configure-trail)
+ [ステップ 2: AWS Lambda 関数を作成する](#eb-log-s3-create-lambda-function)
+ [ステップ 3: ルールを作成する](#eb-log-s3-create-rule)
+ [ステップ 4 : ルールをテストする](#eb-log-s3-test-rule)
+ [ステップ 5: 成功を確認する](#success)
+ [ステップ 6: リソースをクリーンアップする](#cleanup)

## ステップ 1: AWS CloudTrail 証跡を設定する
<a name="eb-configure-trail"></a>

S3 バケットのデータイベントを AWS CloudTrail および EventBridge に記録するには、まず証跡を作成します。*証跡*は、アカウントでの API コールと関連イベントをキャプチャし、指定した S3 バケットにログファイルを提供します。既存の証跡を更新するか、新しい証跡を作成できます。

詳細については、『*AWS CloudTrail ユーザーガイド*』の「[データイベント](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html#logging-data-events)」を参照してください。

**証跡を作成するには**

1. CloudTrail コンソールの [https://console.aws.amazon.com/cloudtrail/](https://console.aws.amazon.com/cloudtrail/) を開いてください。

1. [**Trails (証跡)**]、[**Create trail (証跡の作成)**] の順に選択します。

1. [**Trail name**] に、証跡の名前を入力します。

1. [**Storage Location**] (保存場所) の、[**Create a new S3 bucket**] (新しい S3 バケットを作成する) を実行します。

1. **AWS KMS のエイリアス**で、KMS キーのエイリアスを入力します。

1. [**次へ**] を選択します。

1. [**Event type**] (イベントタイプ) で [**Data events**] (データイベント) を選択します。

1. [**Data events**] (データイベント) で、次のいずれかの操作を実行します。
   + バケットのすべての Amazon S3 オブジェクトのデータイベントを記録するには、S3 バケットと空のプレフィックスを指定します。その バケットのオブジェクトでイベントが発生すると、証跡がイベントを処理して記録します。
   + 特定の Amazon S3 オブジェクトのデータイベントをバケットに記録するには、S3 バケットとオブジェクトのプレフィックスを指定します。そのバケットのオブジェクトでイベントが発生し、オブジェクトが指定したプレフィックスで始まっていると、証跡がイベントを処理して記録します。

1. 各リソースについて、ログ記録の対象を [**Read**] (読み取り) イベントにするか、[**Write**] (書き込み) イベントにするか、または両方のタイプのイベントにするかを選択します。

1. [**次へ**] を選択します。

1. **[追跡の作成]**を選択します。

## ステップ 2: AWS Lambda 関数を作成する
<a name="eb-log-s3-create-lambda-function"></a>

S3 バケットのデータイベントのログを記録する Lambda 関数を作成します。

**Lambda 関数を作成するには**

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

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

1. **Author from scratch** (製作者を最初から) を選択します。

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

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

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

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

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

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

## ステップ 3: ルールを作成する
<a name="eb-log-s3-create-rule"></a>

ステップ 2 で作成した Lambda 関数を実行するルールを作成します。このルールは、Amazon S3 データイベントに応答して実行されます。

**ルールを作成するには:**

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

1. ナビゲーションペインで **[ルール]** を選択します。

1. **[ルールの作成]** を選択します。

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

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

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

1. [**次へ**] を選択します。

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

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

   1. **[Event source]** (イベントソース) として、ドロップダウンリストから **[Simple Storage Service (S3)]** を選択します。

   1. **[Event type]** (イベントタイプ) では、ドロップダウンリストから **[Object-Level API Call via CloudTrail]** (CloudTrail 経由のオブジェクトレベル API 呼び出し) を選択します。

   1. **[Specific operation(s)]** (特定のオペレーション) を選択したら、**[PutObject]** を選択します。

   1. デフォルトでは、このルールはリージョン内のすべてのバケットのデータイベントと一致します。特定のバケットのデータイベントに一致させるには、[**特定のバケット (名前別)**] で指定し、1 つ以上のバケットを指定します。

1. [**次へ**] を選択します。

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

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

1. **[Function]** (関数) として、ステップ 1 で作成した `LogS3DataEvents` Lambda 関数を選択します。

1. [**次へ**] を選択します。

1. [**次へ**] を選択します。

1. ルールの詳細を確認し、**ルールの作成** を選択します。

## ステップ 4 : ルールをテストする
<a name="eb-log-s3-test-rule"></a>

ルールをテストするには、オブジェクトを S3 バケットに配置します。Lambda 関数が呼び出されたことを確認できます。

**Lambda 関数のログを表示するには**

1. CloudWatch コンソールの [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) を開いてください。

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

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

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

また、証跡に指定した S3 バケット内の CloudTrail ログを確認することもできます。詳細については、*AWS CloudTrail ユーザーガイド*の[CloudTrail ログファイルの取得と表示](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/get-and-view-cloudtrail-log-files.html)を参照してください。

## ステップ 5: 成功を確認する
<a name="success"></a>

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

## ステップ 6: リソースをクリーンアップする
<a name="cleanup"></a>

このチュートリアル用に作成したリソースは、保持しない場合は削除できます。使用しなくなった AWS リソースを削除することで、 AWS アカウントへの不要な課金を防ぐことができます。

**EventBridge ルールを削除するには**

1. Eventbridge コンソールの [[Rules](https://console.aws.amazon.com/events/home#/rules)] (ルール) ページを開きます。

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

1. [**Delete**] (削除) を選択します。

1. [**Delete**] (削除) を選択します。

**Lambda 関数を削除するには**

1. Lambda コンソールの [[関数]](https://console.aws.amazon.com/lambda/home#/functions) ページを開きます。

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

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

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

**CloudTrail 証跡を削除するには**

1. CloudTrail コンソールの [[Trails](https://console.aws.amazon.com/cloudtrail/home#/trails)] (追跡) ページを開きます。

1. 作成した証跡を選択します。

1. [**Delete**] (削除) を選択します。

1. [**Delete**] (削除) を選択します。