As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Ativar e desativar o Performance Insights
<a name="performance-insights-enabling"></a>

Para usar o Performance Insights, ative-o em sua instância de banco de dados. É possível 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
<a name="performance-insights-enabling-create-instance"></a>

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

### Usando o Console de gerenciamento da AWS
<a name="create-instance-console"></a>

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](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-create.html).

1. Na seção Performance Insights, escolha **Habilitar Performance Insights**.  
![\[A seção Insights de performance com Habilitar Insights de performance selecionado.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/select-performance-insights.png)
**nota**  
O período de retenção de dados do Performance Insights será de sete dias.

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

## Habilitar e desabilitar ao modificar uma instância
<a name="performance-insights-enabling-modify-instance"></a>

É possível modificar uma instância de banco de dados para habilitar ou desabilitar o Performance Insights usando o console ou AWS CLI.

------
#### [ Using the Console de gerenciamento da AWS ]

**Instruções do console**

1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)

1. Escolha **Clusters**.

1. Escolha uma instância de banco de dados e **Modificar**.

1. 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 AWS AWS KMS chave. O Performance Insights criptografa todos os dados potencialmente confidenciais usando sua AWS KMS chave. 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](https://docs.aws.amazon.com/documentdb/latest/developerguide/encryption-at-rest.html).

1. Escolha **Continue**.

1. Em **Programação das modificações**, selecione **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.

1. Escolha **Modificar instância**.

------
#### [ Using the AWS CLI ]

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

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 `modify-db-instance` AWS AWS CLI comando 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

**Example**  
O exemplo a seguir habilita o Performance Insights para a `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
```

------