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

# チュートリアル: Amazon EventBridge から Datadog にイベントを送信する
<a name="eb-tutorial-datadog"></a>

EventBridge を使用して、[https://www.datadoghq.com/](https://www.datadoghq.com/) などのサードパーティーサービスに[イベント](eb-events.md)を送信できます。

このチュートリアルでは、EventBridge コンソールを使用して、Datadog への接続、Datadog を指す [API 送信先](eb-api-destinations.md)、および Datadog にイベントを送信する [ルール](eb-rules.md)を作成します。

**Topics**
+ [前提条件](#eb-dd-prereqs)
+ [ステップ 1: 接続を作成する](#eb-dd-create-connection)
+ [ステップ 2: API 送信先を作成する](#eb-dd-api-destination)
+ [ステップ 3: ルールを作成する](#eb-dd-create-rule)
+ [ステップ 4: ルールをテストする](#eb-dd-test-rule)
+ [ステップ 5: リソースをクリーンアップする](#cleanup)

## 前提条件
<a name="eb-dd-prereqs"></a>

このチュートリアルを完了するには、以下のリソースが必要です。
+ [Datadog アカウント](https://www.datadoghq.com/free-datadog-trial/)。
+ [Datadog API キー](https://docs.datadoghq.com/account_management/api-app-keys/)。
+ EventBridge に対応した [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) バケット。

## ステップ 1: 接続を作成する
<a name="eb-dd-create-connection"></a>

Datadog にイベントを送信するには、まず、Datadog API への接続を確立する必要があります。

**接続を作成するには**

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

1. ナビゲーションペインで、[**API destinations**] (API 送信先) を選択します。

1. [**Connections (接続)**] タブを選択し、[**Create connection (接続の作成)**] を選択します。

1. 接続の名前と説明を入力します。例えば、名前として「**Datadog**」、説明として「**Datadog API Connection**」と入力します。

1. **[認証タイプ]** には **[API キー]** を選択します。

1. [**API key name (API キー名)**] に「**DD-API-KEY**」と入力します。

1. **[Value]** (値) に、Datadog シークレット API キーを貼り付けます。

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

## ステップ 2: API 送信先を作成する
<a name="eb-dd-api-destination"></a>

接続を作成したので、次に API 送信先を作成して、ルールの[ターゲット](eb-targets.md)として使用します。

**API 送信先を作成するには**

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

1. ナビゲーションペインで、[**API destinations**] (API 送信先) を選択します。

1. [**Create API destination**] (API 送信先の作成) を選択します。

1. API 送信先の名前と説明を入力します。この例では、名前には「**DatadogAD**」、説明には「**Datadog API Destination**」を入力します。

1. **[API 送信先エンドポイント]** には、「Datadog ログエンドポイント: **https://http-intake.logs.datadoghq.com/api/v2/logs**」を入力します。
**注記**  
このチュートリアルでは、イベントを Datadog ログに配信します。イベントエンドポイント: `https://api.datadoghq.com/api/v1/events` を使用して、Datadog にイベントを配信することもできます。

1. **[HTTP メソッド]** で、**[POST]** を選択します。

1. [**Invocation rate limit**] (呼び出しレート制限) には、「**300**」と入力します。

1. [**Connection**](接続) で、[**Use an existing connection**] (既存の接続を使用する) を選択し、手順 1 で作成した `Datadog` 接続を選択します。

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

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

次に、Amazon S3 オブジェクトが作成されたときにイベントを Datadog に送信するルールを作成します。

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

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

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

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

1. ルールの名前と説明を入力します。この例では、名前には「**DatadogRule**」、説明には「**Rule to send events to Datadog for S3 object creation**」を入力します。

1. **[Event bus]** (イベントバス) として、**[default]** (デフォルト) を選択します。

1. **[ルールタイプ]** では、**[イベントパターンを持つルール]** を選択します。

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

1. **[Event source]** (イベントソース) では、**[Other]** (その他) を選択します。

1. **[Event pattern]** (イベントパターン) では、次のように入力します。

   ```
   {
     "source": ["aws.s3"]
   }
   ```

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

1. **[Target types]** (ターゲットタイプ) として、**[EventBridge API destination]** (EventBridge API 送信先) を選択します。

1. **[API destination]** (API 送信先) として、**[Use an existing API destination]** (既存の API 送信先を使用する) を選択し、ステップ 2 で作成した `DatadogAD` 送信先を選択します。

1. **[Execution role]** (実行ロール) として、**[Create a new for role for this specific resource]** (この特定のリソースのための新しいロールを作成する) を選択します。

1. **[Additional settings]** (追加設定) では、以下を実行します。

   1. **ターゲット入力の設定**では、ドロップダウンリストから**[Input transformer]** (インプットトランスフォーマー) を選択します。

   1. **[Configure input transformer]** (インプットトランスフォーマーの設定) を選択します。

   1. **[Sample events]** (イベント例) では、以下を入力します。

      ```
      {
        "detail":[]
      }
      ```

   1. **[Target input transformer]** (ターゲットインプットトランスフォーマー) では、以下を実行します。

      1. **[Input Path]** (入力パス) では、以下を入力します。

         ```
         {"detail":"$.detail"}
         ```

      1. **[Input Template]** (入力テンプレート) では、以下を入力します。

         ```
         {"message": <detail>}
         ```

   1. **[Confirm]** (確認) を選択します。

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

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

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

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

ルールをテストするには、EventBridge 対応バケットにファイルをアップロードして [Amazon S3 オブジェクト](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html)を作成します。作成されたオブジェクトは Datadog Logs コンソールに記録されます。

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

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

**EventBridge 接続を削除するには**

1. Eventbridge コンソールの [[API destination](https://console.aws.amazon.com/events/home#/apidestinations)] (API 送信先) ページを開きます。

1. [**Connections (接続)**] タブを選択します。

1. 作成した接続を選択します。

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

1. 接続の名前を入力し、[**Delete**] (削除) を選択します。

**EventBridge API の送信先を削除するには**

1. Eventbridge コンソールの [[API destination](https://console.aws.amazon.com/events/home#/apidestinations)] (API 送信先) ページを開きます。

1. 作成した API の送信先を選択します。

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

1. API 送信先の名前を入力し、[**Delete**] (削除) を選択します。

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

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

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

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

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