기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 자습서: 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(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 대상**을 선택합니다.

1. **연결** 탭을 선택한 다음 **연결 생성**을 선택합니다.

1. 연결의 이름과 설명을 입력합니다. 예를 들어 **Datadog**를 이름으로 **Datadog API Connection**을 설명으로 입력합니다.

1. **권한 부여 유형**에서 **API 키**를 선택합니다.

1. **API 키 이름**에 **DD-API-KEY**를 입력합니다.

1. **값** 에 Datadog 비밀 API 키를 붙여넣습니다.

1. **생성(Create)**을 선택합니다.

## 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 대상**을 선택합니다.

1. **API 대상 생성**을 선택합니다.

1. API 대상에 대한 이름과 설명을 입력합니다. 예시에서는 이름에 **DatadogAD**를 입력하고 설명에 **Datadog API Destination**을 입력합니다.

1. **API 데스티네이션 엔드포인트**의 경우, Datadog Logs 엔드포인트(**https://http-intake.logs.datadoghq.com/api/v2/logs**)를 입력합니다.
**참고**  
이 자습서에서는 Datadog Logs에 이벤트를 전달합니다. 이벤트 엔드포인트(`https://api.datadoghq.com/api/v1/events`)를 사용하여 Datadog에 이벤트를 전달할 수도 있습니다.

1. **HTTP 메서드**에 대해 **POST**를 선택합니다.

1. **간접 호출 속도 제한**에는 **300**를 입력합니다.

1. **연결**에서 **기존 연결 사용**을 선택하고 1단계에서 만든 `Datadog` 연결을 선택합니다.

1. **생성(Create)**을 선택합니다.

## 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 Logs 콘솔에 기록됩니다.

## 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. **삭제**를 선택합니다.

1. **삭제**를 선택합니다.