Analise o desempenho de uma instância do AlloyDB com o pgbench

Neste tutorial, integra uma instância do AlloyDB e uma instância de VM do Compute Engine numa rede da nuvem privada virtual (VPC). Em seguida, valide a integração instalando o pgbench na instância de VM do Compute Engine e use esta ferramenta de testes de referência para realizar testes de desempenho na instância do AlloyDB.

Nota: embora possa usar o pgbench para executar testes de desempenho básicos com o AlloyDB, para testes de referência de processamento de transações online (OLTP), consulte as ferramentas e a metodologia descritas no guia de testes de referência transacionais (OLTP) do AlloyDB.

Objetivos

Neste tutorial, vai aprender a:

• Crie uma rede da VPC para a sua instância do AlloyDB e a instância de VM do Compute Engine para que a comunicação possa passar entre a instância e a VM em segurança.
• Crie uma instância do AlloyDB e uma instância de VM do Compute Engine, e atribua e configure a sua rede VPC para ambas as instâncias.
• Instale o pgbench na instância de VM do Compute Engine, execute-o na instância do AlloyDB e use-o para realizar testes de desempenho na instância do AlloyDB.

Custos

Este tutorial usa componentes faturáveis do Google Cloud, incluindo a rede da VPC, o AlloyDB e o Compute Engine. Use a calculadora de preços para gerar uma estimativa de custos com base na sua utilização projetada.

Antes de começar

1. Na Google Cloud consola, na página do seletor de projetos, selecione ou crie um Google Cloud projeto.

   Nota: se não planeia manter os recursos que criar neste procedimento, crie um projeto em vez de selecionar um projeto existente. Depois de concluir estes passos, pode eliminar o projeto, removendo todos os recursos associados ao mesmo.

   Aceda à página do seletor de projetos

2. Certifique-se de que a faturação está ativada para o seu Google Cloud projeto. Saiba como confirmar que a faturação está ativada para o seu projeto.

3. Ative as APIs de rede VPC, AlloyDB e Compute Engine.

   Ative as APIs

4. Certifique-se de que tem a função de administrador do AlloyDB atribuída à sua conta de utilizador.

   Aceda à página IAM

Crie uma rede de VPC

Nesta secção, cria uma rede da VPC para a sua instância do AlloyDB e a instância de VM do Compute Engine para que a comunicação possa passar entre a instância e a VM em segurança.

1. Aceda à página Redes VPC na Google Cloud consola.

   Aceda à página Redes de VPC

2. Clique em Criar rede de VPC. É apresentada a página Criar uma rede de VPC.

3. Introduza my-vpc-network para o Nome da sua rede VPC.

4. Na secção Modo de criação de sub-rede, selecione a opção Personalizado.

5. Clique em ADICIONAR SUBNET.

6. Introduza my-subnet para o Nome da sua sub-rede.

7. Selecione uma Região e introduza um Intervalo de endereços IP para a sua sub-rede.

8. Clique em CONCLUIR.

9. Clique em CRIAR.

Nota: a criação da sua rede VPC pode demorar alguns segundos. Além disso, para saber mais sobre as redes VPC, consulte o artigo Vista geral da rede VPC.

Crie uma instância do AlloyDB

Nesta secção, cria uma instância do AlloyDB e atribui e configura a sua rede VPC para a instância.

1. Na Google Cloud consola, aceda à página Clusters.

   Aceda a Clusters

2. Clique em Criar cluster.

3. Configure o cluster da seguinte forma:

   1. No campo ID do cluster da secção Informações básicas, introduza my-cluster.

   2. No campo Palavra-passe, introduza a palavra-passe que quiser. Tome nota desta palavra-passe. Vai usá-la novamente mais tarde neste tutorial.

   3. No campo Região da secção Localização, selecione us-central1 (Iowa).

   4. No campo Versão da base de dados, mantenha o valor predefinido.

   5. No menu Rede, selecione my-vpc-network. Criou esta rede de VPC em Criar uma rede de VPC.

   6. Uma vez que a sua rede VPC ainda não inicializou o acesso a serviços privados, clique em Configurar ligação.

      Nota: uma ligação de serviço privado permite que a sua instância do AlloyDB e a VM do Compute Engine que vai criar comuniquem exclusivamente através de endereços IP internos.

   7. No painel Crie uma ligação de serviço privada apresentado:

      1. Selecione a opção Usar um intervalo de IP atribuído automaticamente para que o Google Cloud intervalo de IP atribuído automaticamente seja selecionado na sua rede.

      2. Clique em Continuar.

      3. Clique em Criar associação.

      Nota: a criação da sua ligação de serviço privada pode demorar alguns segundos. Depois de isto acontecer, o painel Criar uma ligação de serviço privada desaparece e é apresentada a mensagem de estado Ligação de serviço privada para a rede [VPC-network-name] criada com êxito.

