Analizza le prestazioni di un'istanza AlloyDB con pgbench

In questo tutorial, integrerai un'istanza AlloyDB e un'istanza VM di Compute Engine in una rete Virtual Private Cloud (VPC). Verificherai quindi l'integrazione installando pgbench sull'istanza VM di Compute Engine e utilizzerai questo strumento di benchmarking per eseguire test delle prestazioni sull'istanza AlloyDB.

Nota: anche se puoi utilizzare pgbench per eseguire test delle prestazioni di base con AlloyDB, per il benchmarking dell'elaborazione transazionale online (OLTP), consulta gli strumenti e la metodologia descritti nella Guida al benchmarking dell'elaborazione transazionale (OLTP) di AlloyDB.

Obiettivi

In questo tutorial imparerai a:

• Creare una rete VPC per l'istanza AlloyDB e l'istanza VM di Compute Engine in modo che la comunicazione possa passare tra l'istanza e la VM in modo sicuro.
• Creare un'istanza AlloyDB e un'istanza VM di Compute Engine, nonché assegnare e configurare la rete VPC per entrambe le istanze.
• Installare pgbench sull'istanza VM di Compute Engine, eseguirlo sull'istanza AlloyDB e utilizzarlo per eseguire test delle prestazioni sull'istanza AlloyDB.

Costi

Questo tutorial utilizza componenti fatturabili di Google Cloud, tra cui rete VPC, AlloyDB e Compute Engine. Utilizza il calcolatore prezzi per generare una stima dei costi in base all'utilizzo previsto.

Prima di iniziare

1. Nella Google Cloud console, nella pagina di selezione del progetto, seleziona o crea un Google Cloud progetto.

   Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

   Vai alla pagina del selettore dei progetti

2. Verifica che la fatturazione sia attivata per il tuo Google Cloud progetto. Scopri come verificare che la fatturazione sia attivata per il tuo progetto.

3. Abilita le API di rete VPC, AlloyDB e Compute Engine.

   Abilita le API

4. Assicurati di avere il ruolo Amministratore AlloyDB assegnato al tuo account utente.

   Vai alla pagina IAM

Crea una rete VPC

In questa sezione, creerai una rete VPC per l'istanza AlloyDB e l'istanza VM di Compute Engine in modo che la comunicazione possa passare tra l'istanza e la VM in modo sicuro.

1. Vai alla pagina Reti VPC nella Google Cloud console.

   Vai alla pagina Reti VPC

2. Fai clic su Crea rete VPC. Viene visualizzata la pagina Crea una rete VPC.

3. Inserisci my-vpc-network nel campo Nome della rete VPC.

4. Nella sezione Modalità di creazione subnet, seleziona l'opzione Personalizzata.

5. Fai clic su AGGIUNGI SUBNET.

6. Inserisci my-subnet nel campo Nome della subnet.

7. Seleziona una regione e inserisci un intervallo di indirizzi IP per la subnet.

8. Fai clic su FINE.

9. Fai clic su CREA.

Nota: la creazione della rete VPC potrebbe richiedere alcuni secondi. Inoltre, per scoprire di più sulle reti VPC, consulta la panoramica delle reti VPC.

Crea un'istanza AlloyDB

In questa sezione, creerai un'istanza AlloyDB, nonché assegnerai e configurerai la rete VPC per l'istanza.

1. Nella Google Cloud console, vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su Crea cluster.

