Ajoutez des requêtes aux tests de charge basés sur des URL dans Test de charge Azure

Dans cet article, vous découvrez comment ajouter des requêtes HTTP à un test de charge basé sur une URL dans Test de charge Azure. Utilisez un test de charge basé sur une URL pour valider les points de terminaison HTTP, tels que les applications Web ou les points de terminaison REST, sans connaissance préalable des outils de test de charge et des scripts.

Azure prend en charge deux manières de définir des requêtes HTTP dans un test de charge basé sur une URL. Vous pouvez combiner les deux méthodes dans un test de charge.

• Spécifiez les détails du point de terminaison HTTP, tels que l'URL du point de terminaison, la méthode HTTP, les en-têtes, les paramètres de requête ou le corps de la requête.
• Entrez une commande cURL pour la requête HTTP.

Si vous avez des requêtes dépendantes, vous pouvez extraire les valeurs de réponse d'une requête et les transmettre en entrée à une requête ultérieure. Par exemple, vous pouvez d’abord récupérer les détails du client, puis extraire l’ID client pour récupérer les détails de la commande client.

Si vous utilisez un test de charge basé sur une URL dans votre workflow CI/CD, vous pouvez transmettre un fichier JSON contenant les requêtes HTTP à votre test de charge.

Vous pouvez ajouter jusqu'à cinq requêtes à un test de charge basé sur une URL. Pour des tests de charge plus complexes, vous pouvez créer un test de charge en téléchargeant un script de test JMeter. Par exemple, lorsque vous avez plus de cinq requêtes, si vous utilisez des protocoles non HTTP ou si vous devez utiliser des plugins JMeter.

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.

Ajoutez des requêtes avec des détails HTTP

Vous pouvez spécifier une requête HTTP pour un test de charge basé sur une URL en fournissant les détails de la requête HTTP. Le tableau suivant répertorie les champs que vous pouvez configurer pour une requête HTTP dans Test de charge Azure :

Champ	Détails
URL	L'URL du point de terminaison HTTP. Par exemple : https://www.contoso.com/products.
Method	Méthode HTTP. Test de charge Azure prend en charge GET, POST, PUT, DELETE, PATCH, HEAD et OPTIONS.
Paramètres de requête	(Facultatif) Entrez les paramètres de chaîne de requête à ajouter à l’URL.
En-têtes HTTP	(Facultatif) Entrez les en-têtes HTTP à inclure dans la requête HTTP. Vous pouvez ajouter jusqu'à 20 en-têtes pour une requête.
Corps de la demande	(Facultatif) Selon la méthode HTTP, vous pouvez spécifier le contenu du corps HTTP. Test de charge Azure prend en charge les formats suivants : données brutes, vue JSON, JavaScript, HTML et XML.

Suivez ces étapes pour ajouter une requête HTTP à un test de charge basé sur une URL :

Azure portal

1. Dans le portail Azure, accédez à votre ressource de Test de charge.

2. Dans le volet de navigation de gauche, sélectionnez Tests pour voir tous les tests.

3. Dans la liste, sélectionnez votre test de charge, puis sélectionnez Modifier.

   Assurez-vous de sélectionner un test de charge basé sur une URL dans la liste et d’avoir activé l’option Activer les paramètres avancés dans l’onglet Fonctions de base.

4. Accédez à l’onglet Plan de test et sélectionnez Ajouter une requête.

   

5. Sélectionnez Ajouter une entrée dans l’interface utilisateur pour saisir les détails de la requête HTTP.

6. Saisissez les détails de la requête HTTP, puis sélectionnez Ajouter pour ajouter la requête à votre test de charge.

   Champ	Description
   Format de la demande	Sélectionnez Ajouter une entrée dans l’IU pour configurer les détails de la requête via les champs du portail Azure.
   Nom de la requête	Entrez un nom unique pour la requête. Vous pouvez faire référence à ce nom de requête lorsque vous définissez les critères d'échec du test.
   URL	URL du point de terminaison d’application.
   Méthode	Sélectionnez une méthode HTTP dans la liste. Test de charge Azure prend en charge GET, POST, PUT, DELETE, PATCH, HEAD et OPTIONS.
   Paramètres de requête	(Facultatif) Entrez les paramètres de chaîne de requête à ajouter à l’URL.
   En-têtes	(Facultatif) Entrez les en-têtes HTTP à inclure dans la requête HTTP.
   Corps	(Facultatif) Selon la méthode HTTP, vous pouvez également spécifier le contenu du corps HTTP. Test de charge Azure prend en charge les formats suivants : données brutes, vue JSON, JavaScript, HTML et XML.

   

