자습서: Amazon OpenSearch 서비스 EventBridge 이벤트 수신

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

필수 조건

이 자습서에서는 기존 OpenSearch 서비스 도메인이 있다고 가정합니다. 도메인을 생성하지 않았으면 아마존 OpenSearch 서비스 도메인 생성 및 관리에 있는 단계에 따라 도메인을 생성합니다.

1단계: Lambda 함수 생성

이 절차에서는 서비스 이벤트 메시지의 OpenSearch 대상으로 사용할 간단한 Lambda 함수를 생성합니다.

대상 Lambda 함수를 생성하려면

1. https://console.aws.amazon.com/lambda/ 에서 AWS Lambda 콘솔을 엽니다.

2. 함수 생성(Create function)과 새로 작성(Author from scratch)을 차례로 선택합니다.

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

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

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

6. 함수 코드(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 서비스에서 보낸 이벤트를 출력하는 간단한 Python 3.8 함수입니다. 모든 항목이 올바르게 구성된 경우 이 자습서의 마지막 부분에서 이 Lambda 함수와 관련된 CloudWatch 로그 로그 스트림에 이벤트 세부 정보가 표시됩니다.

7. 배포(Deploy)를 선택합니다.

2단계: 이벤트 규칙 등록

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

EventBridge 규칙을 만들려면

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

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

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

4. 다음(Next)을 선택합니다.

5. 이벤트 패턴으로 AWS 서비스, Amazon OpenSearch 서비스, 모든 이벤트를 선택합니다. 이 패턴은 모든 OpenSearch 서비스 도메인과 모든 OpenSearch 서비스 이벤트에 적용됩니다. 또는 더 한정적인 패턴을 만들어 일부 결과를 필터링할 수 있습니다.

6. 다음(Next)을 누릅니다.

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

8. 다음(Next)을 누릅니다.

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

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

3단계: 구성 테스트

다음에 OpenSearch 서비스 콘솔의 알림 섹션에서 알림을 수신할 때 모든 것이 올바르게 구성되면 Lambda 함수가 트리거되고 함수의 로그 로그 스트림에 CloudWatch 이벤트 데이터를 기록합니다.

구성을 테스트하려면

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

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

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