3. Configura il cluster come segue:

   1. Nel campo ID cluster della sezione Informazioni di base, inserisci my-cluster.

   2. Nel campo Password, inserisci la password che preferisci. Prendi nota di questa password, perché la utilizzerai di nuovo più avanti in questo tutorial.

   3. Nel campo Regione della sezione Località, seleziona us-central1 (Iowa).

   4. Nel campo Versione del database, mantieni il valore predefinito.

   5. Nel menu Rete, seleziona my-vpc-network. Hai creato questa rete VPC in Crea una rete VPC.

   6. Poiché la rete VPC non ha ancora inizializzato l'accesso privato ai servizi, fai clic su Configura connessione.

      Nota: una connessione privata ai servizi consente all'istanza AlloyDB e alla VM di Compute Engine che creerai di comunicare esclusivamente mediante indirizzi IP interni.

   7. Nel riquadro Crea una connessione privata ai servizi che viene visualizzato:

      1. Seleziona l'opzione Utilizza un intervallo IP allocato automaticamente per avere Google Cloud selezionare un intervallo IP allocato automaticamente nella rete.

      2. Fai clic su Continua.

      3. Fai clic su Crea connessione.

      Nota: la creazione della connessione privata ai servizi potrebbe richiedere alcuni secondi. Al termine, il riquadro Crea una connessione privata ai servizi scompare e viene visualizzato il messaggio di stato La connessione privata ai servizi per la rete [VPC-network-name] è stata creata.

4. Configura l'istanza principale come segue:

   1. Nel campo ID istanza, inserisci un ID per l'istanza principale.

   2. In Disponibilità a livello di zona, seleziona una delle seguenti opzioni:

      1. Per creare un'istanza di produzione a elevata disponibilità con failover automatico, seleziona Più zone (alta affidabilità).

      2. Per creare un'istanza di base che non deve essere a elevata disponibilità, seleziona Zona singola.

   3. Seleziona un tipo di macchina.

5. Fai clic su Crea cluster per creare il cluster e l'istanza principale insieme.

   Nota: la creazione dell'istanza AlloyDB potrebbe richiedere alcuni minuti.

6. Prendi nota dell'indirizzo IP privato dell'istanza AlloyDB visualizzato nella pagina Istanze AlloyDB. Avrai bisogno di questo indirizzo per verificare l'integrazione tra l'istanza AlloyDB e l'istanza VM di Compute Engine.

Crea un'istanza VM di Compute Engine

In questa sezione, creerai un'istanza VM di Compute Engine, nonché assegnerai e configurerai la rete VPC per l'istanza.

1. Vai alla pagina Istanze VM nella Google Cloud console.

   Vai alla pagina Istanze VM

2. Fai clic su Crea istanza.

3. Nel campo Nome della pagina Crea un'istanza, inserisci un identificatore univoco per l'istanza VM di Compute Engine che stai creando. Per questo tutorial, inserisci my-compute-engine-vm-instance nel campo.

4. Nella sezione Ambiti di accesso della pagina, seleziona l'opzione Consenti l'accesso completo a tutte le API Cloud.

5. Espandi Opzioni avanzate e completa i seguenti passaggi:

   1. Fai clic sulla scheda secondaria Networking.

   2. Fai clic su Aggiungi un'interfaccia di rete.

   3. Nel menu Rete, seleziona my-vpc-network. Hai creato questa rete VPC in Crea una rete VPC.

   4. Fai clic su Fine. Nella sezione Interfacce di rete della pagina vengono visualizzate due reti VPC: predefinita e my-vpc-network.

6. Fai clic su Elimina per eliminare la rete VPC predefinita.

   Eliminando la rete VPC predefinita, forzi l'istanza VM di Compute Engine a utilizzare la rete VPC che hai creato in questo tutorial.

7. Fai clic su Crea.

   La creazione dell'istanza VM di Compute Engine potrebbe richiedere alcuni secondi. Al termine, l'istanza viene visualizzata nella pagina Istanze VM e il relativo stato è In esecuzione (come indicato dal segno di spunta).

Verifica l'integrazione

In questa sezione, installerai pgbench sull'istanza VM di Compute Engine, lo eseguirai sull'istanza AlloyDB e lo utilizzerai per eseguire test delle prestazioni sull'istanza AlloyDB.

1. Connettiti all'istanza VM di Compute Engine. Per farlo, fai clic sul menu SSH a destra dell'istanza VM, quindi seleziona Apri nella finestra del browser.