7. Sélectionnez Appliquer pour enregistrer le test de charge.

Azure Pipelines / GitHub Actions

Lorsque vous exécutez votre test de charge dans le cadre d’un workflow CI/CD, tel que GitHub Actions ou Azure Pipelines, vous fournissez la liste des requêtes HTTP dans un fichier JSON de requêtes. Dans le fichier YAML de configuration du test de charge, vous référencez le fichier JSON dans la propriété testPlan.

1. Créez un fichier requests.json pour stocker les requêtes HTTP et collez l'extrait de code suivant dans le fichier :

   {
       "version": "1.0",
       "scenarios": {
           "requestGroup1": {
               "requests": [
               ],
               "csvDataSetConfigList": []
           }
       },
       "testSetup": [
           {
               "virtualUsersPerEngine": 50,
               "durationInSeconds": 300,
               "loadType": "Linear",
               "scenario": "requestGroup1",
               "rampUpTimeInSeconds": 60
           }
       ]
   }
   

   Vous pouvez également configurer les paramètres de chargement dans la propriété testSetup. En savoir plus sur la configuration des paramètres de charge pour les tests de charge basés sur les URL.

2. Ajoutez les détails de la requête HTTP dans la propriété requests :

   L'extrait de code suivant montre un exemple de requête HTTP POST. Notez que le requestType est URL.

   {
       "requestName": "add",
       "responseVariables": [],
       "queryParameters": [
           {
               "key": "param1",
               "value": "value1"
           }
       ],
       "requestType": "URL",
       "endpoint": "http://www.contoso.com/orders",
       "headers": {
           "api-token": "my-token"
       },
       "body": "{\r\n  \"customer\": \"Contoso\",\r\n  \"items\": {\r\n\t  \"product_id\": 321,\r\n\t  \"count\": 50,\r\n\t  \"amount\": 245.95\r\n  }\r\n}",
       "method": "POST",
       "requestBodyFormat": "JSON"
   },
   

3. Mettez à jour le fichier YAML de configuration du test de charge et définissez les paramètres testType et testPlan :

   Assurez-vous de définir la propriété testType vers URL pour indiquer que vous exécutez un test de charge basé sur une URL.

   La propriété testPlan fait référence au fichier JSON de requêtes que vous avez créé à l’étape précédente.

   L'extrait de code suivant montre un fragment d'un exemple de fichier de configuration de test de charge :

   displayName: my-first-load-test
   testPlan: requests.json
   description: Web application front-end
   engineInstances: 1
   testId: my-first-load-test
   testType: URL
   splitAllCSVs: False
   failureCriteria: []
   autoStop:
     errorPercentage: 90
     timeWindow: 60
   

4. Enregistrez les deux fichiers et validez-les dans votre référentiel de contrôle de source.

Ajoutez des requêtes en utilisant cURL

Au lieu de fournir les détails de la requête HTTP, vous pouvez également fournir des commandes cURL pour les requêtes HTTP dans votre test de charge basé sur l'URL. cURL est un outil de ligne de commande et une bibliothèque pour les requêtes basées sur les URL.

Suivez ces étapes pour ajouter une requête HTTP à un test de charge à l’aide d’une commande cURL.

Azure portal

1. Dans la liste des tests, sélectionnez votre test de charge, puis sélectionnez Modifier.

   Assurez-vous de sélectionner un test de charge basé sur une URL dans la liste et d’avoir activé l’option Activer les paramètres avancés dans l’onglet Fonctions de base.

2. Accédez à l’onglet Plan de test et sélectionnez Ajouter une requête.

3. Sélectionnez la commande Ajouter cURL pour créer une requête HTTP à l’aide de cURL.

4. Saisissez la commande cURL dans le champ de commande cURL, puis sélectionnez Ajouter pour ajouter la requête à votre test de charge.

   L'exemple suivant utilise cURL pour effectuer une requête HTTP GET, en spécifiant un en-tête HTTP :

   curl --request GET 'http://www.contoso.com/customers?version=1' --header 'api-token: my-token'
   

   

5. Sélectionnez Appliquer pour enregistrer le test de charge.

Azure Pipelines / GitHub Actions

Lorsque vous exécutez votre test de charge dans le cadre d’un workflow CI/CD, tel que GitHub Actions ou Azure Pipelines, vous fournissez la liste des requêtes HTTP dans un fichier JSON de requêtes. Dans le fichier YAML de configuration du test de charge, vous référencez le fichier JSON dans la propriété testPlan.

