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

# 성능 개선 도우미 활성화 및 비활성화
<a name="performance-insights-enabling"></a>

성능 개선 도우미를 사용하려면 DB 인스턴스에서 이 기능을 활성화합니다. 필요한 경우 나중에 이를 비활성화할 수 있습니다. 성능 개선 도우미를 활성화하거나 비활성화해도 가동 중지, 재부팅 또는 장애 조치가 발생하지 않습니다.

성능 개선 도우미 에이전트는 DB 호스트에서 제한된 CPU 및 메모리를 사용합니다. DB 로드가 높을 경우 에이전트는 데이터 수집 빈도를 줄여 성능에 미치는 영향을 제한합니다.

## 클러스터 생성 시 성능 개선 도우미 활성화
<a name="performance-insights-enabling-create-instance"></a>

콘솔에서 새 DB 인스턴스를 생성하거나 수정할 때 성능 개선 도우미를 활성화하거나 비활성화할 수 있습니다.

### 사용 AWS Management Console
<a name="create-instance-console"></a>

콘솔에서 Amazon DocumentDB 클러스터를 작성할 때 성능 개선 도우미를 활성화할 수 있습니다. 새 Amazon DocumentDB 클러스터를 작성할 때 **성능 개선 도우미** 섹션에서 **성능 개선 도우미 활성화**를 선택하여 성능 개선 도우미를 활성화합니다.

**콘솔 지침**

1. 클러스터를 만드는 방법에 대한 지침은 [Amazon DocumentDB 클러스터 생성](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-create.html)을 참조하세요.

1. 성능 개선 도우미 섹션에서 **성능 개선 도우미 활성화**를 선택합니다.  
![\[성능 개선 도우미 활성화를 선택한 성능 개선 도우미 섹션입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/performance-insights/select-performance-insights.png)
**참고**  
성능 개선 도우미 데이터 보존 기간은 7일입니다.

   ** AWS KMS 키** - AWS KMS 키를 지정합니다. 성능 개선 도우미는 AWS KMS 키를 사용하여 잠재적으로 민감한 모든 데이터를 암호화합니다. 데이터는 암호화된 상태로 전송 및 저장됩니다. 자세한 내용은 성능 개선 도우미에 대한 AWS AWS KMS 정책 구성을 참조하세요.

## 인스턴스 수정 시 활성화 및 비활성화
<a name="performance-insights-enabling-modify-instance"></a>

콘솔 또는 AWS CLI을 사용하여 성능 개선 도우미를 활성화하도록 DB 인스턴스를 수정할 수 있습니다.

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

**콘솔 지침**

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

1. **클러스터**를 선택하십시오.

1. DB 인스턴스를 선택하고 **수정**을 선택합니다.

1. 성능 개선 도우미 섹션에서 **성능 개선 도우미 활성화** 또는 **성능 개선 도우미 비활성화**를 선택합니다.
**참고**  
**성능 개선 도우미 활성화를** 선택하면 AWS AWS KMS 키를 지정할 수 있습니다. 성능 개선 도우미는 AWS KMS 키를 사용하여 잠재적으로 민감한 모든 데이터를 암호화합니다. 데이터는 암호화된 상태로 전송 및 저장됩니다. 자세한 내용은 [정지 상태의 Amazon DocumentDB Data 암호화](https://docs.aws.amazon.com/documentdb/latest/developerguide/encryption-at-rest.html)를 참조하십시오.

1. **Continue(계속)**를 선택합니다.

1. **수정 스케줄링**에 대해 **즉시 적용**을 선택합니다. **다음 예약된 유지 관리 기간 동안 적용**을 선택하면 인스턴스는 이 설정을 무시하고 즉시 성능 개선 도우미를 활성화합니다.

1. **Modify Instance(인스턴스 수정)**를 선택합니다.

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

`create-db-instance` 또는 `modify-db-instance` AWS AWS CLI 명령을 사용할 때를 지정하여 성능 개선 도우미를 활성화하거나 `--enable-performance-insights`를 지정하여 비활성화할 수 있습니다`--no-enable-performance-insights`.

다음 절차에서는 AWS AWS CLI를 사용하여 DB 인스턴스의 성능 개선 도우미를 활성화 또는 비활성화하는 방법을 설명합니다.



**AWS AWS CLI 지침**

`modify-db-instance` AWS AWS CLI 명령을 호출하고 다음 값을 제공합니다.
+ `--db-instance-identifer` — DB 인스턴스 이름.
+ 활성화하려면 `--enable-performance-insights` 또는 비활성화하려면 `--no-enable-performance-insights`

**Example**  
다음 예제에서는 `sample-db-instance`에 대한 성능 개선 도우미를 활성화합니다:  

```
aws docdb modify-db-instance \
    --db-instance-identifier sample-db-instance \
    --enable-performance-insights
```

```
aws docdb modify-db-instance ^
    --db-instance-identifier sample-db-instance ^
    --enable-performance-insights
```

------