View a markdown version of this page

Habilitar e desabilitar métricas detalhadas por consulta e métricas de contador do banco de dados - Amazon Relational Database Service

Habilitar e desabilitar métricas detalhadas por consulta e métricas de contador do banco de dados

As métricas detalhadas por consulta e métricas de contador do banco de dados são habilitadas por padrão quando você seleciona o modo Avançado do Database Insights. Se você selecionar o modo Padrão do Database Insights, poderá habilitá-las ao criar a instância de banco de dados ou o cluster de banco de dados multi-AZ e desabilitá-las posteriormente modificando a instância de banco de dados pelo console. Habilitar as métricas detalhadas por consulta e métricas de contador do banco de dados não causa tempo de inatividade, reinicialização nem 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. Se você habilitar ou desabilitar as métricas detalhadas por consulta e métricas de contador do banco de dados, não será necessário reinicializar. Para obter mais informações, consulte Visão geral do Performance Schema para o Database Insights no Amazon RDS para MariaDB ou MySQL.

O agente do Database Insights consome uma quantidade limitada de CPU e memória 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, é possível habilitar a coleta de métricas detalhadas por consulta e métricas de contador do banco de dados para o modo Padrão do Database Insights ao criar ou modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ.

Habilitar ou desabilitar métricas detalhadas por consulta e métricas de contador do banco de dados ao criar uma instância de banco de dados ou um cluster de banco de dados multi-AZ

Depois de criar uma instância de banco de dados ou um cluster de banco de dados multi-AZ, o Amazon RDS habilita as métricas detalhadas por consulta e métricas de contador do banco de dados por padrão. Para desabilitá-las, escolha a opção Database Insights: padrão e desmarque a opção Habilitar a coleta de métricas detalhadas por consulta e métricas de contador do banco de dados.

Para obter mais informações, consulte os tópicos a seguir.

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

Seção Database Insights na página de criação da instância de banco de dados, com a opção para habilitar métricas detalhadas do banco de dados.

Se você escolher Habilitar a coleta de métricas detalhadas por consulta e métricas de contador do banco de dados, terá as seguintes opções:

  • Retenção: o período durante o qual os dados do Database Insights serão mantidos. 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 do Database Insights.

  • AWS KMS key – especifica a sua AWS KMS key. O Database Insights criptografa todos os dados potencialmente sensíveis usando sua chave do KMS. Os dados são criptografados em repouso e em trânsito. Consulte mais informações em Alterar uma política de chave do KMS para o Database Insights.

Habilitar ou desabilitar métricas detalhadas por consulta e métricas de contador do banco de dados 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 métricas detalhadas por consulta e métricas de contador do banco de dados para o Database Insights.

Como gerenciar métricas detalhadas por consulta e métricas de contador do banco de dados 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/.

  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 selecione Modificar.

  4. Selecione Habilitar a coleta de métricas detalhadas por consulta e métricas de contador do banco de dados para habilitá-las. Para desabilitá-las, escolha a opção Database Insights – Padrão e desmarque a opção Habilitar a coleta de métricas detalhadas por consulta e métricas de contador do banco de dados.

    Se você escolher Habilitar a coleta de métricas detalhadas por consulta e métricas de contador do banco de dados, terá as seguintes opções:

    • Retenção: o período durante o qual os dados do Database Insights serão mantidos. 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 do Database Insights.

    • AWS KMS key – especifique a sua chave do KMS. O Database Insights criptografa todos os dados potencialmente sensíveis usando 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.

    Seção Database Insights na página de modificação da instância de banco de dados, com a opção para habilitar métricas detalhadas do banco de dados.

  5. Escolha Continue.

  6. Em Scheduling of Modifications (Programação de modificações), escolha Apply immediately (Aplicar imediatamente). Se você escolher Aplicar durante a próxima janela de manutenção programada, a instância ignorará essa configuração e habilitará imediatamente a coleta de métricas detalhadas por consulta e métricas de contador do banco de dados.

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

AWS CLI

Ao usar o comando create-db-instance da AWS CLI, habilite as métricas detalhadas por consulta e métricas de contador do banco de dados especificando --enable-performance-insights e defina --database-insights-mode como advanced ou standard. Para desabilitá-las, especifique --no-enable-performance-insights e defina database-insights-mode como standard.

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

Ao habilitar as métricas detalhadas por consulta e métricas de contador do banco de dados pela CLI, é possível especificar opcionalmente o número de dias durante os quais os dados serão mantidos usando 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 do Database Insights.

O exemplo a seguir habilita as métricas detalhadas por consulta e métricas de contador do banco de dados para sample-db-cluster e especifica que os dados serão mantidos 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

Só é possível alternar as métricas detalhadas por consulta e métricas de contador do banco de dados para uma instância em um cluster de banco de dados no qual elas não sejam gerenciadas no nível do cluster.

RDS API

Ao criar uma nova instância de banco de dados usando a operação CreateDBInstance da API do Amazon RDS, habilite as métricas detalhadas por consulta e métricas de contador do banco de dados definindo EnablePerformanceInsights como True. Para desabilitá-las, defina EnablePerformanceInsights como False e defina DatabaseInsightsMode como standard.

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

Ao habilitar as métricas detalhadas por consulta e métricas de contador do banco de dados, é possível especificar opcionalmente o período, em dias, durante o qual os dados serão mantidos usando 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 do Database Insights.