翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Performance Insights の有効化と無効化
<a name="performance-insights-enabling"></a>

Performance Insights を使用するには、DB インスタンスで有効にします。必要に応じて、後で無効にすることができます。Performance Insights を有効または無効にしても、ダウンタイム、再起動、フェイルオーバーが発生することはありません。

Performance Insights エージェントは DB ホストの限られた CPU とメモリを消費します。DB のロードが高い場合、エージェントはデータ収集の頻度を下げることでパフォーマンスへの影響を抑えます。

## クラスター作成時の Performance Insights の有効化
<a name="performance-insights-enabling-create-instance"></a>

コンソールでは、新しい DB インスタンスを作成または変更するときに、Performance Insights を有効または無効にすることができます。

### の使用 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. [Performance Insights] セクションで、**[Performance Insights の有効化]** を選択します。  
![\[[パフォーマンスインサイト] セクションで、[パフォーマンスインサイトを有効にする] を選択します。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/select-performance-insights.png)
**注記**  
Performance Insights データ保持期間は 7 日間です。

   ** AWS KMS key** — AWS KMS キーを指定します。Performance Insights は、 AWS KMS キーを使用してすべての機密データを暗号化します。データは、転送中と不使用時のいずれも暗号化されます。詳細については、「Performance Insights の AWS AWS KMS ポリシーの設定」を参照してください。

## インスタンス変更時の有効化と無効化
<a name="performance-insights-enabling-modify-instance"></a>

コンソールまたは AWS CLIを使用し、DB インスタンスを変更して Performance Insights を有効にできます。

------
#### [ Using the AWS マネジメントコンソール ]

**コンソールでの手順**

1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) で Amazon DocumentDB コンソールを開きます。

1. **[クラスター]** を選択します。

1. DB インスタンスを選択し、[**変更**] を選択します。

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. [**Scheduling of Modifications**] で、[**Apply immediately**] を選択します。「**次にスケジュールされたメンテナンスウィンドウで適用**」 を選択すると、インスタンスではこの設定が無視され、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を使用して DB インスタンスで Performance Insights を有効化または無効化する方法を説明します。



**AWS AWS CLI 手順**

`modify-db-instance` AWS AWS CLI コマンドを呼び出し、次の値を指定します。
+ `--db-instance-identifer` ​- DB インスタンスの名前
+ 有効にする場合は `--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
```

------