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

# チュートリアル: Amazon OpenSearch Service EventBridge イベントをリッスンする
<a name="listening-events"></a>

このチュートリアルでは、Amazon OpenSearch Service イベントをリッスンし、CloudWatch Logs ログストリームに書き込むシンプルな AWS Lambda 関数を設定します。

## 前提条件
<a name="listening-prereq"></a>

このチュートリアルは、既存の OpenSearch Service ドメインがあることを前提としています。ドメインをまだ作成していない場合は、1 つ作成するために「[Amazon OpenSearch Service ドメインの作成と管理](createupdatedomains.md)」の手順に従います。

## ステップ 1: Lambda 関数を作成する
<a name="listening-lambda"></a>

この手順では、OpenSearch Service イベントメッセージのターゲットとなるシンプルな Lambda 関数を作成します。

**ターゲットの Lambda 関数を作成するには**

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

1. [**Lambda 関数の作成**]、[**一から作成**] の順に選択します。

1. [**関数名**] では、**event-handler** と入力します。

1. [**ランタイム**] では、[**Python 3.8**] を選択します。

1. **[Create function]** を選択します。

1. [**関数コード**] セクションで、以下の例に一致するようにサンプルコードを編集します。

   ```
   import json
   
   def lambda_handler(event, context):
       if event["source"] != "aws.es":
           raise ValueError("Function only supports input from events with a source type of: aws.es")
   
       print(json.dumps(event))
   ```

   これは、OpenSearch Service から送信されたイベントを印刷するシンプルな Python 3.8 関数です。すべてが正しく設定されると、このチュートリアルの最後に、この Lambda 関数に関連付けられている CloudWatch Logs ログストリームにイベントの詳細が表示されます。

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

## ステップ 2: イベントルールを登録する
<a name="listening-rule"></a>

このステップでは、OpenSearch Service ドメインからイベントをキャプチャする EventBridge ルールを作成します。このルールでは、それが定義されているアカウント内のすべてのイベントがキャプチャされます。イベントメッセージ自体に、イベントソースに関する情報 (イベントソースの送信元ドメインの情報など) が含まれています。この情報を使用して、プログラムでイベントをフィルタリングおよびソートできます。

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

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

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

1. ルールに **event-rule** と名前を付けます。

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

1. イベントパターンの場合、[**AWS のサービス**]、[**Amazon OpenSearch Service**] 、[**すべてのイベント**] の順にクリックします。このパターンは、すべての OpenSearch Service ドメインおよびすべての OpenSearch Service イベントに適用されます。または、より具体的なパターンを作成し、一部の結果をフィルターで除外することもできます。

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

1. ターゲットに [**Lambda 関数**] を選択します。機能ドロップダウンで [**イベントハンドラ**] を選択します。

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

1. タグをスキップして [**次へ**] をクリックします。

1. 設定を確認して、[**ルールの作成**] を選択します。

## ステップ 3: 設定をテストする
<a name="listening-test"></a>

次回 OpenSearch Service コンソールの**通知**セクションで通知を受け取ったときに、すべてが適切に設定されている場合、Lambda 関数がトリガーされ、関数の CloudWatch Logs ログストリームにイベントデータが書き込まれます。

**設定をテストするには**

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

1. ナビゲーションペインで、[**ログ**] を選択して Lambda 関数 (**/aws/lambda/event-handler** など) のロググループを選択します。

1. イベントデータを表示するログストリームを選択します。