Ativar e desativar o Performance Insights

Você pode ativar o Performance Insights para sua instância de cluster de banco de dados ou cluster de banco de dados multi-AZ ao criá-lo. Se necessário, você poderá desativá-lo posteriormente. A ativação e a desativação do Performance Insights não causa tempo de inatividade, reinicialização ou failover.

nota

O Performance Schema é uma ferramenta de performance opcional usada pelo Amazon RDS para MariaDB ou MySQL. Se você ativar ou desativar o Performance Schema, será necessário reinicializar. No entanto, se você ativar ou desativar o Performance Insights, não será necessário reinicializar. Para obter mais informações, consulte Ativar o Performance Schema para o Performance Insights no Amazon RDS para MariaDB ou MySQL.

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.

Console

No console, ative ou desative o Performance Insights ao criar ou modificar uma instância de banco de dados ou cluster de banco de dados multi-AZ.

Ativar ou desativar o Performance Insights ao criar uma instância de banco de dados ou cluster de banco de dados multi-AZ

Ao criar uma instância de banco de dados ou um cluster de banco de dados multi-AZ, ative o Performance Insights escolhendo Enable Performance Insights (Habilitar o Performance Insights) na seção Performance Insights. Ou escolha Disable Performance Insights (Desabilitar o Performance Insights). Para obter mais informações, consulte os tópicos a seguir:

• Para criar uma instância de banco de dados, siga as instruções do seu mecanismo de banco de dados em Criar uma instância de banco de dados do Amazon RDS.

• Para criar um cluster de banco de dados multi-AZ, siga as instruções relacionadas ao seu mecanismo de banco de dados em Criar um cluster de banco de dados multi-AZ.

A captura de tela a seguir mostra a seção Performance Insights.

Se você escolher Enable Performance Insights (Habilitar o Performance Insights) terá as seguintes opções:

• Retention (Retenção) – a duração do período de retenção de dados do Performance Insights. A configuração de retenção no nível gratuito é Default (7 days) [Padrão (7 dias)]. Para reter seus dados de performance por mais tempo, especifique entre 1 e 24 meses. Para obter mais informações sobre os períodos de retenção, consulte Preços e retenção de dados para o Performance Insights.

• AWS KMS key: especifica a sua AWS KMS key. O Performance Insights criptografa todos os possíveis dados sigilosos usando a sua chave do KMS. Os dados são criptografados em repouso e em trânsito. Para obter mais informações, consulte Como configurar uma política do AWS KMS para o Performance Insights.

Ativar ou desativar o Performance Insights ao modificar uma instância de banco de dados ou no cluster de banco de dados multi-AZ

No console, é possível modificar uma instância de banco de dados ou cluster de banco de dados multi-AZ para ativar ou desativar o Performance Insights.

Como ativar ou desativar o Performance Insights para uma instância de banco de dados ou um cluster de banco de dados multi-AZ usando o console

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

2. Escolha Databases (Bancos de dados).

3. Escolha uma instância de banco de dados ou um cluster de banco de dados multi-AZ e escolha Modify (Modificar).

4. Na seção Performance Insights, escolha Enable Performance Insights (Habilitar o Performance Insights) ou Disable Performance Insights (Desabilitar o Performance Insights).

   Se você escolher Enable Performance Insights (Habilitar o Performance Insights) terá as seguintes opções:

   • Retention (Retenção) – a duração do período de retenção de dados do Performance Insights. A configuração de retenção no nível gratuito é Default (7 days) [Padrão (7 dias)]. Para reter seus dados de performance por mais tempo, especifique entre 1 e 24 meses. Para obter mais informações sobre os períodos de retenção, consulte Preços e retenção de dados para o Performance Insights.

   • AWS KMS key: especifique a sua chave do KMS. O Performance Insights criptografa todos os possíveis dados sigilosos usando a sua chave do KMS. Os dados são criptografados em repouso e em trânsito. Para obter mais informações, consulte Criptografar recursos do Amazon RDS.

5. Escolha Continue.

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

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

AWS CLI

Ao usar o comando da AWS CLI create-db-instance ative o Performance Insights especificando --enable-performance-insights. Ou desative o Performance Insights especificando --no-enable-performance-insights.

Você também pode especificar esses valores usando os seguintes comandos da AWS CLI:

• create-db-instance-read-replica

• modify-db-instance

• restore-db-instance-from-s3

• create-db-cluster (cluster de banco de dados multi-AZ)

• modify-db-cluster (cluster de banco de dados multi-AZ)

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

Como ativar ou desativar o Performance Insights para uma instância de banco de dados em seu cluster de banco de dados usando a AWS CLI

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

  • --db-instance-identifier: o nome da instância de banco de dados.

  • --enable-performance-insights para ativar ou --no-enable-performance-insights para desativar

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

  Para Linux, macOS ou Unix:

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

  Para Windows:

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

Quando você ativa o Performance Insights na CLI, é possível especificar o número de dias para retenção dos dados do Performance Insights com a opção --performance-insights-retention-period. Você pode especificar 7, mês * 31 (em que mês é um número de 1 a 23) ou 731. Por exemplo, se você quiser reter seus dados de desempenho por 3 meses, especifique 93, que é 3 * 31. O padrão são 7 dias. Para obter mais informações sobre os períodos de retenção, consulte Preços e retenção de dados para o Performance Insights.

O exemplo a seguir ativa o Performance Insights para sample-db-instance e especifica que os dados do Performance Insights serão retidos por 93 dias (3 meses).

Para Linux, macOS ou Unix:

aws rds modify-db-instance \
    --db-instance-identifier sample-db-instance \
    --enable-performance-insights \
    --performance-insights-retention-period 93   

Para Windows:

aws rds modify-db-instance ^
    --db-instance-identifier sample-db-instance ^
    --enable-performance-insights ^
    --performance-insights-retention-period 93  

Se você especificar um período de retenção como 94 dias, que não é um valor válido, o RDS emitirá um erro.

An error occurred (InvalidParameterValue) when calling the CreateDBInstance operation: 
Invalid Performance Insights retention period. Valid values are: [7, 31, 62, 93, 124, 155, 186, 217, 
248, 279, 310, 341, 372, 403, 434, 465, 496, 527, 558, 589, 620, 651, 682, 713, 731]

API do RDS

Ao criar uma instância de banco de dados usando a operação CreateDBInstance da API do Amazon RDS, ative o Performance Insights definindo EnablePerformanceInsights como True. Para desativar o Performance Insights, defina EnablePerformanceInsights como False.

Também é possível especificar o valor EnablePerformanceInsights usando as seguintes operações da API:

• ModifyDBInstance

• CreateDBInstanceReadReplica

• RestoreDBInstanceFromS3

• CreateDBCluster (cluster de banco de dados multi-AZ)

• ModifyDBCluster (cluster de banco de dados multi-AZ)

Quando você ativar o Performance Insights, é possível especificar a quantidade de tempo, em dias, para a retenção de dados do Performance Insights com o parâmetro PerformanceInsightsRetentionPeriod. Você pode especificar 7, mês * 31 (em que mês é um número de 1 a 23) ou 731. Por exemplo, se você quiser reter seus dados de desempenho por 3 meses, especifique 93, que é 3 * 31. O padrão são 7 dias. Para obter mais informações sobre os períodos de retenção, consulte Preços e retenção de dados para o Performance Insights.