本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 教程：从 Amazon EventBridge 向 Datadog 发送事件
<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. 选择**连接**选项卡。

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. 选择 **Delete**。

1. 选择 **Delete**。