2. Installa il pacchetto Contributed Extensions and Additions to PostgreSQL sull'istanza VM di Compute Engine.

   sudo apt-get -y install postgresql-contrib

3. Inizializza un database per pgbench sull'istanza AlloyDB per PostgreSQL. Ad esempio, utilizza il database postgres predefinito:

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

   Sostituisci quanto segue:

   • INSTANCE_PRIVATE_IP: l'indirizzo IP privato dell'istanza AlloyDB. Hai preso nota di questo indirizzo IP quando hai creato l'istanza.
   • PORT_NUMBER: il numero di porta riservato per l'istanza AlloyDB. Per questo tutorial, il numero di porta è 5432.
   • USERNAME: il nome utente amministratore per l'istanza AlloyDB. Per questo tutorial, il nome utente è postgres.

4. Al prompt Password, inserisci la password per l'istanza AlloyDB. Quando hai creato l'istanza, hai fornito una password o hai chiesto ad AlloyDB di generare una password per te.

5. Esegui pgbench senza argomenti per verificare le funzionalità di base.

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

6. Al prompt Password, inserisci la password per l'istanza AlloyDB.

   Dovresti vedere un output simile al seguente:

   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. Utilizza alcune opzioni per eseguire un test utile. Alcune opzioni importanti sono -c (il numero di client) e --transactions (il numero di transazioni per client).

   Per questo tutorial, esegui un test delle prestazioni su 10 client che accedono al database AlloyDB per PostgreSQL e 100 transazioni per ogni client.

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

8. Al prompt Password, inserisci la password per l'istanza AlloyDB.

   Dovresti vedere un output simile al seguente:

   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)

Libera spazio

Al termine di questo tutorial, puoi liberare spazio dalle risorse che hai creato in modo che non utilizzino più la quota e non vengano addebitate in futuro.

Per evitare che al tuo Google Cloud account vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, segui questi passaggi.

1. Utilizza la Google Cloud console per eliminare il progetto, l'istanza AlloyDB, l'istanza VM di Compute Engine e la rete VPC.

Le seguenti sezioni descrivono come eliminare o disattivare queste risorse.

Elimina il progetto

Il modo più semplice per eliminare la fatturazione è eliminare il progetto che hai creato per questo tutorial.

L'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per questo tutorial, quando lo eliminerai, eliminerai anche tutto il lavoro effettuato nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un appspot.com URL, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più tutorial e guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Vai alla pagina Gestisci risorse nella Google Cloud console.

   Vai alla pagina Gestisci risorse

2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.

3. Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.

Elimina l'istanza AlloyDB

1. Vai alla pagina Cluster AlloyDB nella Google Cloud console.

   Vai alla pagina Cluster AlloyDB

2. Fai clic sul nome dell'istanza AlloyDB. Per questo tutorial, fai clic su my-instance.

3. Fai clic su ELIMINA.

4. Nella finestra di dialogo, inserisci il nome dell'istanza AlloyDB nel campo di testo, quindi fai clic su ELIMINA.

Elimina l'istanza VM di Compute Engine

1. Vai alla pagina Istanze VM nella Google Cloud console.

   Vai alla pagina Istanze VM

2. Fai clic sul nome dell'istanza VM di Compute Engine. Per questo tutorial, fai clic su my-compute-engine-vm-instance.

3. Fai clic sull'icona Elimina. Questa icona assomiglia a un cestino.

4. Nella finestra di dialogo, fai clic su ELIMINA.

   Nota: l'eliminazione dell'istanza VM di Compute Engine potrebbe richiedere alcuni secondi.

Elimina la rete VPC

1. Vai alla pagina Reti VPC nella Google Cloud console.

   Vai alla pagina Reti VPC

2. Fai clic sul nome della rete VPC. Per questo tutorial, fai clic su my-vpc-network.

3. Fai clic su ELIMINA RETE VPC.

4. Nella finestra di dialogo, fai clic su ELIMINA.