4. Configure a instância principal da seguinte forma:

   1. No campo ID da instância, introduza um ID para a sua instância principal.

   2. Em Disponibilidade zonal, selecione uma das seguintes opções:

      1. Para criar uma instância de produção de elevada disponibilidade com comutação por falha automática, selecione Várias zonas (elevada disponibilidade).

      2. Para criar uma instância básica que não precise de estar altamente disponível, selecione Zona única.

   3. Selecione um tipo de máquina.

5. Clique em Criar cluster para criar o cluster e a instância principal em conjunto.

   Nota: a criação da instância do AlloyDB pode demorar alguns minutos.

6. Tome nota do endereço IP privado da sua instância do AlloyDB que aparece na página Instâncias do AlloyDB. Precisa deste endereço para validar a integração entre a instância do AlloyDB e a instância da VM do Compute Engine.

Crie uma instância de VM do Compute Engine

Nesta secção, cria uma instância de VM do Compute Engine, e atribui e configura a sua rede VPC para a instância.

1. Aceda à página Instâncias de VM na Google Cloud consola.

   Aceda à página de instâncias de VM

2. Clique em Criar instância.

3. No campo Nome da página Criar uma instância, introduza um identificador exclusivo para a instância de VM do Compute Engine que está a criar. Para este tutorial, introduza my-compute-engine-vm-instance no campo.

4. Na secção Âmbitos de acesso da página, selecione a opção Permitir acesso total a todas as APIs Cloud.

5. Expanda Opções avançadas e, de seguida, conclua os seguintes passos:

   1. Clique no subseparador Rede.

   2. Clique em Adicionar uma interface de rede.

   3. No menu Rede, selecione my-vpc-network. Criou esta rede de VPC em Criar uma rede de VPC.

   4. Clique em Concluído. São apresentadas duas redes VPC na secção Interfaces de rede da página: default e my-vpc-network

6. Clique em Eliminar para eliminar a rede VPC predefinida.

   Ao eliminar a rede VPC predefinida, força a sua instância de VM do Compute Engine a usar a rede VPC que criou neste tutorial.

7. Clique em Criar.

   A criação da instância de VM do Compute Engine pode demorar alguns segundos. Depois de isto acontecer, a instância aparece na página Instâncias de VM e o estado desta instância é Em execução (como indicado pela marca de verificação).

Valide a integração

Nesta secção, instala o pgbench na instância de VM do Compute Engine, executa-o na instância do AlloyDB e usa-o para realizar testes de desempenho na instância do AlloyDB.

1. Estabeleça ligação à sua instância de VM do Compute Engine. Para o fazer, clique no menu SSH à direita da instância de VM e, de seguida, selecione Abrir na janela do navegador.

2. Instale o pacote Contributed Extensions and Additions to PostgreSQL na sua instância de VM do Compute Engine.

   sudo apt-get -y install postgresql-contrib

3. Inicialize uma base de dados para o pgbench na sua instância do AlloyDB for PostgreSQL. Por exemplo, use a base de dados postgres predefinida:

   pgbench -i --host=INSTANCE_PRIVATE_IP --port=PORT_NUMBER --username=USERNAME

   Substitua o seguinte:

   • INSTANCE_PRIVATE_IP: o endereço IP privado da sua instância do AlloyDB. Anotou este endereço IP quando criou a instância.
   • PORT_NUMBER: o número da porta reservado para a sua instância do AlloyDB. Para este tutorial, o número da porta é 5432.
   • USERNAME: o nome de utilizador do administrador da sua instância do AlloyDB. Para este tutorial, o nome de utilizador é postgres.

4. No comando Password, introduza a palavra-passe da sua instância do AlloyDB. Quando criou a instância, forneceu uma palavra-passe para a mesma ou pediu ao AlloyDB para gerar uma palavra-passe para si.

