Personnaliser un test de charge avec des plugins Apache JMeter et des tests de charge Azure

Dans cet article, vous allez apprendre à utiliser un plug-in Apache JMeter dans votre script de test de charge avec Test de charge Azure. Vous pouvez étendre les fonctionnalités principales d’Apache JMeter à l’aide de plug-ins. Par exemple, pour ajouter des fonctionnalités pour effectuer des manipulations de données, implémenter des échantillonneurs de requête personnalisés, etc.

Lorsque vous utilisez un plug-in JMeter dans votre script de test, le plug-in doit être chargé sur les instances du moteur de test dans Test de charge Azure. Vous avez deux options pour utiliser des plug-ins JMeter avec Test de charge Azure :

• Plug-ins de https://jmeter-plugins.org. Test de charge Azure préinstalle automatiquement les plug-ins à partir de https://jmeter-plugins.org.

• Autres plug-ins. Lorsque vous créez le test de charge, vous devez ajouter le fichier d’archive Java (JAR) du plug-in JMeter à votre configuration de test de charge. Test de charge Azure charge le fichier JAR du plug-in sur les instances du moteur de test au démarrage du test de charge.

Remarque

Si vous utilisez votre propre code de plug-in, nous vous recommandons de générer le fichier JAR exécutable à l’aide de Java 17.

Prérequis

• Compte Azure avec un abonnement actif. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
• Une ressource de test de charge Azure. Pour créer une ressource de test de charge, consultez Créer et exécuter un test de charge.
• (Facultatif) Interface utilisateur graphique (GUI) Apache JMeter pour créer votre script de test. Pour installer Apache JMeter, consultez Bien démarrer avec Apache JMeter.

Référencer le plug-in JMeter dans votre script de test

Pour utiliser un plug-in JMeter dans votre test de charge, vous devez créer le script de test JMX et référencer le plug-in. Il n’existe aucune instruction spéciale pour référencer des plug-ins dans votre script lorsque vous utilisez Test de charge Azure.

Suivez ces étapes pour utiliser l’interface graphique utilisateur JMeter pour installer et référencer le plug-in dans votre script de test :

1. Installez le plug-in JMeter sur votre instance JMeter locale de l’une des deux manières suivantes :

   • Utilisez le Gestionnaire de plug-ins si le plug-in est disponible.

   • Pour utiliser votre propre code de plug-in, copiez le fichier JAR du plug-in dans le dossier lib/ext de votre installation JMeter locale.

   Après avoir installé le plug-in, la fonctionnalité du plug-in apparaît dans l’interface utilisateur Apache JMeter.

2. Vous pouvez maintenant référencer la fonctionnalité du plug-in dans votre script de test.

   La capture d’écran suivante montre un exemple d’utilisation d’un plug-in Example Sampler. Selon le type de plug-in, vous pouvez avoir différentes options dans l’interface utilisateur.

   

Remarque

Vous pouvez également référencer directement le plug-in JMeter en modifiant le fichier JMX. Dans ce cas, vous n’avez pas besoin d’installer le plug-in localement.

Créer un test de charge qui utilise des plug-ins JMeter

Si vous référencez uniquement des plug-ins à partir de https://jmeter-plugins.org, vous pouvez créer un test de charge en chargeant votre script de test JMX. Test de charge Azure préinstalle les fichiers JAR du plug-in sur les instances du moteur de test.

Si vous utilisez vos propres plug-ins dans votre script de test, vous devez ajouter le fichier JAR du plug-in à votre configuration de test de charge. Test de charge Azure installe ensuite votre plug-in sur les moteurs de test de charge au démarrage du test.

Vous pouvez ajouter un fichier JAR de plug-in lorsque vous créez un test de charge ou à tout moment lorsque vous mettez à jour un test existant.

Azure portal

Procédez comme suit pour charger un fichier JAR à l’aide du portail Azure :

1. Dans le Portail Azure, accédez à votre ressource de test de charge Azure.

2. Dans le volet gauche, sélectionnez Tests pour afficher un liste de tests.

3. Sélectionnez Créer > Charger un script JMeter pour créer un test de charge à l’aide d’un script JMeter.

   

4. Sinon, si vous avez un test de charge existant, sélectionnez le test dans la liste en cochant la case, puis sélectionnez Modifier.

   

5. Sélectionner l’onglet Plan de test.

6. Sélectionnez le fichier JAR à partir de votre ordinateur, puis sélectionnez Charger pour charger le fichier dans Azure.

   

7. Sélectionnez Appliquer pour modifier le test, ou sélectionnez Vérifier + créer pour créer le test.

   Lorsque le test s’exécute, Test de charge Azure déploie le plug-in sur chaque instance du moteur de test.

GitHub Actions/Azure Pipelines

Lorsque vous exécutez un test de charge dans votre workflow CI/CD, vous référencez le fichier JAR du plug-in dans le paramètre configurationFiles du fichier YAML de configuration de test.

Pour référencer le fichier JAR du plug-in dans le fichier YAML de configuration de test :

1. Ajoutez le fichier JAR du plug-in au référentiel de contrôle de code source, qui contient votre configuration de test de charge.

2. Ouvrez le fichier de configuration de test YAML dans Visual Studio Code ou dans l’éditeur de votre choix.

3. Ajoutez le fichier JAR au paramètre configurationFiles. Vous pouvez utiliser des caractères génériques ou spécifier plusieurs fichiers individuels.

   testName: MyTest
   testPlan: SampleApp.jmx
   description: Run a load test for my sample web app
   engineInstances: 1
   configurationFiles:
   - examplesampler-1.0.jar
   

   Remarque

   Si vous stockez le fichier JAR dans un dossier distinct, spécifiez le fichier avec un nom de chemin relatif. Pour plus d’informations, consultez Syntaxe YAML de configuration de test.

4. Enregistrez le fichier de configuration YAML et validez-le dans votre dépôt de contrôle de code source.

   La prochaine fois que le workflow CI/CD s’exécute, il utilisera la configuration mise à jour et Test de charge Azure déploiera le plug-in sur chaque instance du moteur de test.