

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon DocumentDB 이벤트 관리
<a name="managing-events"></a>

Amazon DocumentDB(MongoDB 호환)는 클러스터, 인스턴스, 스냅샷, 보안 그룹 및 클러스터 매개 변수 그룹과 관련된 이벤트 기록을 보관합니다. 여기에는 이벤트 날짜 및 시간, 이벤트의 원본 이름 및 유형, 이벤트 관련 메시지 등의 정보가 포함됩니다.

**중요**  
특정 관리 기능의 경우, Amazon DocumentDB는 Amazon RDS 및 Amazon Neptune과 공유하는 운영 기술을 사용한다. 영역 제한, 즉 영역 수준에서 관리되는 제한은 Amazon DocumentDB, Amazon RDS 및 Amazon Neptune 간에 공유됩니다. 자세한 내용은 [리전별 할당량](limits.md#limits-regional_quotas) 섹션을 참조하세요.

**Topics**
+ [Amazon DocumentDB 이벤트 범주 보기](#viewing-event-categories)
+ [Amazon DocumentDB 이벤트 보기](#viewing-events)

## Amazon DocumentDB 이벤트 범주 보기
<a name="viewing-event-categories"></a>

각 Amazon DocumentDB 리소스 유형에는 관련될 수 있는 특정 유형의 이벤트가 있습니다. AWS CLI `describe-event-categories` 연산을 사용하여 이벤트 유형과 Amazon DocumentDB 리소스 유형 간의 매핑을 볼 수 있습니다.

**파라미터**
+ **--source-type**—선택 사항. `--source-type` 파라미터를 사용하여 특정 소스 유형의 이벤트 범주를 봅니다. 다음은 허용되는 값입니다:
  + `db-cluster`
  + `db-instance`
  + `db-parameter-group`
  + `db-security-group`
  + `db-cluster-snapshot`
+ **--filters**—선택 사항. Amazon DocumentDB에 대한 이벤트 범주를 보려면 필터`--filter Name=engine,Values=docdb`를 사용합니다.

**Example**  
다음 코드는 클러스터와 연결된 이벤트 범주를 나열합니다.  
Linux, macOS, Unix의 경우:  

```
aws docdb describe-event-categories \
    --filter Name=engine,Values=docdb \
    --source-type db-cluster
```
Windows의 경우:  

```
aws docdb describe-event-categories ^
    --filter Name=engine,Values=docdb ^
    --source-type db-cluster
```
이 작업의 출력은 다음과 같습니다(JSON 형식).  

```
{
    "EventCategoriesMapList": [
        {
            "EventCategories": [
                "notification",
                "failure",
                "maintenance",
                "failover"
            ],
            "SourceType": "db-cluster"
        }
    ]
}
```
다음 코드는 각 Amazon DocumentDB 원본 유형과 관련된 이벤트 범주를 나열합니다.  

```
aws docdb describe-event-categories
```
이 작업의 출력은 다음과 같습니다(JSON 형식).  

```
{
    "EventCategoriesMapList": [
        {
            "SourceType": "db-instance",
            "EventCategories": [
                "notification",
                "failure",
                "creation",
                "maintenance",
                "deletion",
                "recovery",
                "restoration",
                "configuration change",
                "read replica",
                "backtrack",
                "low storage",
                "backup",
                "availability",
                "failover"
            ]
        },
        {
            "SourceType": "db-security-group",
            "EventCategories": [
                "configuration change",
                "failure"
            ]
        },
        {
            "SourceType": "db-parameter-group",
            "EventCategories": [
                "configuration change"
            ]
        },
        {
            "SourceType": "db-cluster",
            "EventCategories": [
                "notification",
                "failure",
                "maintenance",
                "failover"
            ]
        },
        {
            "SourceType": "db-cluster-snapshot",
            "EventCategories": [
                "backup"
            ]
        }
    ]
}
```

## Amazon DocumentDB 이벤트 보기
<a name="viewing-events"></a>

지난 24시간 동안의 이벤트를 보여주는 Amazon DocumentDB 콘솔을 통해 Amazon DocumentDB 리소스에 대한 이벤트를 검색할 수 있습니다. [ 설명이벤트 ](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) AWS CLI 명령 또는 [설명 이벤트](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeEvents.html) Amazon DocumentDB API 작업을 사용하여 Amazon DocumentDB 리소스에 대한 이벤트를 검색할 수도 있습니다. 또는 AWS CLIAmazon DocumentDB API를 사용하여 이벤트를 볼 경우 지난 14일 동안의 이벤트를 검색할 수 있습니다.

------
#### [ Using the AWS Management Console ]

**지난 24시간 동안 발생한 모든 Amazon DocumentDB 인스턴스 이벤트를 보려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)에서 Amazon DocumentDB 콘솔을 엽니다.

1. 탐색 창에서 **이벤트**를 선택합니다. 사용 가능한 이벤트가 목록에 표시됩니다.

1. **필터** 목록을 사용하여 유형별로 이벤트를 필터링합니다. 텍스트 상자에 단어를 입력하여 결과를 추가로 필터링할 수 있습니다. 예를 들어, 다음 스크린샷은 *스냅샷* 이벤트에 대한 모든 Amazon DocumentDB 이벤트를 필터링하는 것을 보여줍니다.  
![\[스냅샷에 대한 필터링 이벤트를 보여주는 이벤트 섹션의 스크린샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/events-filtering.png)

------
#### [ Using the AWS CLI ]

**지난 7일 동안의 모든 Amazon DocumentDB 인스턴스 이벤트를 보려면 다음과 같이 하십시오**  
[기술-이벤트](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) AWS CLI 명령을 호출하고 `--duration` 파라미터를 `10080`으로 설정하여 지난 10,080분(7일) 동안 발생한 모든 Amazon DocumentDB 인스턴스 이벤트를 볼 수 있습니다.

```
aws docdb describe-events --duration 10080
```

**Amazon DocumentDB 이벤트 필터링**

특정 Amazon DocumentDB 이벤트를 보려면 다음 매개변수를 사용하여 `describe-events` 작업을 수행합니다.

**파라미터**
+ **--filter**—반환된 값을 Amazon DocumentDB 이벤트로 제한하는 데 필요합니다. Amazon DocumentDB의 모든 이벤트를 **Name=engine,Values=docdb** 필터링하는 데만 사용합니다.
+ **--source-identifier**—선택 사항. 반환되는 이벤트에 대한 이벤트 소스의 식별자입니다. 생략하면 모든 소스의 이벤트가 결과에 포함됩니다.
+ **--source-type**—선택 사항, 다만 `--source-identifier`이 제공되지 않을 경우, 필수 사항. `--source-identifier`를 제공한 경우 `--source-type`은 `--source-identifier` 유형에 동의해야 합니다. 다음은 허용되는 값입니다:
  + `db-cluster`
  + `db-instance`
  + `db-parameter-group`
  + `db-security-group`
  + `db-cluster-snapshot`

다음 예제에서는 모든 Amazon DocumentDB 이벤트를 나열합니다.

```
aws docdb describe-events --filters Name=engine,Values=docdb
```

이 작업의 출력은 다음과 같습니다(JSON 형식).

```
{
    "Events": [
        {
            "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:sample-cluster-instance3",
            "Message": "instance created",
            "SourceType": "db-instance",
            "Date": "2018-12-11T21:17:40.023Z",
            "SourceIdentifier": "sample-cluster-instance3",
            "EventCategories": [
                "creation"
            ]
        },
        {
            "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23",
            "Message": "instance shutdown",
            "SourceType": "db-instance",
            "Date": "2018-12-11T21:25:01.245Z",
            "SourceIdentifier": "docdb-2018-12-11-21-08-23",
            "EventCategories": [
                "availability"
            ]
        },
        {
            "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23",
            "Message": "instance restarted",
            "SourceType": "db-instance",
            "Date": "2018-12-11T21:25:11.441Z",
            "SourceIdentifier": "docdb-2018-12-11-21-08-23",
            "EventCategories": [
                "availability"
            ]
        }
    ]
}
```

------

자세한 내용은 [Amazon DocumentDB 이벤트 감사](event-auditing.md) 섹션을 참조하세요.