本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 啟用和停用績效詳情
<a name="performance-insights-enabling"></a>

若要使用績效詳情，請在資料庫執行個體上啟用。您可以視需要稍後停用它。啟用和停用績效詳情不會造成停機、重新開機或容錯移轉。

績效詳情代理程式會耗用資料庫主機上有限的 CPU 和記憶體。當資料庫負載過高時，代理程式會減少收集資料的頻率來限制效能影響。

## 建立叢集時啟用績效詳情
<a name="performance-insights-enabling-create-instance"></a>

在主控台中，您可以在建立或修改新的資料庫執行個體時啟用或停用績效詳情。

### 使用 AWS 管理主控台
<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/zh_tw/documentdb/latest/developerguide/images/performance-insights/select-performance-insights.png)
**注意**  
Performance Insights 資料保留期間為七天。

   ** AWS KMS key** — 指定您的 AWS KMS 金鑰。Performance Insights 會使用 AWS KMS 金鑰加密所有潛在的敏感資料。將會對傳輸中與靜態資料進行加密。如需詳細資訊，請參閱設定績效詳情 AWS AWS KMS 的政策。

## 修改執行個體時啟用和停用
<a name="performance-insights-enabling-modify-instance"></a>

您可以使用 主控台或 修改資料庫執行個體來啟用或停用績效詳情 AWS CLI。

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

**主控台指示**

1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) 開啟 Amazon DocumentDB 主控台。

1. 選擇 **Clusters (叢集)**。

1. 選擇資料庫執行個體，然後選擇 **修改 (Modify)**。

1. 在績效詳情區段中，選擇**啟用績效詳情**或**停用績效詳情**。
**注意**  
如果您選擇**啟用績效詳情**，您可以指定您的 AWS AWS KMS 金鑰。Performance Insights 會使用 AWS KMS 金鑰加密所有潛在的敏感資料。將會對傳輸中與靜態資料進行加密。如需詳細資訊，請參閱[加密靜態 Amazon DocumentDB 資料](https://docs.aws.amazon.com/documentdb/latest/developerguide/encryption-at-rest.html)。

1. 選擇 **Continue** (繼續)。

1. 在 **Scheduling of Modifications (修改排程)** 中，選擇 **Apply immediately (立即套用)**。如果您在**下一個排定的維護時段選擇套用**，您的執行個體會忽略此設定，並立即啟用績效詳情。

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啟用或停用資料庫執行個體的績效詳情。



**AWS AWS CLI 指示**

呼叫 `modify-db-instance` AWS AWS CLI 命令並提供下列值：
+ `--db-instance-identifer` — 資料庫執行個體的名稱
+ `--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
```

------