1. Créez un fichier JSON pour stocker les requêtes HTTP et collez l'extrait de code suivant dans le fichier :

   {
       "version": "1.0",
       "scenarios": {
           "requestGroup1": {
               "requests": [
               ],
               "csvDataSetConfigList": []
           }
       },
       "testSetup": [
           {
               "virtualUsersPerEngine": 50,
               "durationInSeconds": 300,
               "loadType": "Linear",
               "scenario": "requestGroup1",
               "rampUpTimeInSeconds": 60
           }
       ]
   }
   

   Vous pouvez également configurer les paramètres de chargement dans la propriété testSetup. En savoir plus sur la configuration des paramètres de charge pour les tests de charge basés sur les URL.

2. Ajoutez une commande cURL dans la propriété requests :

   L'extrait de code suivant montre un exemple de requête HTTP POST. Notez que le requestType est CURL.

   {
       "requestName": "get-customers",
       "responseVariables": [],
       "requestType": "CURL",
       "curlCommand": "curl --request GET 'http://www.contoso.com/customers?version=1' --header 'api-token: my-token'"
   },
   

3. Définissez les paramètres testType et testPlan dans le fichier YAML de configuration du test de charge pour référencer le fichier JSON des requêtes :

   Assurez-vous de définir la propriété testType vers URL pour indiquer que vous exécutez un test de charge basé sur une URL.

   La propriété testPlan fait référence au fichier JSON de requêtes que vous avez créé à l’étape précédente.

   L'extrait de code suivant montre un fragment d'un exemple de fichier de configuration de test de charge :

   displayName: my-first-load-test
   testPlan: requests.json
   description: Web application front-end
   engineInstances: 1
   testId: my-first-load-test
   testType: URL
   splitAllCSVs: False
   failureCriteria: []
   autoStop:
     errorPercentage: 90
     timeWindow: 60
   

4. Enregistrez les deux fichiers et validez-les dans votre référentiel de contrôle de source.

Utilisez des variables dans les requêtes HTTP

Vous pouvez utiliser des variables dans votre requête HTTP pour rendre vos tests plus flexibles ou pour éviter d'inclure des secrets dans votre plan de test. Par exemple, vous pouvez utiliser une variable d’environnement avec le nom de domaine de votre point de terminaison, puis utiliser le nom de la variable dans les requêtes HTTP individuelles. L'utilisation de variables rend votre plan de test plus flexible et plus maintenable.

Avec les tests de charge basés sur des URL dans Test de charge Azure, vous pouvez utiliser des variables pour faire référence aux informations suivantes :

• Variables d'environnement : vous pouvez configurer des variables d'environnement pour le test de charge
• Secrets : configurez les secrets Azure Key Vault dans votre test de charge
• Valeurs d'un fichier d'entrée CSV : utilisez des variables pour les colonnes d'un fichier d'entrée CSV et exécutez une requête pour chaque ligne du fichier
• Variables de réponse : extraire les valeurs d'une requête HTTP précédente

La syntaxe pour faire référence à une variable dans une requête est : ${variable-name}.

La capture d'écran suivante montre comment faire référence à une variable token dans un en-tête HTTP en utilisant ${token}.

Remarque

Si vous spécifiez des certificats, Test de charge Azure transmet automatiquement les certificats dans chaque requête HTTP.

Utilisez des variables de réponse pour les requêtes dépendantes

Pour créer des requêtes HTTP qui dépendent d'une requête précédente, vous pouvez utiliser des variables de réponse. Par exemple, dans la première requête, vous pouvez récupérer une liste d'éléments à partir d'une API, extraire l'ID du premier résultat, puis effectuer une requête ultérieure et transmettre cet ID en tant que paramètre de chaîne de requête.

Test de charge Azure prend en charge les options suivantes pour extraire des valeurs d’une requête HTTP et les stocker dans une variable :

• JSONPath
• XPath
• Expression régulière

Par exemple, l’exemple suivant montre comment utiliser un XPathExtractor pour stocker le corps d’une requête dans la variable de réponse token. Vous pouvez ensuite l'utiliser ${token} dans d'autres requêtes HTTP pour faire référence à cette valeur.

"responseVariables": [
    {
        "extractorType": "XPathExtractor",
        "expression": "/note/body",
        "variableName": "token"
    }
]

Contenu connexe

• Configurez un test de charge avec des variables d'environnement et des secrets
• Lisez les données d'un fichier CSV d'entrée
• Référence YAML sur la configuration des tests de charge