Criar uma avaliação de uma recomendação

Use as avaliações no Database Center para avaliar e testar o impacto de performance das recomendações de banco de dados antes de aplicá-las à sua frota de bancos de dados de produção.

Para avaliar as recomendações, as avaliações realizam estas operações:

  • Clona a instância do banco de dados.

  • Executa testes de simulação de benchmarking no clone.

  • Compara a performance de referência do clone com a performance depois de aplicar as mudanças de configuração recomendadas.

Produtos e recomendações com suporte

As avaliações do Database Center estão disponíveis apenas para instâncias do Cloud SQL para PostgreSQL.

É possível avaliar os seguintes tipos de recomendações:

  • Expansão de recursos de computação: avalia o impacto do redimensionamento de instâncias para tipos de máquinas com mais vCPUs ou memória.

  • Upgrade de edição: avalia o impacto de performance da migração da edição Enterprise do Cloud SQL para a edição Enterprise Plus do Cloud SQL para PostgreSQL. Para mais detalhes, consulte Fazer upgrade de uma instância para o Cloud SQL Enterprise Plus no local.

  • Ativação do cache de dados: analisa as implicações de latência e capacidade de processamento de ativação do cache de dados.

Antes de começar

Verifique se você atende aos seguintes requisitos antes de executar uma avaliação de recomendação:

  • Ativação da API: ative as seguintes APIs:

    Consulte Ativar e desativar APIs para ativar as APIs.

  • Credenciais de conexão do banco de dados: é necessário fornecer o nome do banco de dados de destino e um nome de usuário do banco de dados.

  • Secret do Secret Manager: é necessário armazenar a senha do nome de usuário do banco de dados em um secret global do Secret Manager e saber o nome do secret para poder pesquisá-lo no seletor de secrets. Você só precisa do caminho completo do secret se ele não aparecer na lista. Para mais informações sobre como criar secrets, consulte Criar e acessar secrets.

  • Conta de serviço: configure uma conta de serviço do Identity and Access Management (IAM) para o ambiente de benchmarking e compare a performance de referência com as mudanças recomendadas. Essa conta de serviço exige permissões para ler o secret de credenciais do banco de dados no Secret Manager e para coordenar tarefas de benchmarking no Cloud Run. Consulte Criar uma conta de serviço para configurar contas de serviço.

  • Permissões do IAM: é necessário ter as permissões do IAM necessárias para iniciar e gerenciar o processo de teste. Para mais informações, consulte Permissões necessárias do IAM.

Avaliar uma recomendação

Siga estas etapas para avaliar e testar uma recomendação:

  1. Acesse a página Database Center no Google Cloud console.

    Acessar o Database Center

  2. Clique em Avaliações no menu de navegação.

  3. Localize uma recomendação compatível para uma instância do Cloud SQL para PostgreSQL.

  4. Clique em Avaliar impacto na coluna Implicações dessa recomendação.

    Se você não ativou as APIs necessárias, siga as orientações no painel para ativá-las.

  5. Na página Detalhes da avaliação, insira os seguintes detalhes de conexão no painel de configuração:

    1. Em Banco de dados, insira o nome do banco de dados. As opções válidas correspondem aos bancos de dados listados na página Bancos de dados da instância do Cloud SQL.

    2. Em Nome de usuário, insira o nome de usuário do banco de dados.

    3. Em Secret de senha, selecione o secret do Secret Manager que contém a senha do usuário do banco de dados.

      Se o secret não aparecer na lista, insira o caminho do secret manualmente no formato projects/PROJECT_ID/secrets/SECRET_NAME. Substitua PROJECT_ID pelo ID do projeto e SECRET_NAME pelo nome do secret. Por padrão, o Database Center usa a versão mais recente do secret. Opcionalmente, especifique uma versão anexando /versions/VERSION ao caminho, substituindo VERSION pela versão do secret.

    4. Em Conta de serviço, selecione a conta de serviço a ser usada para executar os jobs de benchmarking.

  6. Clique em Gerar plano de teste. A geração do plano leva alguns minutos.

    O Database Center gera uma prévia do plano de teste mostrando a sequência de etapas para clonar o banco de dados, executar cargas de trabalho do pgbench, aplicar a recomendação e analisar a performance.

    O Database Center lista a sessão na página Avaliações quando gera o plano. É possível sair da página com segurança e retornar à sessão mais tarde.

  7. Para refinar o plano de teste, no campo Instruções de teste , insira instruções (por exemplo, Change the benchmark duration to 60 seconds) e clique em Atualizar plano de teste.

  8. Clique em Iniciar avaliação. Na caixa de diálogo de confirmação, revise o aviso de faturamento. O provisionamento da instância clonada e a execução de jobs de benchmarking são faturáveis no seu projeto.

    A sessão de avaliação fica disponível por 48 horas. O Database Center exclui automaticamente a instância clonada após uma avaliação bem-sucedida. Se a avaliação falhar, a instância clonada não será excluída automaticamente, e você precisará excluí-la manualmente.

  9. Clique em Confirmar para iniciar a avaliação. O processo de avaliação leva algum tempo para ser concluído.

    O Database Center mostra o progresso da avaliação. É possível sair da página com segurança enquanto a sessão é executada em segundo plano.

