本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 教學課程：Datadog從 Amazon EventBridge 將事件傳送至
<a name="eb-tutorial-datadog"></a>

您可以使用 EventBridge 將[事件](eb-events.md)路由傳送至第三方服務，例如：[https://www.datadoghq.com/](https://www.datadoghq.com/)。

在本教學課程中，您將使用 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. 前往 [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) 開啟 Amazon EventBridge 主控台。

1. 在導覽窗格中，選擇 **API 目的地**。

1. 選擇**連線**標籤，然後選擇**建立連線**。

1. 輸入連線的名稱和描述。例如，輸入 **Datadog** 作為名稱並輸入 **Datadog API Connection** 作為描述。

1. 針對**授權類型**，請選擇 **API 金鑰**。

1. 針對 **API 名稱**，請輸入 **DD-API-KEY**。

1. 針對**值**，請貼上您的 Datadog 秘密 API 金鑰。

1. 選擇**建立**。

## 步驟 2：建立 API 目的地
<a name="eb-dd-api-destination"></a>

由於您已建立連線，接下來您將建立要用作規則[目標](eb-targets.md)的 API 目的地。

**建立 API 目的地**

1. 前往 [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) 開啟 Amazon EventBridge 主控台。

1. 在導覽窗格中，選擇 **API 目的地**。

1. 選擇**建立 API 目的地**。

1. 針對 API 目的地，輸入名稱和描述。例如，輸入 **DatadogAD** 作為名稱，**Datadog API Destination** 作為描述。

1. 針對 **API 目的地端點**，輸入Datadog日誌端點：**https://http-intake.logs.datadoghq.com/api/v2/logs**。
**注意**  
本教學課程會將事件交付至 Datadog 日誌。您也可以Datadog使用事件端點將事件交付至 ：`https://api.datadoghq.com/api/v1/events`。

1. 針對 **HTTP 方法**，請選擇 **POST**。

1. 針對**調用率限制**，请輸入 **300**。

1. 針對**連線**，選擇**使用現有連線**並選擇您在步驟 1 中建立的 `Datadog` 連線。

1. 選擇**建立**。

## 步驟 3：建立規則
<a name="eb-dd-create-rule"></a>

接下來，您將建立一個規則，在建立 Amazon S3 物件時，將事件傳送至 Datadog。

**建立規則**

1. 前往 [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) 開啟 Amazon EventBridge 主控台。

1. 在導覽窗格中，選擇**規則**。

1. 選擇**建立規則**。

1. 輸入規則的名稱和描述。例如，輸入 **DatadogRule** 作為名稱，**Rule to send events to Datadog for S3 object creation** 作為描述。

1. 針對**事件匯流排**選擇**預設值**。

1. 針對**規則類型**選擇**具有事件模式的規則**。

1. 選擇**下一步**。

1. 在**事件來源**中，選擇**其他**。

1. 針對**事件模式**，請輸入：

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

1. 選擇**下一步**。

1. 針對**目標類型**，請選擇 **EventBridge API 目的地**。

1. 針對 **API 目的地**，請選擇**使用現有的 API 目的地**，然後選擇您在步驟 2 中建立的 `DatadogAD` 目的地。

1. 針對**執行角色**，請選擇**為此特定資源建立新角色**。

1. 針對**其他設定**，請執行下列動作：

   1. 針對**設定目標輸入**，請從下拉式清單中選擇**輸入轉換器**。

   1. 選擇**設定輸入轉換器**。

   1. 針對**範例事件**，請輸入以下內容：

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

   1. 針對**目標輸入轉換器**，請執行下列動作：

      1. 針對**輸入路徑**，請輸入以下內容：

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

      1. 針對**輸入範本**，請輸入以下內容：

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

   1. 選擇**確認**。

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 日誌主控台中。

## 步驟 5：清除您的資源
<a name="cleanup"></a>

除非您想要保留為此教學課程建立的資源，否則您現在便可刪除。透過刪除您不再使用 AWS 的資源，您可以避免 AWS 帳戶產生不必要的費用。

**若要刪除 EventBridge 連線**

1. 開啟 EventBridge 主控台的 [API 目的地頁面](https://console.aws.amazon.com/events/home#/apidestinations)。

1. 選擇 **Connections (連線)** 索引標籤。

1. 選取您建立的連線。

1. 選擇**刪除**。

1. 輸入連線名稱並選擇**刪除**。

**若要刪除 EventBridge API 目的地**

1. 開啟 EventBridge 主控台的 [API 目的地頁面](https://console.aws.amazon.com/events/home#/apidestinations)。

1. 選取您建立的 API 目的地。

1. 選擇**刪除**。

1. 輸入 API 目的地的名稱並選擇**刪除**。

**刪除 EventBridge 規則**

1. 開啟 EventBridge 主控台的[規則頁面](https://console.aws.amazon.com/events/home#/rules)。

1. 選取您建立的規則。

1. 選擇**刪除**。

1. 選擇**刪除**。