기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon DocumentDB 이벤트 구독 사용
Amazon DocumentDB는 Amazon Simple Notification Service(SNS)를 사용하여 Amazon DocumentDB 이벤트 발생 시 알림을 제공합니다. 이러한 알림은 이메일 AWS 리전, 문자 메시지 또는 HTTP 엔드포인트 호출과 같이에 대해 Amazon SNS에서 지원하는 모든 형식일 수 있습니다.
Amazon DocumentDB는 이러한 이벤트를 가입할 수 있는 카테고리로 그룹화하여 해당 카테고리의 이벤트가 발생할 때 알림을 받을 수 있도록 합니다. 구독 가능한 이벤트 범주로는 DB 인스턴스, DB 클러스터, DB 스냅샷, DB 클러스터 스냅샷, DB 파라미터 그룹, DB 보안 그룹 등이 있습니다. 예를 들어 임의의 DB 인스턴스에 대한 Backup 카테고리를 구독할 경우 백업 관련 이벤트가 발생하여 DB 인스턴스에 영향을 끼칠 때마다 알림 메시지가 수신됩니다. 또한 이벤트 알림 메시지 구독이 변경되어도 알림 메시지가 수신됩니다.
이벤트는 클러스터와 인스턴스 수준에서 모두 발생하므로 클러스터나 인스턴스에 가입하면 이벤트를 수신할 수 있습니다.
이벤트 알림 메시지는 구독 생성 시 입력한 주소로 보내집니다. 모든 이벤트 알림을 받는 구독과 프로덕션 인스턴스에 대한 중요한 이벤트만 포함하는 다른 구독 등 여러 가지 구독을 생성할 수 있습니다. 구독을 삭제하지 않고도 알림을 쉽게 끌 수 있습니다. 이렇게 하려면 Amazon DocumentDB 콘솔에서 **활성화** 라디오 버튼을 **아니오**로 설정하세요.
**중요**
Amazon DocumentDB는 이벤트 스트림에서 전송되는 이벤트 순서를 보장하지 않습니다. 이벤트 순서는 변경될 수 있습니다.
Amazon DocumentDB는 Amazon SNS 주제의 Amazon 리소스 이름(ARN)을 사용하여 각 구독을 식별합니다. 구독을 작성할 때 Amazon DocumentDB 콘솔이 ARN을 작성합니다.
Amazon DocumentDB 이벤트 구독에 대한 청구는 Amazon SNS를 통해 이루어집니다. Amazon SNS 요금은 이벤트 알림 사용 시 적용됩니다. 자세한 내용은 Amazon Simple Notification Service Pricing을 참조하세요. 아마존 Amazon SNS 요금 외에 이벤트 구독료는 Amazon DocumentDB에서 청구하지 않습니다.
**Topics**
+ [이벤트 구독](event-subscriptions.subscribe.md)
+ [구독 관리](event-subscriptions.managing.md)
+ [범주 및 메시지](event-subscriptions.categories-messages.md)
# Amazon DocumentDB 이벤트 구독
Amazon DocumentDB 콘솔을 사용하여 다음과 같이 이벤트 구독을 구독할 수 있습니다:
1. 에서에 로그인 AWS Management Console 합니다[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. 탐색 창에서 [**이벤트 구독**]을 선택합니다.
![\[이벤트 구독 옵션이 강조 표시된 Amazon DocumentDB 콘솔 탐색 창입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/subscribe-event-subs.png)
1. **이벤트 구독** 창에서 **이벤트 구독 생성**을 선택합니다.
![\[오른쪽 상단의 이벤트 구독 생성 버튼을 강조 표시하는 이벤트 구독 창입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/subscribe-create.png)
1. [**Create event subscription**] 대화 상자에서 다음과 같이 실행합니다.
+ **이름**에서 이벤트 알림 구독 이름을 입력합니다.
![\[세부 정보 섹션과 이름 입력 필드를 보여주는 이벤트 구독 생성 양식입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/subscribe-name.png)
+ **대상**에서, 알림을 전송할 위치를 선택합니다. 기존의 **ARN**을 선택하거나 **새 이메일 토픽**을 선택하여 주제의 이름과 수신인 목록을 입력할 수 있습니다.
![\[알림을 보낼 위치를 지정하는 옵션이 있는 대상 섹션입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/subscribe-target.png)
+ **소스**에서 소스 유형을 선택합니다. 선택한 원본 유형에 따라 이벤트 범주와 이벤트 알림을 수신할 원본을 선택합니다.
![\[이벤트 알림을 받을 소스 유형을 선택하는 소스 섹션입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/subscribe-source.png)
+ **생성(Create)**을 선택합니다.
![\[오른쪽 하단 모서리에 있는 생성 버튼이 있는 소스 섹션입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/subscribe-create-2.png)
# Amazon DocumentDB 이벤트 알림 구독 관리
Amazon DocumentDB 콘솔의 탐색 창에서 **이벤트 구독** 을 선택하면 구독 범주와 현재 구독 목록을 볼 수 있습니다. 특정 구독을 수정하거나 삭제할 수도 있습니다.
## 현재 Amazon DocumentDB 이벤트 알림 구독을 수정하려면 다음과 같이 하세요
1. 에서에 로그인 AWS Management Console 합니다[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. 탐색 창에서 [**Event subscriptions**]를 선택합니다. [**Event subscriptions**] 창에 이벤트 알림 구독이 모두 표시됩니다.
![\[이벤트 구독 옵션이 강조 표시된 Amazon DocumentDB 콘솔 탐색 창입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/modify-event-subs.png)
1. [**Event subscriptions**] 창에서 수정할 구독을 선택한 다음 [**Edit**]를 선택합니다.
![\[선택한 구독과 편집 버튼이 표시된 이벤트 구독 창입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/modify-edit.png)
1. **대상** 또는 **원본** 섹션에서 구독을 변경합니다. 소스 섹션에서 소스 식별자를 선택하거나 선택 취소하여 소스 식별자를 추가하거나 제거할 수 있습니다.
![\[대상 섹션을 강조 표시하는 이벤트 구독 수정 양식입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/modify-target.png)
1. **수정**을 선택합니다. Amazon DocumentDB 콘솔은 구독이 수정되고 있음을 나타냅니다.
![\[수정 버튼이 강조 표시된 이벤트 구독 수정 양식의 끝입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/modify-button.png)
## Amazon DocumentDB 이벤트 알림 구독 삭제
필요 없는 구독은 삭제할 수 있습니다. 그러면 해당 주제의 모든 구독자에게는 구독 시 지정한 이벤트 알림 메시지가 발송되지 않습니다.
1. 에서에 로그인 AWS Management Console 합니다[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. 탐색 창에서 [**이벤트 구독**]을 선택합니다.
![\[이벤트 구독 옵션이 강조 표시된 Amazon DocumentDB 콘솔 탐색 창입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/delete-event-subs.png)
1. **이벤트 구독** 패널에서 삭제할 구독을 선택합니다.
![\[선택한 구독을 보여주는 이벤트 구독 창입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/delete-select.png)
1. **삭제**를 선택합니다.
![\[삭제 버튼을 강조 표시하는 이벤트 구독 창입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/delete-delete.png)
1. 이 알림을 영구적으로 삭제할지 묻는 팝업 창이 나타납니다. **삭제**를 선택합니다.
![\[오른쪽 하단 모서리에 삭제 버튼이 강조 표시된 이벤트 구독 삭제를 확인하는 대화 상자입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/event-subs/delete-delete-2.png)
# Amazon DocumentDB 이벤트 범주 및 메시지
Amazon DocumentDB는 콘솔을 사용하여 가입할 수 있는 카테고리에서 상당한 수의 이벤트를 생성합니다. 각 범주는 인스턴스, 클러스터, 스냅샷 또는 매개 변수 그룹이 될 수 있는 소스 유형에 적용됩니다.
**참고**
Amazon DocumentDB는 기존의 Amazon RDS 이벤트 정의와 ID를 사용합니다.
## 인스턴스에서 발생한 Amazon DocumentDB 이벤트
| 범주 | 설명 |
| --- | --- |
| 가용성 | 인스턴스 재시작 |
| 가용성 | 인스턴스 셧다운. |
| 구성 변경 | 인스턴스 클래스에 수정을 적용하는 중입니다. |
| 구성 변경 | 인스턴스 클래스에 수정을 적용했습니다. |
| 구성 변경 | 기본 자격 증명을 재설정합니다. |
| 생성 | 인스턴스가 생성되었습니다. |
| 삭제 | 인스턴스가 삭제되었습니다. |
| 실패 | 호환되지 않는 구성 또는 기본 스토리지 문제로 인해 인스턴스가 실패했습니다. 인스턴스에 대한 시점 복원을 시작합니다. |
| 알림 | 인스턴스 멈춤. |
| 알림 | 인스턴스 시작. |
| 알림 | 인스턴스가 중지된 최대 허용 시간을 초과하여 시작되고 있습니다. |
| 복구 | 인스턴스 복구가 시작되었습니다. 복구 시간은 복구할 데이터 용량에 따라 달라집니다. |
| 복구 | 인스턴스 복구가 완료되었습니다. |
| 보안 패치 | 인스턴스에 대해 운영 체제 업데이트를 사용할 수 있습니다. 업데이트 적용에 대한 자세한 내용은 [Amazon DocumentDB 관리](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html)를 참조하세요. |
## 클러스터에서 발생하는 Amazon DocumentDB 이벤트
| 범주 | 설명 |
| --- | --- |
| 생성 | 클러스터가 생성됨. |
| 삭제 | 클러스터가 삭제되었습니다. |
| 장애 조치 | 이전 프라이머리를 다시 추진합니다. |
| 장애 조치 | 인스턴스로의 장애 조치가 완료되었습니다. |
| 장애 조치 | DB 인스턴스에 대한 장애 조치 시작: %초 |
| 장애 조치 | DB 인스턴스에 대한 동일한 AZ 장애 조치 시작: %초 |
| 장애 조치 | DB 인스턴스에 대한 동일한 AZ 장애 조치 시작: %초 |
| 유지 관리 | 클러스터가 패치되었습니다. |
| 유지 관리 | 데이터베이스 클러스터를 업그레이드할 수 없는 상태: %초 |
| 알림 | 클러스터가 중지되었습니다. |
| 알림 | 클러스터가 시작되었습니다. |
| 알림 | 클러스터 중지에 실패했습니다. |
| 알림 | 클러스터가 중지되는 최대 허용 시간을 초과하여 시작되고 있습니다. |
| 알림 | 클러스터 이름이 %초에서 %초로 변경되었습니다. |
## 클러스터 스냅샷에서 발생한 Amazon DocumentDB 이벤트
다음 표는 Amazon DocumentDB 클러스터 스냅샷이 원본 유형인 경우 이벤트 범주와 이벤트 목록을 보여줍니다.
| 범주 | 설명 |
| --- | --- |
| 백업 | 수동 클러스터 스냅샷을 생성하는 중입니다. |
| 백업 | 수동 클러스터 스냅샷이 생성되었습니다. |
| 백업 | 자동화된 클러스터 스냅샷을 생성하는 중입니다. |
| 백업 | 자동화된 클러스터 스냅샷이 생성되었습니다. |
## 파라미터 그룹에서 발생하는 Amazon DocumentDB 이벤트
다음 표는 파라미터 그룹이 소스 유형일 때 이벤트 카테고리와 이벤트 목록을 나타냅니다.
| 범주 | 설명 |
| --- | --- |
| 구성 변경 | 적용 방법 %초를 사용하여 매개 변수 %초를 %초로 업데이트했습니다 |