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 Aurora

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 o cluster de banco de dados e desabilitá-las posteriormente modificando o cluster 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 Aurora 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 Aurora MySQL.

Se você usar métricas detalhadas por consulta e métricas de contador do banco de dados com bancos de dados globais do Aurora, habilite-as individualmente para os bancos de dados em cada Região da AWS. Para obter detalhes, consulte Monitorando um banco de dados Amazon Aurora global com Performance Insights Amazon RDS.

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 um cluster de banco de dados. Habilitar as métricas detalhadas por consulta e métricas de contador do banco de dados permite gerenciar as configurações e opções do Database Insights para o cluster de banco de dados. As configurações no nível do cluster se aplicam a todas as instâncias de banco de dados no cluster.

Habilitar ou desabilitar métricas detalhadas por consulta e métricas de contador do banco de dados ao criar um cluster de banco de dados

Depois de criar um cluster de banco de dados, 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 criar um cluster de banco de dados, siga as instruções relacionadas ao mecanismo de banco de dados em Criar um cluster de bancos de dados do Amazon Aurora.

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

Seção Database Insights na página de criação do cluster 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 um cluster de banco de dados

No console, é possível modificar um cluster de banco de dados 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 um cluster de banco de dados 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 um cluster de banco de dados 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 no cluster de banco de dados, 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 Aurora.

    Seção Database Insights na página de modificação do cluster 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:

Como gerenciar métricas detalhadas por consulta e métricas de contador do banco de dados para um cluster de banco de dados usando a AWS CLI

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

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

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

    • database-insights-mode: o modo do Database Insights para o cluster de banco de dados. Para desabilitar as métricas detalhadas por consulta e métricas de contador do banco de dados, defina esse valor como standard.

    O exemplo a seguir habilita as métricas detalhadas por consulta e métricas de contador do banco de dados para sample-db-cluster.

    Para Linux, macOS ou Unix:

    aws rds modify-db-cluster \
	--database-insights-mode standard \
    --db-cluster-identifier sample-db-instance \
    --enable-performance-insights

    Para Windows:

    aws rds modify-db-cluster ^
	--database-insights-mode standard ^
    --db-cluster-identifier sample-db-instance ^
    --enable-performance-insights

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 no cluster 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.