Conferir o histórico e os relatórios de avaliação

Gerencie as avaliações e revise os relatórios de comparação de performance rastreando as sessões de avaliação. O Database Center retém relatórios de sessão e metadados por 48 horas e mostra uma contagem regressiva de expiração para cada sessão.

  1. No Google Cloud console, acesse a página Database Center.

    Acessar o Database Center

  2. No menu de navegação, clique em Avaliações.

  3. Na lista de sessões, clique no ID da sessão para conferir os detalhes.

    A tabela a seguir descreve os status da sessão de avaliação, as informações mostradas para cada status e as ações disponíveis:

    Status Informações mostradas Ações disponíveis
    Fase de planejamento Detalhes e prévia do plano de teste. Refine a prévia do plano de teste usando o Instruções de teste campo ou clique em Iniciar avaliação para começar a avaliação.
    Fase de avaliação O progresso da avaliação e o plano de teste usado pela avaliação. Clique em Cancelar para cancelar a avaliação.
    Concluído Um resumo que compara a performance do banco de dados antes e depois de aplicar a recomendação. Nenhum
    Cancelado O progresso da avaliação antes de ser cancelada. Nenhum
    Falha na geração Falha na geração do plano de teste. É possível conferir os detalhes do plano de teste e os campos de configuração, como o nome do banco de dados e o nome do secret, para tentar gerar o plano de teste novamente. Atualize as definições de configuração da avaliação, como o nome do banco de dados e o nome de usuário, e tente gerar o plano de teste novamente.
    Falha na avaliação Falha na avaliação da recomendação. É possível conferir a mensagem de erro e o progresso da avaliação antes da falha. Nenhum

Cancelar uma sessão ou limpar sessões com falha

Se você cancelar uma sessão de avaliação em andamento ou se a execução falhar, verifique se todos os recursos temporários foram removidos. Como o Database Center não pode confirmar se a limpeza foi bem-sucedida após uma falha ou cancelamento, verifique e exclua as instâncias de clone de banco de dados restantes para todas as sessões com falha e canceladas.

  • Cancelar uma sessão: na página Avaliações, clique no ID da sessão da avaliação que você quer cancelar e clique em Cancelar. Para cancelar uma sessão, o ID da sessão precisa ter o status Fase de avaliação.

  • Limpar recursos clonados:

    Para excluir manualmente a instância clonada:

    1. No Google Cloud console, acesse a página Instâncias do Cloud SQL.

      Acessar "Instâncias do Cloud SQL"

    2. Na lista de instâncias, localize a instância clonada. É possível identificar o clone usando o link de recurso mostrado na página de detalhes da sessão.

    3. Clique em Mais ações ao lado da instância clonada e clique em Excluir.

    4. Na caixa de diálogo de confirmação, insira o nome da instância clonada e clique em Excluir.

