Analyser les performances d'une instance AlloyDB avec pgbench

Dans ce tutoriel, vous allez intégrer une instance AlloyDB et une instance de VM Compute Engine sur un réseau cloud privé virtuel (VPC). Vous vérifiez ensuite l'intégration en installant pgbench sur l'instance de VM Compute Engine, puis utilisez cet outil de benchmarking pour effectuer des tests de performances sur l'instance AlloyDB.

Remarque :Vous pouvez utiliser pgbench pour exécuter des tests de performances de base avec AlloyDB. Pour effectuer des analyses comparatives du traitement transactionnel en ligne (OLTP), consultez les outils et la méthodologie décrits dans le Guide d'analyse comparative des transactions (OLTP) AlloyDB.

Objectifs

Dans ce tutoriel, vous allez apprendre à effectuer les opérations suivantes :

• Créez un réseau VPC pour votre instance AlloyDB et votre instance de VM Compute Engine afin que la communication puisse s'effectuer de manière sécurisée entre l'instance et la VM.
• Créez une instance AlloyDB et une instance de VM Compute Engine, puis attribuez et configurez votre réseau VPC pour les deux instances.
• Installez pgbench sur l'instance de VM Compute Engine, exécutez-le sur l'instance AlloyDB et utilisez-le pour effectuer des tests de performances sur l'instance AlloyDB.

Coûts

Ce tutoriel utilise des composants facturables de Google Cloud, y compris le réseau VPC, AlloyDB et Compute Engine. Obtenez une estimation des coûts en fonction de votre utilisation prévue à l'aide du simulateur de coût.

Avant de commencer

1. Dans la console Google Cloud , sur la page du sélecteur de projet, sélectionnez ou créez un projet Google Cloud .

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder à la page de sélection du projet

2. Assurez-vous que la facturation est activée pour votre projet Google Cloud . Découvrez comment vérifier que la facturation est activée pour votre projet.

3. Activez le réseau VPC, les API AlloyDB et Compute Engine.

   Activer les API

4. Assurez-vous que le rôle "Administrateur AlloyDB" est attribué à votre compte utilisateur.

   Accéder à la page IAM

Créer un réseau VPC

Dans cette section, vous allez créer un réseau VPC pour votre instance AlloyDB et votre instance de VM Compute Engine afin que la communication puisse s'effectuer de manière sécurisée entre l'instance et la VM.

1. Accédez à la page Réseaux VPC dans la console Google Cloud .

   Accéder à la page Réseaux VPC

2. Cliquez sur Créer un réseau VPC. La page Créer un réseau VPC s'affiche.

3. Saisissez my-vpc-network pour le nom de votre réseau VPC.

4. Dans la section Mode de création du sous-réseau, sélectionnez l'option Personnalisé.

5. Cliquez sur AJOUTER UN SOUS-RÉSEAU.

6. Saisissez my-subnet pour le nom de votre sous-réseau.

7. Sélectionnez une région, puis saisissez une plage d'adresses IP pour votre sous-réseau.

8. Cliquez sur OK.

9. Cliquez sur CRÉER.

Remarque :La création de votre réseau VPC peut prendre quelques secondes. Pour en savoir plus sur les réseaux VPC, consultez la section Présentation des réseaux VPC.

Créer une instance AlloyDB

Dans cette section, vous allez créer une instance AlloyDB, puis attribuer et configurer votre réseau VPC pour l'instance.

1. Dans la console Google Cloud, accédez à la page Clusters.

   accéder aux clusters

2. Cliquez sur Créer un cluster.

