本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 启用和禁用 Performance Insights
<a name="performance-insights-enabling"></a>

要使用 Performance Insights，请在数据库实例中启用它。如果需要，您可以稍后将其禁用。启用和禁用 Performance Insights 不会导致停机、重新启动或故障转移。

性能详情代理占用数据库主机上有限的 CPU 和内存。当数据库负载较高时，代理将通过降低收集数据的频率来限制性能影响。

## 在创建集群时启用 Performance Insights
<a name="performance-insights-enabling-create-instance"></a>

在控制台中，您可以在创建或修改新数据库实例时启用或禁用 Performance Insights。

### 使用 AWS 管理控制台
<a name="create-instance-console"></a>

在控制台中，您可以在创建 Amazon DocumentDB 集群时启用 Performance Insights。在创建新 Amazon DocumentDB 集群时，通过在 **Performance Insights** 部分中选择**启用 Performance Insights** 以启用 Performance Insights。

**控制台说明**

1. 有关创建集群的说明，请参阅[创建 Amazon DocumentDB 集群](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-create.html)中的说明。

1. 在 Performance Insights 部分中选择**启用 Performance Insights**。  
![\[“性能详情”部分，其中已选择“启用性能详情”。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/performance-insights/select-performance-insights.png)
**注意**  
Performance Insights 的数据留存期将为七天。

   ** AWS KMS 密钥**-指定您的 AWS KMS 密钥。Performance Insights 使用您的 AWS KMS 密钥加密所有潜在的敏感数据。正在传输的数据和静态数据都会被加密。有关更多信息，请参阅为 Performance Insights 配置 AWS AWS KMS 策略。

## 修改实例时启用和禁用
<a name="performance-insights-enabling-modify-instance"></a>

您也可以修改数据库实例以使用控制台或 AWS CLI启用或禁用 Performance Insights。

------
#### [ Using the AWS 管理控制台 ]

**控制台说明**

1. [登录 AWS 管理控制台，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)

1. 选择**集群**。

1. 选择一个数据库实例，然后选择**修改**。

1. 在 Performance Insights 部分，选择**启用 Performance Insights** 或**禁用 Performance Insights**。
**注意**  
如果选择 “**启用 Performance Insights**”，则可以指定 AWS AWS KMS 密钥。Performance Insights 使用您的 AWS KMS 密钥加密所有潜在的敏感数据。正在传输的数据和静态数据都会被加密。有关更多信息，请参阅[加密 Amazon DocumentDB 静态数据](https://docs.aws.amazon.com/documentdb/latest/developerguide/encryption-at-rest.html)。

1. 选择**继续**。

1. 对于**修改计划**，选择**立即应用**。如果您选择**在下一个计划的维护时段内应用**，则您的实例将忽略此设置并立即启用 Performance Insights。

1. 选择**修改实例**。

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

使用`create-db-instance`或`modify-db-instance` AWS AWS CLI 命令时，您可以通过指定来启用 Performance Insights`--enable-performance-insights`，也可以通过指定将其禁用`--no-enable-performance-insights`。

以下过程介绍如何使用 AWS AWS CLI为数据库实例启用或禁用 Performance Insights。



**AWS AWS CLI 指令**

调用`modify-db-instance` AWS AWS CLI 命令并提供以下值：
+ `--db-instance-identifer`：数据库实例的名称
+ `--enable-performance-insights` 以启用，或 `--no-enable-performance-insights` 以禁用

**Example**  
以下示例为 `sample-db-instance` 启用 Performance Insights：  

```
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
```

------