# Ativar e desativar o Insights de Performance do Amazon RDS **Importante** A AWS anunciou a data de fim da vida útil do Insights de Performance: 30 de junho de 2026. Após essa data, o Amazon RDS não oferecerá mais suporte à experiência do console, aos períodos de retenção flexíveis (de 1 a 24 meses) e aos preços associados do Insights de Performance. A API do Insights de Performance continuará existindo sem alterações de preço. Os custos da API do Insights de Performance aparecerão em sua fatura da com o custo do CloudWatch Database Insights. Recomendamos que você atualize todas as instâncias de banco de dados usando o nível pago do Insights de Performance para o modo avançado do Database Insights antes de 30 de junho de 2026. Para ter informações sobre como atualizar para o modo avançado do Database Insights, consulte [Ativação do modo Avançado do Database Insights para Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md). Se você não tomar nenhuma medida, as instâncias de banco de dados que estão usando o Insights de Performance usarão como padrão o modo padrão do Database Insights. Com o modo padrão do Database Insights, você pode perder o acesso ao histórico de dados de desempenho após sete dias e talvez não consiga usar planos de execução e recursos de análise sob demanda no console do Amazon RDS. Após 30 de junho de 2026, somente o modo avançado do Database Insights aceitará planos de execução e análise sob demanda. Com o CloudWatch Database Insights, você pode monitorar a carga do banco de dados para sua frota de bancos de dados e analisar e solucionar problemas de desempenho em grande escala. Para ter mais informações sobre o Database Insights, consulte [Monitoramento de bancos de dados do Amazon RDS com o CloudWatch Database Insights](USER_DatabaseInsights.md). Para obter informações de definição de preço, consulte [Definição de preço do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/). É possível ativar o Insights de Performance para a instância de banco de dados ou o cluster de banco de dados multi-AZ durante a criação. Se necessário, você pode desativá-lo posteriormente modificando a instância de banco de dados no console. 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 [Visão geral do Performance Schema para o Insights de Performance no Amazon RDS para MariaDB ou MySQL](USER_PerfInsights.EnableMySQL.md). 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 Insights de Performance ao criar uma instância de banco de dados ou cluster de banco de dados multi-AZ** Depois de criar uma instância de banco de dados ou cluster de banco de dados multi-AZ, o Amazon RDS habilita o Insights de Performance por padrão. Para desativar o Insights de Performance, escolha a opção **Database Insights: padrão** e desmarque a opção **Habilitar Insights de Performance**. 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](USER_CreateDBInstance.md). + 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 para o Amazon RDS](create-multi-az-db-cluster.md). A captura de tela a seguir mostra a seção **Performance Insights**. ![\[Ativar o Performance Insights durante a criação da instância de banco de dados ou do cluster de banco de dados multi-AZ com o console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf_insights_enabling.png) Se você escolher **Enable Performance Insights (Habilitar o Performance Insights)** terá as seguintes opções: + **Retenção** (apenas para o modo padrão do Database Insights): o intervalo de tempo para reter os dados do Insights de Performance. A configuração de retenção é **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](USER_PerfInsights.Overview.cost.md). + **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 [Alterar uma política do AWS KMS para o Insights de Performance](USER_PerfInsights.access-control.cmk-policy.md). **Ativar ou desativar o Insights de Performance ao modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ** No console, é possível modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ para gerenciar o Insights de Performance. **Como gerenciar o Insights de Performance 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 Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Escolha **Databases (Bancos de dados)**. 1. Escolha uma instância de banco de dados ou um cluster de banco de dados multi-AZ e selecione **Modificar**. 1. Para ativar o Insights de Performance, selecione **Habilitar Insights de Performance**. Para desativar o Insights de Performance, escolha a opção **Database Insights: padrão** e desmarque a opção **Habilitar Insights de Performance**. Se você escolher **Enable Performance Insights (Habilitar o Performance Insights)** terá as seguintes opções: + **Retenção** (apenas para o modo padrão do Database Insights): o intervalo de tempo para reter os dados do Insights de Performance. A configuração de retenção é **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](USER_PerfInsights.Overview.cost.md). + **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](Overview.Encryption.md). 1. Escolha **Continue**. 1. 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. 1. Escolha **Modify instance (Modificar instância)**. ------ #### [ AWS CLI ] Ao usar o comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) da AWS CLI, ative o Insights de Performance especificando `--enable-performance-insights` e definindo `--database-insights-mode` como `advanced` ou `standard`. Para desativar o Insights de Performance, especifique `--no-enable-performance-insights` e `database-insights-mode` como `standard`. Você também pode especificar esses valores usando os seguintes comandos da AWS CLI: + [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) + [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) + [create-db-instance-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) + [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) + [restore-db-instance-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-s3.html) 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* \$1 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 \$1 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](USER_PerfInsights.Overview.cost.md). O exemplo a seguir ativa o Performance Insights para `sample-db-cluster` 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-cluster \ --database-insights-mode standard \ --db-cluster-identifier sample-db-instance \ --enable-performance-insights \ --performance-insights-retention-period 93 ``` Para Windows: ``` aws rds modify-db-cluster ^ --database-insights-mode standard ^ --db-cluster-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] ``` **nota** É possível ativar o Insights de Performance para uma instância em um cluster de banco de dados no qual o Insights de Performance não é gerenciado no nível do cluster. ------ #### [ RDS API ] Ao criar uma instância de banco de dados usando a operação [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) da API do Amazon RDS, ative o Performance Insights definindo `EnablePerformanceInsights` como `True`. Para desativar o Insights de Performance, defina `EnablePerformanceInsights` como `False` e `DatabaseInsightsMode` como `standard`. Também é possível especificar o valor `EnablePerformanceInsights` usando as seguintes operações da API: + [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) (cluster de banco de dados multi-AZ) + [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) (cluster de banco de dados multi-AZ) + [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) + [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) + [RestoreDBInstanceFromS3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromS3.html) 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* \$1 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 \$1 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](USER_PerfInsights.Overview.cost.md). ------