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

# 자습서: Amazon OpenSearch Service EventBridge 이벤트 수신
<a name="listening-events"></a>

이 자습서에서는 Amazon OpenSearch Service 이벤트를 수신 대기하고 CloudWatch Logs 로그 스트림에 쓰는 간단한 AWS Lambda 함수를 설정합니다.

## 사전 조건
<a name="listening-prereq"></a>

이 자습서에서는 사용자가 기존 OpenSearch Service 도메인을 가지고 있다고 가정합니다. 도메인을 생성하지 않았으면 [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. **함수 생성(Create function)**과 **새로 작성(Author from scratch)**을 차례로 선택합니다.

1. **함수 이름(Function name)**에 **event-handler**를 입력합니다.

1. **런타임**에서 **Python 3.8**을 선택합니다.

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

1. **함수 코드(Function code)** 섹션에서 다음 예제와 일치하도록 샘플 코드를 수정합니다.

   ```
   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. **배포(Deploy)**를 선택합니다.

## 2단계: 이벤트 규칙 등록
<a name="listening-rule"></a>

이 단계에서는 OpenSearch Service 도메인에서 이벤트를 캡처하는 EventBridge 규칙을 생성합니다. 이 규칙은 규칙이 정의된 계정 내의 모든 이벤트를 캡처합니다. 이벤트 메시지 자체에 작업이 시작된 도메인을 포함하여 이벤트 소스에 대한 정보가 포함됩니다. 이 정보를 사용하여 프로그래밍 방식으로 이벤트를 필터링하고 정렬할 수 있습니다.

**EventBridge 규칙을 생성하려면** 

1. [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)에서 EventBridge 콘솔을 엽니다.

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

1. 규칙 이름을 **event-rule**로 지정합니다.

1. **다음(Next)**을 선택합니다.

1. 이벤트 패턴에서 **AWS services**, **Amazon OpenSearch Service**, **All Events**(모든 이벤트)를 선택합니다. 이 패턴은 모든 OpenSearch Service 도메인과 모든 OpenSearch Service 이벤트에 적용됩니다. 또는 더 한정적인 패턴을 만들어 일부 결과를 필터링할 수 있습니다.

1. **다음(Next)**을 누릅니다.

1. 대상에서 **Lambda 함수(Lambda function)**를 선택합니다. 함수 드롭다운에서 **event-handler**를 선택합니다.

1. **다음(Next)**을 누릅니다.

1. 태그를 건너뛰고 **다음(Next)**을 다시 누릅니다.

1. 구성을 살펴본 후 **규칙 생성(Create rule)**을 선택합니다.

## 3단계: 구성 테스트
<a name="listening-test"></a>

다음에 OpenSearch Service 콘솔의 **알림** 섹션에서 알림을 받을 때, 모두 제대로 구성된 경우 Lambda 함수가 트리거되고 해당 함수에 대한 CloudWatch Logs 로그 스트림에 이벤트 데이터를 기록합니다.

**구성을 테스트하려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **로그(Logs)**를 선택하고 Lambda 함수의 로그 그룹을 선택합니다(예: **/aws/lambda/event-handler**).

1. 이벤트 데이터를 보려면 로그 스트림을 선택합니다.