To use Performance Insights, enable it on your DB instance. You can disable it later if necessary. Enabling and disabling Performance Insights doesn't cause downtime, a reboot, or a failover.
The Performance Insights agent consumes limited CPU and memory on the DB host. When the DB load is high, the agent limits the performance impact by collecting data less frequently.
Enabling Performance
Insights when creating a cluster
In the console, you can enable or disable Performance Insights when you create or modify a new DB instance.
Using the AWS Management Console
In the console, you can enable Performance Insights when you create an Amazon DocumentDB cluster. When you create a new Amazon DocumentDB cluster, enable Performance Insights by choosing Enable Performance Insights in the Performance Insights section.
Console instructions
-
To create a cluster, follow the instructions for Creating an Amazon DocumentDB cluster.
-
Select Enable Performance Insights in the Performance Insights section.
Note
The Performance Insights data retention period will be seven days.
AWS KMS key — Specify your AWS KMS key. Performance Insights encrypts all potentially sensitive data using your AWS KMS key. Data is encrypted in flight and at rest. For more information, see Configuring an AWS AWS KMS policy for Performance Insights.
Enabling and disabling when modifying an instance
You can modify a DB instance to enable or disable Performance Insights using the console or AWS CLI.
Console instructions
-
Sign in to the AWS Management Console, and open the Amazon DocumentDB console at https://console.aws.amazon.com/docdb
. -
Choose Clusters.
-
Choose a DB instance, and choose Modify.
-
In the Performance Insights section, choose either Enable Performance Insights or Disable Performance Insights.
Note
If you choose Enable Performance Insights, you can specify your AWS AWS KMS key. Performance Insights encrypts all potentially sensitive data using your AWS KMS key. Data is encrypted in flight and at rest. For more information, see Encrypting Amazon DocumentDB Data at Rest.
-
Choose Continue.
-
For Scheduling of Modifications, choose Apply immediately. If you choose Apply during the next scheduled maintenance window, your instance ignores this setting and enables Performance Insights immediately.
-
Choose Modify instance.