AWS Database Migration Service에서 Amazon EventBridge 이벤트 및 알림 사용

Amazon EventBridge를 사용하여 AWS DMS 이벤트(복제 인스턴스 생성 또는 삭제 등)가 발생하면 알림을 제공할 수 있습니다. EventBridge는 이벤트를 수신하고 이벤트 규칙에 정의된 대로 이벤트 알림을 라우팅합니다. 특정 AWS 리전의 Amazon EventBridge에서 지원하는 모든 형식으로 이러한 알림을 사용할 수 있습니다. Amazon EventBridge 사용에 대한 자세한 내용은 Amazon EventBridge 사용 설명서에서 Amazon EventBridge란 무엇입니까?를 참조하세요.

참고

Amazon EventBridge 이벤트 사용은 AWS DMS 버전 3.4.5 이상에서 지원됩니다.

EventBridge는 AWS DMS 환경의 변화를 나타내는 지표인 이벤트를 수신하고 규칙을 적용하여 이벤트를 알림 메커니즘으로 라우팅합니다. 규칙은 이벤트의 구조(이벤트 패턴이라고 함)를 기반으로 이벤트를 알림 메커니즘과 일치시킵니다.

AWS DMS는 사용자가 이벤트 규칙에 적용할 수 있는 카테고리로 이벤트를 그룹화합니다. 따라서 사용자는 해당 카테고리의 이벤트가 발생했을 때 이에 대한 알림을 받을 수 있습니다. 예를 들어, 특정 복제 인스턴스의 생성 카테고리에 EventBridge 이벤트 규칙을 적용한다고 가정해 보겠습니다. 그러면 복제 인스턴스에 영향을 주는 생성 관련 이벤트가 발생할 때마다 알림을 받게 됩니다. 복제 인스턴스의 구성 변경 카테고리에 규칙을 적용하면 복제 인스턴스의 구성이 변경될 때마다 메시지가 수신됩니다. AWS DMS에서 제공하는 이벤트 카테고리의 목록은 아래의 AWS DMS 이벤트 카테고리 및 이벤트 메시지를 참조하세요.

참고

events.amazonaws.com로부터 게시를 허용하려면 Amazon SNS 주제의 액세스 정책을 업데이트해야 합니다. 자세한 내용은 Amazon EventBridge 사용 설명서의 Amazon EventBridge에 대한 리소스 기반 정책 사용을 참조하세요.

이벤트 구독을 Amazon EventBridge로 이전하는 방법에 대한 자세한 내용은 활성 이벤트 구독을 DMS에서 Amazon EventBridge로 마이그레이션을 참조하세요.

Amazon SNS 문자 메시지 사용에 대한 자세한 내용은 Amazon SNS를 사용한 SMS 알림 메시지 전송 및 수신을 참조하세요.

AWS DMS에서 Amazon EventBridge 이벤트 규칙 사용

Amazon EventBridge는 사용자가 EventBridge 이벤트 규칙을 생성할 때 입력한 주소로 이벤트 알림을 보냅니다. 여러 가지 규칙을 생성할 수 있습니다. 예를 들어 모든 이벤트 알림 메시지를 수신하는 하나의 규칙과 프로덕션 DMS 리소스의 중요 이벤트만 포함하는 다른 규칙을 생성할 수 있습니다. EventBridge에서 이벤트 알림을 활성화 또는 비활성화할 수도 있습니다.

AWS DMS 이벤트에 응답하는 Amazon EventBridge 규칙을 생성하려면

• Amazon EventBridge 사용 설명서의 이벤트에 응답하는 Amazon EventBridge 규칙 생성에 설명된 단계를 수행하고 AWS DMS 이벤트에 대한 규칙을 생성합니다.

  1. EventBridge가 규칙의 이벤트 패턴과 일치하는 이벤트를 수신할 때 수행할 작업을 지정합니다. 이벤트가 일치하면 EventBridge는 이벤트를 전송하고 규칙에 정의된 작업을 간접 호출합니다.

  2. 서비스 제공업체에서 AWS를 선택합니다.

  3. 서비스 이름에서 Server Migration Service (SMS)를 선택합니다.

이제부터 이벤트 알림 메시지를 수신할 수 있습니다.

다음 JSON 예제는 AWS DMS 서비스에 대한 EventBridge 이벤트 모델을 보여줍니다.

{
   "version":"0",
   "id":"11a11b11-222b-333a-44d4-01234a5b67890",
   "detail-type":"DMS Replication Task State Change",
   "source":"aws.dms",
   "account":"0123456789012",
   "time":"1970-01-01T00:00:00Z",
   "region":"us-east-1",
   "resources":[
      "arn:aws:dms:us-east-1:012345678901:task:AAAABBBB0CCCCDDDDEEEEE1FFFF2GGG3FFFFFF3"
   ],
   "detail":{
      "type":"REPLICATION_TASK",
      "category":"StateChange",
      "eventType":"REPLICATION_TASK_STARTED",
      "eventId":"DMS-EVENT-0069",
      "resourceLink":"https://console.aws.amazon.com/dms/v2/home?region=us-east-1#taskDetails/taskName",
      "detailMessage":"Replication task started, with flag = fresh start"
   }
}

      

