기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# MemoryDB 이벤트 모니터링
클러스터에서 중요 이벤트가 발생하면 MemoryDB는 특정 Amazon SNS 주제에 알림을 전송합니다. 이러한 예에는 노드 추가 실패, 노드 추가 성공, 보안 그룹 수정 등이 있습니다. 주요 이벤트를 모니터링하면 클러스터의 현재 상태를 파악할 수 있으며, 이벤트에 따라 교정 작업을 수행할 수도 있습니다.
**Topics**
+ [MemoryDB Amazon SNS 알림 관리](mdbevents.sns.md)
+ [MemoryDB 이벤트 보기](mdbevents.viewing.md)
+ [이벤트 알림 및 Amazon SNS](memorydbsns.md)
# MemoryDB Amazon SNS 알림 관리
Amazon Simple Notification Service(SNS)를 사용하여 중요한 클러스터 이벤트에 대해 알림을 보내도록 MemoryDB를 구성할 수 있습니다. 이러한 예에서는 Amazon SNS 항목의 Amazon 리소스 이름(ARN)으로 클러스터를 구성하여 알림을 받습니다.
**참고**
이 항목에서는 Amazon SNS에 가입했으며 Amazon SNS 주제를 설정 및 구독했다고 가정합니다. 이렇게 하는 방법에 대한 정보는 [Amazon Simple Notification Service 개발자 안내서](https://docs.aws.amazon.com/sns/latest/dg/)를 참조하세요.
## Amazon SNS 주제 추가
다음 섹션은 AWS 콘솔, AWS CLI 또는 MemoryDB API를 사용하여 Amazon SNS 주제를 추가하는 방법을 보여줍니다.
### Amazon SNS 주제 추가(콘솔)
다음 절차는 클러스터에 대해 Amazon SNS 주제를 추가하는 방법을 보여줍니다.
**참고**
이 프로세스는 Amazon SNS 주제를 수정하는 데에도 사용할 수 있습니다.
**클러스터에 대해 Amazon SNS 주제를 추가 또는 수정하려면(콘솔)**
1. AWS Management Console에 로그인하고 [https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/)에서 MemoryDB 콘솔을 엽니다.
1. ** 클러스터**에서 Amazon SNS 주제 ARN을 추가 또는 수정할 클러스터를 선택합니다.
1. **수정**을 선택합니다.
1. **클러스터 수정**의 **SNS 알림에 대한 주제**에서 추가하려는 SNS 주제를 선택하거나 **수동 ARN 입력**을 선택하고 Amazon SNS 주제의 ARN을 입력합니다.
1. **수정**을 선택합니다.
### Amazon SNS 주제 추가(AWS CLI)
클러스터에 대해 Amazon SNS 주제를 추가 또는 수정하려면 AWS CLI 명령 `update-cluster`를 사용합니다.
다음 코드 예제는 Amazon SNS 주제 arn을 *my-cluster*에 추가합니다.
Linux, macOS, Unix의 경우:
```
aws memorydb update-cluster \
--cluster-name my-cluster \
--sns-topic-arn arn:aws:sns:us-east-1:565419523791:memorydbNotifications
```
Windows의 경우:
```
aws memorydb update-cluster ^
--cluster-name my-cluster ^
--sns-topic-arn arn:aws:sns:us-east-1:565419523791:memorydbNotifications
```
자세한 내용은 [UpdateCluster](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UpdateCluster.html)를 참조하세요.
### Amazon SNS 주제 추가(MemoryDB API)
클러스터에 대해 Amazon SNS 주제를 추가 또는 업데이트하려면 다음 파라미터와 함께 `UpdateCluster` 작업을 호출합니다.
+ `ClusterName``=my-cluster`
+ `SnsTopicArn``=arn%3Aaws%3Asns%3Aus-east-1%3A565419523791%3AmemorydbNotifications`
클러스터에 대해 Amazon SNS 주제를 추가 또는 업데이트하려면 `UpdateCluster` 작업을 직접적으로 호출합니다.
자세한 내용은 [UpdateCluster를](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UpdateCluster.html) 참조하세요.
## Amazon SNS 알림 활성화 및 비활성화
클러스터에 대해 알림을 켜거나 끌 수 있습니다. 다음 절차는 Amazon SNS 알림을 비활성화하는 방법을 보여줍니다.
### Amazon SNS 알림 활성화 및 비활성화(콘솔)
**AWS Management Console을 사용하여 Amazon SNS 알림을 비활성화하려면**
1. AWS Management Console에 로그인하고 [https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/)에서 MemoryDB 콘솔을 엽니다.
1. 알림을 수정할 클러스터의 이름 왼쪽에 있는 라디오 버튼을 선택합니다.
1. **수정**을 선택합니다.
1. **클러스터 수정**의 **SNS 알림에 대한 주제**에서 *알림 비활성화*를 선택합니다.
1. **수정**을 선택합니다.
### Amazon SNS 알림 활성화 및 비활성화(AWS CLI)
Amazon SNS 알림을 비활성화하려면 다음 파라미터와 함께 `update-cluster` 명령을 사용합니다.
Linux, macOS, Unix의 경우:
```
aws memorydb update-cluster \
--cluster-name my-cluster \
--sns-topic-status inactive
```
Windows의 경우:
```
aws memorydb update-cluster ^
--cluster-name my-cluster ^
--sns-topic-status inactive
```
### Amazon SNS 알림 활성화 및 비활성화(MemoryDB API)
Amazon SNS 알림을 비활성화하려면 다음 파라미터와 함께 `UpdateCluster` 작업을 호출합니다.
+ `ClusterName``=my-cluster`
+ `SnsTopicStatus``=inactive`
이 호출은 다음과 비슷한 출력을 반환합니다.
**Example**
```
1. https://memory-db.us-east-1.amazonaws.com/
2. ?Action=UpdateCluster
3. &ClusterName=my-cluster
4. &SnsTopicStatus=inactive
5. &Version=2021-01-01
6. &SignatureVersion=4
7. &SignatureMethod=HmacSHA256
8. &Timestamp=20210801T220302Z
9. &X-Amz-Algorithm=Amazon4-HMAC-SHA256
10. &X-Amz-Date=20210801T220302Z
11. &X-Amz-SignedHeaders=Host
12. &X-Amz-Expires=20210801T220302Z
13. &X-Amz-Credential=
14. &X-Amz-Signature=
```
# MemoryDB 이벤트 보기
MemoryDB 로그는 클러스터, 보안 그룹 및 파라미터 그룹과 관련된 이벤트를 기록합니다. 여기에는 이벤트 날짜 및 시간, 이벤트의 원본 이름 및 원본 유형, 이벤트 설명 등의 정보가 포함됩니다. MemoryDB 콘솔, AWS CLI `describe-events` 명령 또는 MemoryDB API 작업 `DescribeEvents`을 사용하여 로그에서 이벤트를 쉽게 검색할 수 있습니다.
다음 절차는 지난 24시간(1440분) 동안의 모든 MemoryDB 이벤트를 보는 방법을 보여줍니다.
## MemoryDB 이벤트 보기(콘솔)
다음 절차는 MemoryDB 콘솔을 사용하여 이벤트를 표시합니다.
**MemoryDB 콘솔을 사용하여 이벤트를 보려면**
1. AWS Management Console에 로그인하고 [https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/)에서 MemoryDB 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **이벤트**를 선택합니다.
사용 가능한 모든 이벤트가 나열된 *이벤트* 화면이 나타납니다. 이벤트 화면에서 목록의 각 행은 이벤트 하나를 나타내며 이벤트 소스, 이벤트 유형(클러스터, parameter-group, acl, 보안 그룹 또는 서브넷 그룹), 이벤트의 GMT 시간 및 이벤트 설명을 표시합니다.
[**Filter**]를 사용하여 이벤트 목록에서 모든 이벤트를 볼지 특정 유형의 이벤트만 볼지를 지정할 수 있습니다.
## MemoryDB 이벤트 보기(AWS CLI)
AWS CLI을(를) 사용하여 MemoryDB 이벤트의 목록을 생성하려면 `describe-events` 명령을 사용합니다. 선택적 파라미터를 사용하여 나열된 이벤트의 유형, 나열된 이벤트의 기간, 나열할 이벤트의 최대 수 등을 제어할 수 있습니다.
다음 코드는 최대 40개의 클러스터 이벤트를 나열합니다.
```
aws memorydb describe-events --source-type cluster --max-results 40
```
다음 코드는 지난 24시간(1440분) 동안의 모든 이벤트를 나열합니다.
```
aws memorydb describe-events --duration 1440
```
`describe-events` 명령의 출력은 다음과 같습니다.
```
{
"Events": [
{
"Date": "2021-03-29T22:17:37.781Z",
"Message": "Added node 0001 in Availability Zone us-east-1a",
"SourceName": "memorydb01",
"SourceType": "cluster"
},
{
"Date": "2021-03-29T22:17:37.769Z",
"Message": "cluster created",
"SourceName": "memorydb01",
"SourceType": "cluster"
}
]
}
```
사용 가능한 파라미터 및 허용된 파라미터 값과 같은 자세한 내용은 [https://docs.aws.amazon.com/cli/latest/reference/memorydb/describe-events.html](https://docs.aws.amazon.com/cli/latest/reference/memorydb/describe-events.html)를 참조하세요.
## MemoryDB 이벤트 보기(MemoryDB API)
MemoryDB API를 사용하여 MemoryDB 이벤트의 목록을 생성하려면 `DescribeEvents` 작업을 사용합니다. 선택적 파라미터를 사용하여 나열된 이벤트의 유형, 나열된 이벤트의 기간, 나열할 이벤트의 최대 수 등을 제어할 수 있습니다.
다음 코드는 40개의 최신 클러스터 이벤트를 나열합니다.
```
https://memory-db.us-east-1.amazonaws.com/
?Action=DescribeEvents
&MaxResults=40
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&SourceType=cluster
&Timestamp=20210802T192317Z
&Version=2021-01-01
&X-Amz-Credential=
```
다음 코드는 지난 24시간(1440분) 동안의 클러스터 이벤트를 나열합니다.
```
https://memory-db.us-east-1.amazonaws.com/
?Action=DescribeEvents
&Duration=1440
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&SourceType=cluster
&Timestamp=20210802T192317Z
&Version=2021-01-01
&X-Amz-Credential=
```
위 작업을 통해 다음과 비슷한 출력이 생성되어야 합니다.
```
cluster created
cluster
2021-08-02T18:22:18.202Z
my-memorydb-primary
(...output omitted...)
e21c81b4-b9cd-11e3-8a16-7978bb24ffdf
```
사용 가능한 파라미터 및 허용된 파라미터 값과 같은 자세한 내용은 [https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeEvents.html](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeEvents.html)를 참조하세요.
# 이벤트 알림 및 Amazon SNS
MemoryDB는 클러스터에서 중요 이벤트가 발생하는 경우, Amazon Simple Notification Service(SNS)를 사용하여 메시지를 게시할 수 있습니다. 이 기능은 클러스터의 개별 노드 엔드포인트에 연결된 클라이언트 머신의 서버 목록을 새로 고침하는 데 사용될 수 있습니다.
**참고**
이용 요금 정보 및 Amazon SNS 설명서 링크 등 Amazon Simple Notification Service(SNS)에 대한 자세한 내용은 [Amazon SNS 제품 페이지](https://aws.amazon.com/sns)를 참조하세요.
알림은 지정된 Amazon SNS *주제*에 대해 게시됩니다. 다음은 알림에 대한 요구 사항입니다.
+ MemoryDB 알림에 대해 주제 하나만 구성할 수 있습니다.
+ Amazon SNS 주제를 소유한 AWS 계정은 알림이 활성화된 클러스터를 소유하는 계정과 동일해야 합니다.
## MemoryDB 이벤트
다음 MemoryDB 이벤트는 Amazon SNS 알림을 트리거합니다.
| Event Name | 메시지 | 설명 |
| --- | --- | --- |
| MemoryDB:AddNodeComplete | "Modified number of nodes from %d to %d" | 노드가 클러스터에 추가되었고 사용할 준비가 되어 있습니다. |
| 무료 IP 주소가 부족함으로 인한 MemoryDB:AddNodeFailed | "Failed to modify number of nodes from %d to %d due to insufficient free IP addresses" | 사용 가능한 IP 주소가 충분하지 않아 노드를 추가하지 못했습니다. |
| MemoryDB:ClusterParametersChanged | "Updated parameter group for the cluster" 생성 시 `"Updated to use a ParameterGroup %s"`도 전송합니다. | 하나 이상의 클러스터 파라미터가 변경되었습니다. |
| MemoryDB:ClusterProvisioningComplete | "Cluster created." | 클러스터의 프로비저닝이 완료되어 클러스터에 있는 노드를 사용할 수 있습니다. |
| 호환되지 않는 네트워크 상태로 인한 MemoryDB:ClusterProvisioningFailed | "Failed to create cluster due to incompatible network state. %s" | 존재하지 않는 Virtual Private Cloud(VPC)에서 새로운 클러스터를 실행하려고 시도했습니다. |
| MemoryDB:ClusterRestoreFailed | "Restore from %s failed for node %s. %s" | MemoryDB가 클러스터를 스냅샷 데이터로 채우지 못했습니다. Amazon S3에 스냅샷 파일이 없거나 해당 파일에 대한 권한이 잘못되었기 때문일 수 있습니다. 클러스터를 설명할 경우, 상태는 `restore-failed`입니다. 클러스터를 삭제하고 다시 시작해야 합니다. 자세한 내용은 [외부에서 생성된 스냅샷으로 새 클러스터 시드](snapshots-seeding-redis.md) 섹션을 참조하세요. |
| MemoryDB:ClusterScalingComplete | `"Succeeded applying modification to node type to %s."` | 클러스터의 스케일 업이 성공적으로 완료되었습니다. |
| MemoryDB:ClusterScalingFailed | `"Failed applying modification to node type to %s."` | 클러스터에 대한 스케일 업 작업이 실패했습니다. |
| MemoryDB:NodeReplaceStarted | "Recovering node %s" | MemoryDB가 노드를 실행하는 호스트 성능이 저하되었거나 연결되지 않음을 감지하여 노드 교체를 시작했습니다. 교체된 노드의 DNS 항목은 변경되지 않습니다. 대부분의 경우에 이 이벤트가 발생할 때 클라이언트의 서버 목록을 새로 고침하지 않아도 됩니다. 하지만 일부 클라이언트 라이브러리는 MemoryDB가 노드를 교체한 후에도 캐시 노드 사용을 중단할 수 있습니다. 이 경우에 애플리케이션은 이 이벤트가 발생할 때 서버 목록을 새로 고침해야 합니다. |
| MemoryDB:NodeReplaceComplete | "Finished recovery for node %s" | MemoryDB가 노드를 실행하는 호스트 성능이 저하되었거나 연결되지 않음을 감지하여 노드 교체를 완료했습니다. 교체된 노드의 DNS 항목은 변경되지 않습니다. 대부분의 경우에 이 이벤트가 발생할 때 클라이언트의 서버 목록을 새로 고침하지 않아도 됩니다. 하지만 일부 클라이언트 라이브러리는 MemoryDB가 노드를 교체한 후에도 캐시 노드 사용을 중단할 수 있습니다. 이 경우에 애플리케이션은 이 이벤트가 발생할 때 서버 목록을 새로 고침해야 합니다. |
| MemoryDB:CreateClusterComplete | "Cluster created" | 클러스터가 성공적으로 생성되었습니다. |
| MemoryDB:CreateClusterFailed | "Failed to create cluster due to unsuccessful creation of its node(s)."‘and’"Deleting all nodes belonging to this cluster." | 클러스터가 생성되지 않았습니다. |
| MemoryDB:DeleteClusterComplete | "Cluster deleted." | 클러스터 및 연결된 모든 노드 삭제를 완료했습니다. |
| MemoryDB:FailoverComplete | `"Failover to replica node %s completed"` | 복제본 노드에 대한 장애 조치가 성공했습니다. |
| MemoryDB:NodeReplacementCanceled | "The replacement of node %s which was scheduled during the maintenance window from start time: %s, end time: %s has been canceled" | 교체가 예약되어 있는 클러스터의 노드가 더 이상 교체 예약이 되지 않습니다. |
| MemoryDB:NodeReplacementRescheduled | "The replacement in maintenance window for node %s has been re-scheduled from previous start time: %s, previous end time: %s to new start time: %s, new end time: %s" | 이전에 교체가 예약되어 있는 클러스터의 노드가 알림에 설명된 새 기간 동안 교체가 예약됩니다. 수행할 수 있는 작업에 대한 자세한 내용은 [노드 교체](nodes.nodereplacement.md) 섹션을 참조하세요. |
| MemoryDB:NodeReplacementScheduled | "The node %s is scheduled for replacement during the maintenance window from start time: %s to end time: %s" | 클러스터의 노드가 알림에 설명된 기간 동안 교체가 예약됩니다. 수행할 수 있는 작업에 대한 자세한 내용은 [노드 교체](nodes.nodereplacement.md) 섹션을 참조하세요. |
| MemoryDB:RemoveNodeComplete | "Removed node %s" | 노드가 클러스터에서 제거되었습니다. |
| MemoryDB:SnapshotComplete | "Snapshot %s succeeded for node %s" | 스냅샷이 성공적으로 완료되었습니다. |
| MemoryDB:SnapshotFailed | "Snapshot %s failed for node %s" | 스냅샷이 실패했습니다. 원인에 대한 자세한 내용은 클러스터의 이벤트를 참조하세요. 스냅샷을 설명할 경우, [DescribeSnapshots](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeSnapshots.html)를 참조하세요. 상태는 `failed`입니다. |