Performance Insights の有効化と無効化

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

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

クラスター作成時の Performance Insights の有効化

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

AWS Management Console を使用する場合

DocumentDB クラスターを作成するときに、コンソールで Performance Insights を有効にすることができます。新しい DocumentDB クラスターを作成する際に、[Performance Insights] セクションの [Performance Insights の有効化] を選択することで、Performance Insights を有効にします。

コンソールでの手順

1. クラスターを作成する手順については、「Amazon DocumentDB クラスターの作成」を参照してください。

2. [Performance Insights] セクションで、[Performance Insights の有効化] を選択します。

   

   注記

   Performance Insights データ保持期間は 7 日間です。

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

インスタンス変更時の有効化と無効化

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

Using the AWS Management Console

コンソールでの手順

1. AWS Management Console にサインインして Amazon DocumentDB コンソール https://console.aws.amazon.com/docdb を開きます。

2. [Clusters] を選択します。

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

4. [Performance Insights] セクションで、[Performance Insights の有効化] または [Performance Insightsの無効化] を選択します。

   注記

   [Performance Insights を有効にする] を選択した場合は、AWS AWS KMS キーを指定できます。Performance Insights は、潜在的に機密性の高いすべてのデータを AWS KMS キーを使用して暗号化します。データは、転送中と不使用時のいずれも暗号化されます。詳細については、「保管中の Amazon DocumentDB データの暗号化」を参照してください。

5. [Continue] (続行) をクリックします。

6. [Scheduling of Modifications] で、[Apply immediately] を選択します。「次にスケジュールされたメンテナンスウィンドウで適用」 を選択すると、インスタンスではこの設定が無視され、Performance Insights が直ちに有効になります。

7. [インスタンスの変更] を選択します。

Using the AWS CLI

create-db-instance または modify-db-instance AWS AWS CLI コマンドを使用する場合、--enable-performance-insights を指定して Performance Insights を有効にし、--no-enable-performance-insights を指定して無効にできます。

以下で、AWSAWS CLI を使用して DB インスタンスで Performance Insights を有効化または無効化する手順を説明します。

AWSAWS CLI手順

modify-db-instanceAWSAWS CLIコマンドで以下の値を指定します。

• --db-instance-identifer ​- DB インスタンスの名前

• 有効にする場合は --enable-performance-insights、無効にする場合は --no-enable-performance-insights

次の例では、sample-db-instance の Performance Insights を有効にします。

For Linux, macOS, or Unix:For Windows:

For Linux, macOS, or Unix:

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

For Windows:

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