알림을 받을 수 있는 카테고리와 이벤트 목록은 다음 섹션을 참조하세요.

AWS DMS 이벤트 범주 및 이벤트 메시지

AWS DMS는 사용자가 식별할 수 있는 이벤트 카테고리를 다수 생성합니다. 각 카테고리는 복제 인스턴스 또는 복제 태스크 소스 형식에 적용됩니다.

복제 인스턴스 이벤트 메시지

다음 표에는 복제 인스턴스 소스 유형에서 가능한 카테고리 및 이벤트가 나와 있습니다.

범주	이벤트 ID	설명
생성	DMS-EVENT-0067	복제 인스턴스를 생성 중입니다.
삭제	DMS-EVENT-0066	복제 인스턴스를 삭제 중입니다.
구성 변경	DMS-EVENT-0012	이 복제 인스턴스의 복제 인스턴스 클래스가 변경되고 있습니다.
구성 변경	DMS-EVENT-0018	복제 인스턴스의 스토리지가 증가하고 있습니다.
구성 변경	DMS-EVENT-0024	복제 인스턴스가 다중 AZ 구성으로 전환 중입니다.
구성 변경	DMS-EVENT-0030	복제 인스턴스가 단일 AZ 구성으로 전환 중입니다.
유지 관리	DMS-EVENT-0026	복제 인스턴스의 오프라인 유지 관리가 진행 중입니다. 현재 복제 인스턴스를 사용할 수 없습니다.
생성	DMS-EVENT-0005	복제 인스턴스를 생성 중입니다.
삭제	DMS-EVENT-0003	복제 인스턴스가 삭제되었습니다.
구성 변경	DMS-EVENT-0014	이 복제 인스턴스의 복제 인스턴스 클래스가 변경되었습니다.
구성 변경	DMS-EVENT-0017	복제 인스턴스의 스토리지가 증가되었습니다.
구성 변경	DMS-EVENT-0025	복제 인스턴스가 다중 AZ 구성으로 전환이 완료되었습니다.
구성 변경	DMS-EVENT-0029	복제 인스턴스가 단일 AZ 구성으로 전환이 완료되었습니다.
유지 관리	DMS-EVENT-0047	복제 인스턴스의 관리 소프트웨어가 업데이트되었습니다.
유지 관리	DMS-EVENT-0027	복제 인스턴스의 오프라인 유지 관리가 완료되었습니다. 이제 복제 인스턴스를 사용할 수 있습니다.
유지 관리	DMS-EVENT-0068	복제 인스턴스가 업그레이드할 수 없는 상태입니다.
장애 조치	DMS-EVENT-0034	장애 조치를 너무 자주 요청하면 일반 장애 조치 이벤트 대신 이 이벤트가 발생합니다.
결함	DMS-EVENT-0031	복제 인스턴스가 %s 상태로 전화되었습니다.
결함	DMS-EVENT-0036	호환되지 않는 네트워크로 인해 복제 인스턴스에 장애가 발생했습니다.
결함	DMS-EVENT-0037	서비스가 데이터 볼륨을 암호화하는 데 사용된 KMS 키에 액세스할 수 없습니다.
결함		복제 인스턴스에서 호환되지 않는 파라미터를 사용했습니다.
장애 조치		안전한 상태에서 사용자 요청 장애 조치를 시작하기 위한 대기 시간이 초과되었습니다.
장애 조치	DMS-EVENT-0013	다중 AZ 복제 인스턴스에서 장애 조치가 시작되었습니다.
장애 조치	DMS-EVENT-0049	다중 AZ 복제 인스턴스에서 장애 조치가 완료되었습니다.
장애 조치	DMS-EVENT-0050	다중 AZ 활성화가 시작되었습니다.
장애 조치	DMS-EVENT-0051	다중 AZ 활성화가 완료되었습니다.
StateChange		일반 및 느린 쿼리 로그가 자동으로 %s(으)로 전환되었습니다.
StateChange		AWS DMS가 애플리케이션 인스턴스 %s의 KMS 암호화 키에 액세스할 수 없습니다. 키가 비활성화되었거나 AWS DMS가 액세스할 수 없기 때문일 수 있습니다. 이 상태가 계속되면 애플리케이션이 액세스할 수 없음 상태가 됩니다. 자세한 내용은 AWS DMS 설명서의 문제 해결 섹션을 참조하세요.
StateChange		AWS DMS가 이제 애플리케이션 인스턴스 %s의 KMS 암호화 키에 액세스할 수 있습니다.
StateChange		Amazon DMS가 애플리케이션 인스턴스 %s의 KMS 암호화 키에 액세스할 수 없습니다. 이 애플리케이션은 액세스할 수 없음 상태가 됩니다. 자세한 내용은 Amazon RDS 설명서의 문제 해결 섹션을 참조하세요.
StateChange		복제 인스턴스 생성의 일환으로 HM에서 앱을 다시 시작
StateChange		복제 인스턴스 삭제의 일환으로 HM에서 앱을 종료
장애 조치	DMS-EVENT-0015	스탠바이로의 다중 AZ 장애 조치.
LowStorage	DMS-EVENT-0007	복제 인스턴스의 여유 스토리지가 부족합니다.
LowStorage		할당된 inode가 모두 소진되었습니다. 해결하려면 스토리지 규모를 조정해야 합니다.

