AWS EventBridge에 트리거 이벤트 전송
이 페이지의 내용
개요
MongoDB는 AWS Eventbridge 를 제공합니다. Atlas Function을 호출하는 대신 Atlas Trigger 이벤트를 이벤트 버스로 보낼 수 있는 파트너 이벤트 소스입니다. EventBridge로 이벤트를 전송하도록 모든 트리거 유형을 구성할 수 있습니다. 데이터베이스 트리거는 사용자 지정 오류 처리도 지원하여 중요하지 않은 오류로 인한 트리거 일시 중단을 줄입니다.
trigger 이벤트를 EventBridge로 전송하기 위해서는 Amazon Web Services 계정 ID가 필요합니다. 이 가이드에서는 계정 ID 찾기, trigger 구성, trigger 이벤트 소스를 이벤트 버스와 연결하고 사용자 지정 오류 처리를 설정하는 과정을 안내합니다.
참고
공식 AWS 파트너 이벤트 소스 가이드
이 가이드는 Amazon의 SaaS 파트너로부터 이벤트 수신 을 기반으로 합니다. 문서화.
절차
참고
EventBridge 트리거 이벤트에 대한 AWS 풋 엔트리는 256KB보다 작아야 합니다.
성능 최적화 섹션에서 PutEvents 항목의 크기를 줄이는 방법을 알아보세요.
MongoDB 제휴하다 이벤트 소스 설정
트리거 이벤트를 AWS EventBridge로 전송하려면 이벤트를 수신해야 AWS account ID 하는 계정의 이(가) 필요합니다. Amazon EventBridge 콘솔 Partner event sources 열기 탐색 메뉴에서 을(를) 클릭합니다.MongoDB 파트너 이벤트 소스를 검색한 다음 을(를)Set up 클릭합니다.
MongoDB 0} 파트너 이벤트 Copy 소스 페이지에서 을 클릭하여 AWS 계정 ID를 클립보드에 복사합니다.
트리거 구성
AWS account ID가 있으면 이벤트를 EventBridge로 전송하도록 트리거를 구성할 수 있습니다.
참고
지원되는 AWS 지역
지원되는 AWS 리전의 전체 목록은 Amazon의 SaaS 파트너로부터 이벤트 수신 하기를 참조하세요. 가이드.
트리거 이벤트 소스를 이벤트 버스에 연결하기
EventBridge 콘솔로 돌아가서 탐색 창에서 파트너 이벤트 소스를 선택합니다. Partner event sources 테이블에서 Pending 트리거 소스를 찾아 선택한 다음 Associate with event bus를 클릭합니다.
Associate with event bus 화면에서 다른 계정 및 조직에 필요한 액세스 권한을 정의한 다음 Associate를 클릭합니다.
확인되면 트리거 이벤트 소스의 상태가 Pending 에서 로 Active 변경되고 이벤트 버스의 이름이 이벤트 소스 이름과 일치하도록 업데이트됩니다. 이제 해당 파트너 이벤트 소스의 이벤트에 대해 트리거되는 규칙 만들기를 시작할 수 있습니다. 자세한 내용 은 SaaS 파트너 이벤트에서 트리거하는 규칙 생성을 참조하세요.
사용자 지정 오류 처리
참고
데이터베이스 트리거만 사용자 지정 오류 처리기 지원
현재는 데이터베이스 트리거만 사용자 지정 오류 처리를 지원합니다. 인증 트리거와 예약된 트리거는 현재 사용자 지정 오류 처리를 지원하지 않습니다.
재시도에 성공하지 못한 경우 트리거 실패 시 실행할 오류 핸들러를 만들 수 있습니다. 사용자 지정 오류 처리를 사용하면 AWS EventBridge의 오류가 트리거를 일시 중단할 만큼 심각한지, 또는 오류를 무시하고 다른 이벤트를 계속 처리할 수 있는지 확인할 수 있습니다. 일시 중단된 데이터베이스 트리거에 대한 자세한 내용은 일시 중단된 트리거를 참조하세요 .
새 사용자 지정 오류 처리기 만들기
오류 핸들러 매개변수
기본 오류 핸들러에는 error 및 changeEvent 라는 두 개의 매개 변수가 있습니다.
error
다음과 같은 두 가지 속성이 있습니다.
code: 오류가 발생한 EventBridge 넣기 요청의 코드입니다. 오류 핸들러에서 사용하는 오류 코드 목록은 아래 섹션을 참조하세요.message: 오류가 발생한 EventBridge 넣기 요청의 필터링되지 않은 오류 메시지입니다.
changeEvent
EventBridge에서 요청한 데이터 변경 사항입니다. 변경 이벤트의 유형과 해당 구성에 대한 자세한 내용은 변경 이벤트 유형을 참조하세요.
오류 코드
EventBridge에서 오류를 받은 경우 이벤트 프로세서는 오류를 DOCUMENT_TOO_LARGE 또는 OTHER 로 구문 분석합니다. 이 구문 분석된 오류는 error 매개변수를 통해 오류 핸들러 함수로 전달됩니다.
DOCUMENT_TOO_LARGE
EventBridge trigger 이벤트에 대한 넣기 항목이 256KB보다 큰 경우 EventBridge에서 오류가 발생합니다. 오류에는 다음 중 하나가 포함됩니다.
상태 코드: 400 및
total size of the entries in the request is over the limit.상태 코드: 413, 이는 페이로드가 너무 큽니다.
풋 항목 크기를 줄이는 방법에 대한 자세한 내용은 아래의 성능 최적화 섹션을 참조하세요.
OTHER
다른 모든 오류에 대한 기본 버킷입니다.
팁
기타 코드가 있는 오류에 대한 오류 처리 최적화
OTHER 코드가 있는 오류에 대한 오류 처리를 최적화하기 위해 가장 일반적인 오류 메시지에 대한 특수 오류 처리 사례를 만들 수 있습니다. 어떤 오류에 특별한 사례가 필요한지 확인하려면 error.message 에서 가장 일반적인 오류 메시지를 추적하는 것이 좋습니다.
오류 핸들러 로그
애플리케이션 로그에서 EventBridge 트리거 오류 핸들러에 대한 트리거 오류 핸들러 로그 를 볼 수 있습니다.
애플리케이션 로그 보기에 대해 자세히 알아보려면 애플리케이션 로그 보기를 참조하세요.
이벤트 예시
다음 객체는 AWS Eventbridge로 이벤트를 전송하고 오류를 처리하도록 트리거를 구성합니다.
"event_processors": { "AWS_EVENTBRIDGE": { "config": { "account_id": "012345678901", "region": "us-east-1" } } }, "error_handler": { "config": { "enabled": true, "function_name": "myErrorHandler.js" } }
성능 최적화
EventBridge 트리거 이벤트에 대한 AWS 풋 엔트리는 256KB보다 작아야 합니다.
자세한 내용은 Amazon PutEvents 이벤트 항목 크기 계산에 대한 AWS 설명서를 참조하세요.
데이터베이스 트리거를 사용할 때 프로젝트 표현식을 사용하면 EventBridge로 메시지를 보내기 전에 문서 크기를 줄이는 데 유용할 수 있습니다. 이 표현식을 사용하면 지정된 필드만 포함시켜 문서 크기를 줄일 수 있습니다.