Ativar e desativar o Performance Insights

Para usar o Performance Insights, ative-o em sua instância de banco de dados. Você pode desativá-lo mais tarde. Habilitar e desabilitar o Performance Insights não causa tempo de inatividade, reinicialização ou failover.

O agente do Performance Insights consome CPU e memória limitadas no host do banco de dados. Quando a carga do banco de dados é alta, o agente limita o impacto sobre a performance coletando dados com menos frequência.

Habilitar o Performance Insights ao criar um cluster

No console, você pode habilitar ou desabilitar o Performance Insights ao criar ou modificar uma nova instância de banco de dados.

Usar a AWS Management Console

No console, você pode ativar o recurso Performance Insights ao criar um cluster do Amazon DocumentDB. Ao criar um novo cluster do Amazon DocumentDB, ative o Performance Insights selecionando Ativar o Performance Insights na seção Performance Insights.

Instruções do console

1. Para criar um cluster, siga as instruções para Criar um cluster do Amazon DocumentDB.

2. Na seção Performance Insights, escolha Enable Performance Insights (Habilitar o Performance Insights).

   

   nota

   O período de retenção de dados do Performance Insights será de sete dias.

   AWS KMS chave — Especifica sua chave KMS AWS. O Performance Insights criptografa todos os dados potencialmente confidenciais usando a chave do AWS KMS. Os dados são criptografados em repouso e em trânsito. Para mais informações, consulte Configurar uma política AWS AWS KMS para Performance Insights.

Habilitar e desabilitar ao modificar uma instância

Você pode modificar uma instância de banco de dados para habilitar ou desabilitar o Performance Insights usando o console ou AWS CLI.

Using the AWS Management Console

Instruções do console

1. Faça login no AWS Management Console e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/docdb.

2. Escolha Clusters.

3. Escolha uma instância de banco de dados e Modify (Modificar).

4. Na seção Performance Insights, escolha Habilitar o Performance Insights ou Desabilitar o Performance Insights.

   nota

   Se você escolher Ativar Performance Insights, poderá especificar sua chave AWS AWS KMS. O Performance Insights criptografa todos os dados potencialmente confidenciais usando a chave do AWS KMS. Os dados são criptografados em repouso e em trânsito. Para obter mais informações, consulte Criptografando o Amazon DocumentDB de dados em repouso.

5. Escolha Continuar.

6. Em Scheduling of Modifications (Programação de modificações), selecione Apply immediately (Aplicar imediatamente). Se você escolher Aplicar durante a próxima janela de manutenção agendada, sua instância ignorará essa configuração e habilitará o Performance Insights imediatamente.

7. Escolha Modify instance (Modificar instância).

Using the AWS CLI

Ao usar os comandos create-db-instance ou modify-db-instance AWS AWS CLI, você pode ativar o Performance Insights especificando --enable-performance-insights ou desativá-lo especificando --no-enable-performance-insights.

O procedimento a seguir descreve como habilitar ou desabilitar o Performance Insights para uma instância de banco de dados usando a AWS AWS CLI.

AWS AWS CLI instruções

Chame o comando modify-db-instance AWS AWS CLI e forneça os seguintes valores:

• --db-instance-identifer — o nome da instância de banco de dados.

• --enable-performance-insights para habilitar ou --no-enable-performance-insights para desabilitar

O exemplo a seguir habilita o Performance Insights para a sample-db-instance.

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