복제 태스크 이벤트 메시지

다음 표에는 복제 태스크 소스 유형에서 가능한 카테고리 및 이벤트가 나와 있습니다.

범주	이벤트 ID	설명
결함	DMS-EVENT-0078	복제 태스크가 실패했습니다.
결함	DMS-EVENT-0082	태스크 데이터 정리 호출이 실패했습니다.
상태 변경	DMS-EVENT-0081	테이블 세부 정보 다시 로드가 요청되었습니다.
상태 변경		복제 태스크가 복사되었습니다.
상태 변경		복제 태스크 복사가 실패했습니다.
상태 변경		복제 태스크가 이동되었습니다.
상태 변경		복제 상태 이동이 실패했습니다.
상태 변경		대상 태스크를 생성하지 못했습니다.
상태 변경		복제 태스크 평가 실행이 시작되었습니다.
상태 변경		복제 태스크 평가 실행이 성공적으로 완료되었습니다.
상태 변경		복제 태스크 평가 실행이 완료되었지만 실패했습니다.
StateChange		복제 태스크 평가 실행이 경고와 함께 완료되었습니다.
StateChange		복제 태스크 평가 실행이 오류와 함께 완료되었습니다.
StateChange		복제 태스크 평가 실행 %s이(가) 취소되었습니다.
StateChange		복제 태스크 평가 실행 %s이(가) 삭제되었습니다.
StateChange		복제 태스크 평가 실행이 리소스를 프로비저닝하지 못했습니다.
StateChange		복제 태스크가 실패했습니다.
생성		복제 태스크가 생성되었습니다.
ConfigurationChange		복제 태스크가 수정되었습니다.
결함		복제 태스크가 실패했습니다.
StateChange	DMS-EVENT-0091	읽기가 일시 중지되었습니다. 스왑 파일 한도에 도달했습니다.
StateChange	DMS-EVENT-0092	읽기가 일시 중지되었습니다. 디스크 사용량 한도에 도달했습니다.
StateChange	DMS-EVENT-0093	읽기가 일시 중지되었습니다. 디스크 사용량 한도에 도달했습니다.
StateChange	DMS-EVENT-0093	읽기가 다시 시작되었습니다.
StateChange	DMS-EVENT-0069	복제 태스크가 다음 설정으로 시작되었습니다. taskType: %s, startType: %s
StateChange	DMS-EVENT-0079	복제 태스크가 중지되었습니다.
삭제	DMS-EVENT-0073	복제 태스크가 삭제되었습니다.

복제 이벤트 메시지

다음 표에는 복제 소스 유형에서 가능한 카테고리 및 이벤트가 나와 있습니다.

범주	설명
상태 변경	DMS 복제 스케일 업 이벤트.
상태 변경	DMS 복제 스케일 다운 이벤트.
상태 변경	DMS 복제 규모 조정 이벤트가 완료되었습니다.
상태 변경	DMS 복제가 생성되었습니다.
상태 변경	DMS 복제가 초기화되고 있습니다.
상태 변경	DMS 복제가 메타데이터 수집을 위한 리소스를 준비하고 있습니다.
상태 변경	DMS 복제에 연결된 연결을 테스트 중입니다.
상태 변경	DMS 복제가 메타데이터를 가져오는 중입니다.
상태 변경	DMS 복제가 용량을 계산하는 중입니다.
상태 변경	DMS 복제가 용량을 프로비저닝하는 중입니다.
상태 변경	DMS 복제가 프로비저닝되었습니다.
상태 변경	DMS 복제가 시작되었습니다.
상태 변경	DMS 복제가 실행 중입니다.
상태 변경	DMS 복제가 중지 중입니다.
상태 변경	DMS 복제가 중지되었습니다.
상태 변경	DMS 복제가 수정되고 있습니다.
상태 변경	DMS 복제를 삭제 중입니다.
상태 변경	DMS 복제가 용량을 프로비저닝 해제하는 중입니다.
상태 변경	DMS 복제가 프로비저닝 해제되었습니다.
결함	DMS 복제가 실패했습니다.