5. Execute pgbench sem argumentos para validar as funcionalidades básicas.

   pgbench --host=INSTANCE_PRIVATE_IP --port=PORT_NUMBER --username=USERNAME

6. No comando Password, introduza a palavra-passe da sua instância do AlloyDB.

   Deverá ver uma saída semelhante à seguinte:

   starting vacuum...end.
   transaction type: <builtin: TPC-B (sort of)>
   scaling factor: 1
   query mode: simple
   number of clients: 1
   number of threads: 1
   number of transactions per client: 10
   number of transactions actually processed: 10/10
   latency average = 3.794 ms
   tps = 263.560171 (including connections establishing)
   tps = 345.375423 (excluding connections establishing)

7. Use algumas opções para fazer um teste útil. Algumas opções importantes são -c (o número de clientes) e --transactions (o número de transações por cliente).

   Para este tutorial, faça um teste de desempenho em 10 clientes que estão a aceder à sua base de dados do AlloyDB for PostgreSQL e 100 transações para cada cliente.

   pgbench --host=INSTANCE_PRIVATE_IP --port=PORT_NUMBER --username=USERNAME -c 10 --transactions=100

8. No comando Password, introduza a palavra-passe da sua instância do AlloyDB.

   Deverá ver uma saída semelhante à seguinte:

   starting vacuum...end.
   transaction type:  TPC-B (sort of)>
   scaling factor: 1
   query mode: simple
   number of clients: 10
   number of threads: 1
   number of transactions per client: 100
   number of transactions actually processed: 1000/1000
   latency average = 36.421 ms
   tps = 274.563444 (including connections establishing)
   tps = 275.733225 (excluding connections establishing)

Limpar

Depois de concluir este tutorial, pode limpar os recursos que criou para que não ocupem quota e não lhe sejam cobrados no futuro.

Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados neste tutorial, siga estes passos.

1. Use a Google Cloud consola para eliminar o seu projeto, instância do AlloyDB, instância de VM do Compute Engine e rede VPC.

As secções seguintes descrevem como eliminar ou desativar estes recursos.

Elimine o projeto

A forma mais fácil de eliminar a faturação é eliminar o projeto que criou para este tutorial.

A eliminação de um projeto tem os seguintes efeitos:

• Tudo no projeto é eliminado. Se usou um projeto existente para este tutorial, quando o eliminar, também elimina qualquer outro trabalho que tenha feito no projeto.
• Os IDs dos projetos personalizados são perdidos. Quando criou este projeto, pode ter criado um ID do projeto personalizado que quer usar no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, elimine os recursos selecionados no projeto em vez de eliminar o projeto inteiro.

Se planeia explorar vários tutoriais e inícios rápidos, a reutilização de projetos pode ajudar a evitar exceder os limites de quota de projetos.

1. Aceda à página Gerir recursos na Google Cloud consola.

   Aceda à página Gerir recursos

2. Na lista de projetos, selecione o projeto que quer eliminar e, de seguida, clique em Eliminar.

3. Na caixa de diálogo, escreva o ID do projeto e, de seguida, clique em Encerrar para eliminar o projeto.

Elimine a instância do AlloyDB

1. Aceda à página AlloyDB Clusters na Google Cloud consola.

   Aceda à página Clusters do AlloyDB

2. Clique no nome da sua instância do AlloyDB. Para este tutorial, clique em my-instance.

3. Clique em ELIMINAR.

4. Na caixa de diálogo, introduza o nome da sua instância do AlloyDB no campo de texto e, de seguida, clique em ELIMINAR.

Elimine a instância de VM do Compute Engine

1. Aceda à página Instâncias de VM na Google Cloud consola.

   Aceda à página de instâncias de VM

2. Clique no nome da instância de VM do Compute Engine. Para este tutorial, clique em my-compute-engine-vm-instance.

3. Clique no ícone Eliminar. Este ícone assemelha-se a um caixote do lixo.

4. Na caixa de diálogo, clique em ELIMINAR.

   Nota: a eliminação da instância de VM do Compute Engine pode demorar alguns segundos.

Elimine a rede de VPC

1. Aceda à página Redes VPC na Google Cloud consola.

   Aceda à página Redes de VPC

2. Clique no nome da sua rede de VPC. Para este tutorial, clique em my-vpc-network.

3. Clique em ELIMINAR REDE DE VPC.

4. Na caixa de diálogo, clique em ELIMINAR.