3. Configurez votre cluster comme suit:

   1. Dans le champ ID du cluster de la section Informations de base, saisissez my-cluster.

   2. Dans le champ Password (Mot de passe), saisissez le mot de passe de votre choix. Notez ce mot de passe, car vous l'utiliserez plus tard dans ce tutoriel.

   3. Dans le champ Région de la section Emplacement, sélectionnez us-central1 (Iowa).

   4. Dans le champ Database version (Version de la base de données), conservez la valeur par défaut.

   5. Dans le menu Réseau, sélectionnez my-vpc-network. Vous avez créé ce réseau VPC dans Créer un réseau VPC.

   6. Étant donné que votre réseau VPC n'a pas encore initialisé l'accès aux services privés, cliquez sur Configurer la connexion.

      Remarque :Une connexion de service privée permet à votre instance AlloyDB et à la VM Compute Engine que vous allez créer de communiquer exclusivement à l'aide d'adresses IP internes.

   7. Dans le volet Créer une connexion de service privée qui s'affiche:

      1. Sélectionnez l'option Utiliser une plage d'adresses IP allouée automatiquement pour que Google Cloud sélectionne une plage d'adresses IP allouée automatiquement dans votre réseau.

      2. Cliquez sur Continuer.

      3. Cliquez sur Créer une connexion.

      Remarque :La création de votre connexion de service privé peut prendre quelques secondes. Le volet Créer une connexion de service privée disparaît, et le message d'état La connexion de service privée pour le réseau [VPC-network-name] a bien été créée s'affiche.

4. Configurez votre instance principale comme suit:

   1. Dans le champ ID d'instance, saisissez un ID pour votre instance principale.

   2. Sous Disponibilité zonale, sélectionnez l'une des options suivantes:

      1. Pour créer une instance de production disponibilité élevée avec basculement automatique, sélectionnez Plusieurs zones (haute disponibilité).

      2. Pour créer une instance de base qui n'a pas besoin d'être hautement disponible, sélectionnez Zone unique.

   3. Sélectionnez un type de machine.

5. Cliquez sur Créer un cluster pour créer le cluster et l'instance principale.

   Remarque :La création de votre instance AlloyDB peut prendre quelques minutes.

6. Notez l'adresse IP privée de votre instance AlloyDB qui s'affiche sur la page Instances AlloyDB. Vous aurez besoin de cette adresse pour valider l'intégration entre l'instance AlloyDB et l'instance de VM Compute Engine.

Créer une instance de VM Compute Engine

Dans cette section, vous allez créer une instance de VM Compute Engine, puis attribuer et configurer votre réseau VPC pour l'instance.

1. Accédez à la page Instances de VM de la console Google Cloud .

   Accéder à la page "Instances de VM"

2. Cliquez sur Créer une instance.

3. Dans le champ Nom de la page Créer une instance, saisissez un identifiant unique pour l'instance de VM Compute Engine que vous créez. Pour ce tutoriel, saisissez my-compute-engine-vm-instance dans le champ.

4. Dans la section Champs d'application de l'accès de la page, sélectionnez l'option Autoriser l'accès complet à l'ensemble des API Cloud.

5. Développez Options avancées, puis procédez comme suit:

   1. Cliquez sur le sous-onglet Mise en réseau.

   2. Cliquez sur Ajouter une interface réseau.

   3. Dans le menu Réseau, sélectionnez my-vpc-network. Vous avez créé ce réseau VPC dans Créer un réseau VPC.

   4. Cliquez sur OK. Deux réseaux VPC s'affichent dans la section Interfaces réseau de la page: default et my-vpc-network.

6. Cliquez sur  Supprimer pour supprimer le réseau VPC par défaut.

   En supprimant le réseau VPC par défaut, vous forcez votre instance de VM Compute Engine à utiliser le réseau VPC que vous avez créé dans ce tutoriel.

7. Cliquez sur Créer.

   La création de votre instance de VM Compute Engine peut prendre quelques secondes. L'instance apparaît alors sur la page Instances de VM, et son état est En cours d'exécution (comme indiqué par la coche).

Vérifier l'intégration

Dans cette section, vous allez installer pgbench sur l'instance de VM Compute Engine, l'exécuter sur l'instance AlloyDB et l'utiliser pour effectuer des tests de performances sur l'instance AlloyDB.

1. Connectez-vous à votre instance de VM Compute Engine. Pour ce faire, cliquez sur le menu SSH à droite de votre instance de VM, puis sélectionnez Ouvrir dans la fenêtre du navigateur.

2. Installez le package "Contributions and Additions to PostgreSQL" (Extensions et ajouts à PostgreSQL) sur votre instance de VM Compute Engine.

   sudo apt-get -y install postgresql-contrib

