Amazon EventBridge를 사용하여 SES 이벤트 모니터링

EventBridge는 이벤트를 사용하여 애플리케이션 구성 요소를 서로 연결하는 서버리스 서비스로, 확장 가능한 이벤트 기반 애플리케이션을 더 쉽게 구축할 수 있습니다. 이벤트 기반 아키텍처는 이벤트를 내보내고 이에 응답하여 함께 작동하는 느슨하게 결합된 소프트웨어 시스템을 구축하는 스타일입니다. 이벤트는 일반적으로 리소스나 환경의 변경 또는 기타 관리 이벤트를 나타내는 JSON 형식의 메시지입니다.

특정 SES 특성은 이벤트 대상을 만들 때 정의하는 이벤트를 생성하고 EventBridge 기본 이벤트 버스로 전송합니다. 이벤트 버스는 이벤트를 수신하여 0개 이상의 목적지 또는 대상에 전달하는 라우터입니다. 이벤트 버스와 연결한 규칙은 이벤트가 도착할 때 이벤트를 평가합니다. 각 규칙은 이벤트가 규칙의 패턴과 일치하는지 확인합니다. 이벤트가 일치하면 EventBridge는 이벤트를 지정된 대상으로 보냅니다.

특성에 상태 변경 또는 상태 업데이트가 있으면 SES가 EventBridge로 이벤트를 전송합니다. EventBridge 규칙을 사용하여 이벤트를 정의된 대상으로 라우팅할 수 있습니다. 이러한 이벤트는 최선의 방식으로 전달되며 순서가 맞지 않게 전달될 수 있습니다.

SES 이벤트

다음 이벤트는 SES 특성에 의해 생성되어 EventBridge의 기본 이벤트 버스로 전송됩니다. 각 이벤트 유형의 세부 정보 데이터를 포함한 자세한 내용은 SES 이벤트 스키마 참조에서 확인하세요.

SES 이벤트 스키마 참조

AWS 서비스의 모든 이벤트에는 이벤트의 소스인 AWS 서비스, 이벤트가 생성된 시간, 이벤트가 발생한 계정 및 리전 등 이벤트에 대한 메타데이터가 포함된 공통 필드 세트가 있습니다. 이러한 일반 필드에 대한 정의는 EventBridge 사용 설명서의 이벤트 구조 참조를 참조하세요.

또한 각 이벤트에는 해당 특정 이벤트와 관련된 데이터를 포함하는 detail 필드가 있습니다. 다음 참조는 다양한 SES 이벤트에 대한 세부 정보 필드를 정의합니다.

EventBridge를 사용하여 SES 이벤트를 선택하고 관리할 때는 다음 사항을 염두에 두는 것이 유용합니다.

Virtual Deliverability Manager 어드바이저 상태 스키마

다음 스키마 참조는 Virtual Deliverability Manager 어드바이저 상태 이벤트와 관련된 필드를 정의합니다.

모든 이벤트 스키마(예:version, id, account 등)에 나타나는 일반 필드에 대한 정의는 EventBridge 사용 설명서의 이벤트 구조 참조에서 찾을 수 있습니다. source 및 detail-type 필드는 SES 이벤트에 대한 SES 관련 값을 포함하므로 다음 참조에 포함됩니다.

{
 "version": "0",
  "id": "abcd9999-ef33-0123-90ab-abcdef666666",
  "detail-type": "Advisor Recommendation Status Open",
  "source": "aws.ses",
  "account": "012345678901",
  "time": "2023-11-15T17:00:59Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:ses:us-east-1:012345678901:identity/vdm.events-publishing.cajun.syster-games.example.com"
  ],
  "detail": { "version": "1.0.0", "data": "SPF record was not found." }
}

SES 이메일 전송 상태 스키마

다음 스키마 참조는 SES 이메일 전송 상태 이벤트와 관련된 필드를 정의합니다.

모든 이벤트 스키마(예:version, id, account 등)에 나타나는 일반 필드에 대한 정의는 EventBridge 사용 설명서의 이벤트 구조 참조에서 찾을 수 있습니다. source 및 detail-type 필드는 SES 이벤트에 대한 SES 관련 값을 포함하므로 다음 참조에 포함됩니다.

{
  "version": "0",
  "id": "12a18625-3328-fafd-2809-a5e16004f112",
  "detail-type": "Email Rendering Failed",
  "source": "aws.ses",
  "account": "123456789012",
  "time": "2023-07-17T16:48:05Z",
  "region": "us-east-1",
  "resources": ["arn:aws:ses:us-east-1:123456789012:identity/example.com"],
  "detail": {
    "eventType": "Rendering Failure",
    "mail": {
      "timestamp": "2018-01-22T18:43:06.197Z",
      "source": "sender@example.com",
      "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
      "sendingAccountId": "123456789012",
      "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
      "destination": ["recipient@example.com"],
      "headersTruncated": false,
      "tags": {
        "ses:configuration-set": ["ConfigSet"]
      }
    },
    "failure": {
      "errorMessage": "Attribute 'attributeName' is not present in the rendering data.",
      "templateName": "MyTemplate"
    }
  }
}

SES 이벤트에 EventBridge 사용

기본적으로 SES는 EventBridge 기본 이벤트 버스로 이벤트를 보냅니다. 기본 이벤트 버스에 규칙을 만들어 EventBridge가 하나 이상의 지정된 대상으로 보낼 특정 이벤트를 식별할 수 있습니다. 각 규칙에는 이벤트가 이벤트 버스에 도착할 때 EventBridge가 이벤트를 일치시키는 데 사용하는 이벤트 패턴이 포함되어 있습니다. 이벤트가 지정된 규칙의 이벤트 패턴과 일치하면 EventBridge는 이벤트를 규칙에 지정된 대상으로 보냅니다.

EventBridge에서 이벤트 패턴을 정의하는 작업은 일반적으로 새 규칙을 만들거나 기존 규칙을 편집하는 대규모 프로세스의 일부입니다. EventBridge 규칙을 만드는 방법에 대한 자세한 정보는 EventBridge 사용 설명서의 이벤트에 대응하는 Amazon EventBridge 규칙 만들기를 참조하세요.

EventBridge의 샌드박스 특성을 사용하면 먼저 규칙을 만들거나 편집할 필요 없이 이벤트 패턴을 빠르게 정의하고 샘플 이벤트를 사용하여 패턴이 원하는 이벤트와 일치하는지 확인할 수 있습니다. 샌드박스 사용에 대한 자세한 지침은 EventBridge 사용 설명서의 EventBridge 샌드박스를 사용하여 이벤트 패턴 테스트를 참조하세요.

EventBridge 샌드박스에서 SES 샘플 이벤트 지정

SES 이벤트의 샘플 이벤트를 선택하여 생성한 이벤트 패턴을 테스트하는 데 사용할 수 있습니다.

SES 이벤트의 이벤트 패턴 생성 및 테스트

이전 섹션에서 설명했듯이 샘플 이벤트를 선택한 후에는 이벤트 패턴을 생성하고 샘플 이벤트를 사용하여 이벤트와 원하는 대로 일치하는지 확인할 수 있습니다.

추가 EventBridge 리소스

EventBridge를 사용하여 이벤트를 처리하고 관리하는 방법에 대한 자세한 내용은 Amazon EventBridge 사용 설명서의 다음 주제를 참조하세요.