Permissões do IAM obrigatórias

Você precisa de permissões específicas para iniciar e gerenciar o processo de teste. Receba essas permissões atribuindo papéis predefinidos ou criando papéis personalizados com permissões individuais.

Consulte Controle de acesso com o IAM para gerenciar o acesso e entender os papéis.

Permissões para o usuário final

A tabela a seguir lista as permissões necessárias para sua conta de usuário e os papéis predefinidos que as contêm:

Permissões necessárias Papel predefinido
cloudsql.instances.patch
cloudsql.instances.clone
cloudsql.instances.delete
cloudsql.instances.get
cloudsql.instances.createTestingAgentSession
cloudsql.instances.getAgentSession
cloudsql.instances.listAgentSessions
cloudsql.instances.cancelAgentSession 		roles/cloudsql.admin
run.jobs.create
run.jobs.run 		roles/run.developer
logging.logEntries.list roles/logging.viewer
secretmanager.secrets.list roles/secretmanager.viewer
serviceusage.services.use roles/serviceusage.serviceUsageConsumer
monitoring.monitoredResourceDescriptors.list (opcional) roles/monitoring.viewer ou roles/viewer

Para conferir os dados dos gráficos na página de resultados da avaliação, sua conta de usuário precisa ter a permissão monitoring.monitoredResourceDescriptors.list. Essa permissão é recomendada, mas não é necessária para executar avaliações de recomendação.

O usuário que inicia a avaliação também precisa ter o papel de usuário da conta de serviço (roles/iam.serviceAccountUser) ou a iam.serviceAccounts.actAs permissão na conta de serviço selecionada.

Permissões para a conta de serviço do Cloud Run

A tabela a seguir lista as permissões necessárias para a conta de serviço usada pelos jobs do Cloud Run e os papéis predefinidos que as contêm:

Permissões necessárias Papel predefinido
cloudsql.instances.connect roles/cloudsql.client
cloudsql.instances.login roles/cloudsql.instanceUser
secretmanager.versions.access roles/secretmanager.secretAccessor

Limitações

Considere as seguintes limitações ao usar a avaliação de recomendação:

  • Relatório informativo apenas: a avaliação não aplica modificações aos bancos de dados de produção. Se você aprovar os resultados do benchmarking, aplique as recomendações manualmente usando o console do Cloud SQL para PostgreSQL ou as APIs do Cloud SQL para PostgreSQL.

  • Expiração de 48 horas: o Database Center retém relatórios de sessão e metadados no armazenamento de sessão por apenas 48 horas e, em seguida, os exclui.

  • Isolamento de usuário único: apenas o usuário que criou uma sessão de validação pode visualizá-la. Outros principais no seu projeto não podem conferir o histórico ou os resultados da sessão.

  • Localização global do secret: o secret do Secret Manager que contém a senha do banco de dados precisa ser um secret global. Secrets regionais não são compatíveis.

Faturamento

Uma avaliação de recomendação gera cobranças pelos recursos usados durante a avaliação. O sistema cria um clone da instância do banco de dados no seu projeto, e você paga por esse clone. O Database Center exclui automaticamente o clone após uma avaliação bem-sucedida. Se uma avaliação falhar ou for cancelada, você precisará excluir o clone manualmente para evitar cobranças contínuas.

Além disso, o agente de banco de dados usa outra Google Cloud infraestrutura que pode gerar custos, incluindo:

  • Cloud SQL: para a instância clonada. Para mais detalhes, consulte Preços do Cloud SQL.
  • Cloud Run: para executar o agente de avaliação. Para mais detalhes, consulte Preços do Cloud Run.
  • Outros serviços: pequenas cobranças por outros serviços usados para coordenar a avaliação.

Você paga apenas pelo tempo em que a avaliação é executada.

A seguir