3. Initialisez une base de données pour pgbench sur votre instance AlloyDB pour PostgreSQL. Par exemple, utilisez la base de données postgres par défaut:

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

   Remplacez les éléments suivants :

   • INSTANCE_PRIVATE_IP: adresse IP privée de votre instance AlloyDB. Vous avez noté cette adresse IP lorsque vous avez créé l'instance.
   • PORT_NUMBER: numéro de port réservé à votre instance AlloyDB. Pour ce tutoriel, le numéro de port est 5432.
   • USERNAME: nom d'utilisateur de l'administrateur de votre instance AlloyDB. Pour ce tutoriel, le nom d'utilisateur est postgres.

4. À l'invite Password, saisissez le mot de passe de votre instance AlloyDB. Lorsque vous avez créé l'instance, vous avez fourni un mot de passe ou AlloyDB en a généré un pour vous.

5. Exécutez pgbench sans argument pour vérifier les fonctionnalités de base.

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

6. À l'invite Password, saisissez le mot de passe de votre instance AlloyDB.

   La sortie obtenue doit ressembler à ceci :

   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. Utilisez certaines options pour créer un test utile. Voici quelques options importantes : -c (nombre de clients) et --transactions (nombre de transactions par client).

   Pour ce tutoriel, effectuez un test de performances sur les clients 10 qui accèdent à votre base de données AlloyDB pour PostgreSQL et aux transactions 100 pour chaque client.

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

8. À l'invite Password, saisissez le mot de passe de votre instance AlloyDB.

   La sortie obtenue doit ressembler à ceci :

   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)

Effectuer un nettoyage

Une fois que vous avez terminé ce tutoriel, vous pouvez nettoyer les ressources que vous avez créées afin qu'elles ne soient plus comptabilisées dans le quota et qu'elles ne vous soient plus facturées.

Pour éviter que les ressources utilisées dans ce tutoriel ne soient facturées sur votre compte Google Cloud , suivez les étapes ci-dessous.

1. Utilisez la console Google Cloud pour supprimer votre projet, votre instance AlloyDB, votre instance de VM Compute Engine et votre réseau VPC.

Dans les sections suivantes, nous allons voir comment supprimer ou désactiver ces ressources.

Supprimer votre projet

Le moyen le plus simple d'empêcher la facturation est de supprimer le projet que vous avez créé pour ce tutoriel.

La suppression d'un projet aura les effets suivants :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour ce tutoriel et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs tutoriels et guides de démarrage rapide, vous pouvez constater que réutiliser des projets peut vous aider à éviter de dépasser les limites de quotas des projets.

1. Accédez à la page Gérer les ressources de la console Google Cloud .

   Accéder à la page "Gérer les ressources"

2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.

3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Supprimer l'instance AlloyDB

1. Accédez à la page Instances AlloyDB dans la console Google Cloud .

   Accéder à la page "Instances AlloyDB"

2. Cliquez sur le nom de votre instance AlloyDB. Pour ce tutoriel, cliquez sur my-instance.

3. Cliquez sur SUPPRIMER.

4. Dans la boîte de dialogue, saisissez le nom de votre instance AlloyDB dans le champ de texte, puis cliquez sur DELETE (SUPPRIMER).

Supprimer l'instance de VM Compute Engine

1. Accédez à la page Instances de VM de la console Google Cloud .

   Accéder à la page "Instances de VM"

2. Cliquez sur le nom de votre instance de VM Compute Engine. Pour ce tutoriel, cliquez sur my-compute-engine-vm-instance.

3. Cliquez sur l'icône Supprimer. Cette icône ressemble à une poubelle.

4. Dans la boîte de dialogue, cliquez sur SUPPRIMER.

   Remarque :La suppression de votre instance de VM Compute Engine peut prendre quelques secondes.

Supprimer le réseau VPC

1. Accédez à la page Réseaux VPC dans la console Google Cloud .

   Accéder à la page Réseaux VPC

2. Cliquez sur le nom de votre réseau VPC. Pour ce tutoriel, cliquez sur my-vpc-network.

3. Cliquez sur SUPPRIMER LE RÉSEAU VPC.

4. Dans la boîte de dialogue, cliquez sur SUPPRIMER.