Utiliser les propriétés utilisateur JMeter avec Azure Load Testing

Dans cet article, découvrez comment configurer et utiliser des propriétés utilisateur Apache JMeter avec Azure Load Testing. Avec les propriétés utilisateur, vous pouvez rendre votre test configurable en conservant les paramètres de test en dehors du script de test JMeter. Les cas d’usage des propriétés utilisateur sont les suivants :

Vous souhaitez utiliser le script de test JMX dans plusieurs environnements de déploiement avec différents points de terminaison d’application.
Votre script de test doit prendre en charge plusieurs modèles de charge, tels que des tests de fumée, des pics de charge ou des tests de trempe.
Vous souhaitez remplacer le comportement JMeter par défaut en configurant les paramètres JMeter, tels que le format du fichier de résultats.

Azure Load Testing prend en charge les propriétés Apache JMeter standard et vous permet de charger un fichier de propriétés utilisateur. Vous pouvez configurer un fichier de propriétés utilisateur par test de charge.

Vous pouvez également utiliser des variables d’environnement et des secrets dans Azure Load Testing pour rendre vos tests configurables.

Remarque

Azure Load Testing remplace les propriétés JMeter spécifiques et ignore les valeurs que vous spécifiez pour ces propriétés. En savoir plus sur la liste des propriétés JMeter remplacées par Azure Load Testing.

Conditions préalables

Un 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. Si vous avez besoin de créer une ressource de test de charge Azure, consultez le guide de démarrage rapide Créer et exécuter un test de charge.

Ajouter un fichier de propriétés utilisateur JMeter à votre test de charge

Vous pouvez définir des propriétés utilisateur pour votre script de test JMeter en chargeant un fichier .properties dans le test de charge. Azure Load Testing prend en charge un seul fichier de propriétés JMeter par test de charge. Les fichiers de propriétés supplémentaires sont ignorés.

L’extrait de code suivant montre un exemple de fichier de propriétés utilisateur qui définit trois propriétés utilisateur et configure le jmeter.save.saveservice.thread_name paramètre de configuration :

# peak-load.properties
# User properties for testing peak load
threadCount=250
rampUpSeconds=30
durationSeconds=600

# Override default JMeter properties
jmeter.save.saveservice.thread_name=false

portail Azure
Azure Pipelines / GitHub Actions

Pour ajouter un fichier de propriétés utilisateur à votre test de charge à l’aide du portail Azure, procédez comme suit :

Dans le Portail Azure, accédez à votre ressource de test de charge Azure.
Dans le volet gauche, sélectionnez Tests pour afficher la liste de tests.
Sélectionnez votre test dans la liste en cochant la case, puis sélectionnez Modifier. Vous pouvez également sélectionner Créer un test pour créer un test de charge.
Sélectionner l’onglet Plan de test.
Sélectionnez le fichier de propriétés à partir de votre ordinateur, puis chargez-le pour charger le fichier dans Azure.
Sélectionnez Propriétés utilisateur dans la liste déroulante Pertinence du fichier .

Vous ne pouvez sélectionner qu’un seul fichier en tant que fichier de propriétés utilisateur pour un test de charge.
Sélectionnez Appliquer pour modifier le test, ou Vérifier + créer, puis Créer pour créer le nouveau test.

Si vous exécutez un test de charge dans votre flux de travail CI/CD, vous ajoutez le fichier de propriétés utilisateur au référentiel de contrôle de code source. Vous spécifiez ensuite ce fichier de propriétés dans le fichier YAML de configuration de test de charge.

Pour plus d’informations sur l’exécution d’un test de charge dans un flux de travail CI/CD, consultez le guide de démarrage rapide des tests de régression automatisé.

Pour ajouter un fichier de propriétés utilisateur à votre test de charge, procédez comme suit :

Ajoutez le fichier .properties au référentiel de contrôle de code source.
Ouvrez votre fichier de configuration de test YAML dans Visual Studio Code ou votre éditeur de votre choix.
Spécifiez le fichier .properties dans le properties.userPropertyFile paramètre.
```
testName: MyTest
testPlan: SampleApp.jmx
description: Configure a load test with peak load properties.
engineInstances: 1
properties:
  userPropertyFile: peak-load.properties
configurationFiles:
  - input-data.csv
```
Remarque

Si vous stockez le fichier de propriétés 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.
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 flux de travail CI/CD s’exécute, il utilisera la configuration mise à jour.

Propriétés de référence dans JMeter

Azure Load Testing prend en charge la fonctionnalité Apache JMeter intégrée pour référencer les propriétés utilisateur de votre script de test JMeter (JMX). Vous pouvez utiliser les fonctions __property ou __P pour récupérer les valeurs de propriété à partir du fichier de propriétés que vous avez chargé précédemment.

L’extrait de code suivant montre un exemple de référence des propriétés dans un fichier JMX :

<ThreadGroup guiclass="ThreadGroupGui" testclass="ThreadGroup" testname="Test home page" enabled="true">
<stringProp name="ThreadGroup.on_sample_error">continue</stringProp>
<elementProp name="ThreadGroup.main_controller" elementType="LoopController" guiclass="LoopControlPanel" testclass="LoopController" testname="Loop Controller" enabled="true">
    <boolProp name="LoopController.continue_forever">false</boolProp>
    <intProp name="LoopController.loops">-1</intProp>
</elementProp>
<stringProp name="ThreadGroup.num_threads">${__P(threadCount,1)}</stringProp>
<stringProp name="ThreadGroup.ramp_time">${__P(rampUpSeconds,1)}</stringProp>
<boolProp name="ThreadGroup.scheduler">true</boolProp>
<stringProp name="ThreadGroup.duration">${__P(durationSeconds,30)}</stringProp>
<stringProp name="ThreadGroup.delay"></stringProp>
<boolProp name="ThreadGroup.same_user_on_next_iteration">true</boolProp>
</ThreadGroup>

Vous pouvez également spécifier des propriétés dans l’interface utilisateur JMeter. L’image suivante montre comment utiliser des propriétés pour configurer un groupe de threads JMeter :

Capture d’écran montrant comment référencer les propriétés utilisateur dans l’interface utilisateur JMeter.

Vous pouvez télécharger les journaux des erreurs JMeter pour résoudre les erreurs pendant le test de charge.

Étapes suivantes

En savoir plus sur les propriétés JMeter remplacées par Azure Load Testing.
En savoir plus sur le paramétrage d’un test de charge à l’aide de variables d’environnement et de secrets.
En savoir plus sur le diagnostic des tests de charge défaillants.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-08-07