Ajouter des requêtes aux tests de charge basés sur l’URL dans Azure Load Testing

Dans cet article, vous allez apprendre à ajouter des requêtes HTTP à un test de charge basé sur l’URL dans Azure Load Testing. Utilisez un test de charge basé sur l’URL pour valider les points de terminaison HTTP, tels que les applications web ou les points de terminaison REST, sans connaître préalablement les outils de test de charge et les scripts.

support Azure deux façons de définir des requêtes HTTP dans un test de charge basé sur l’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 demandes dépendantes, vous pouvez extraire des valeurs de réponse d’une requête et les transmettre en tant qu’entrée à une requête ultérieure. Par exemple, vous pouvez d’abord récupérer les détails du client et extraire l’ID client pour récupérer les détails de la commande client.

Si vous utilisez un test de charge basé sur l’URL dans votre flux de travail CI/CD, vous pouvez transmettre un fichier JSON qui contient les requêtes HTTP à votre test de charge.

Vous pouvez ajouter jusqu’à cinq requêtes à un test de charge basé sur l’URL. Pour les tests de charge plus complexes, vous pouvez créer un test de charge en charge en 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 plug-ins 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.

Ajouter des requêtes avec des détails HTTP

Vous pouvez spécifier une requête HTTP pour un test de charge basé sur l’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 Azure Load Testing :

Champ	Détails
URL	URL du point de terminaison HTTP. Par exemple : https://www.contoso.com/products.
Méthode	Méthode HTTP. Azure Load Testing 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 demande.
Corps de la demande	(Facultatif) Selon la méthode HTTP, vous pouvez spécifier le contenu du corps HTTP. Azure Load Testing prend en charge les formats suivants : données brutes, vue JSON, JavaScript, HTML et XML.

Procédez comme suit pour ajouter une requête HTTP à un test de charge basé sur l’URL :

Azure portal

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

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

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

   Veillez à sélectionner un test de charge basé sur l’URL dans la liste et que vous avez activé Activer les paramètres avancés sous l’onglet Informations de base.

4. Accédez à l’onglet Plan de test, puis sélectionnez Ajouter une demande.

   

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

6. Entrez 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’interface utilisateur pour configurer les détails de la demande via les champs de l’Portail Azure.
   Nom de la requête	Entrez un nom unique pour la requête. Vous pouvez faire référence à ce nom de demande lorsque vous définissez des critères d’échec de test.
   URL	URL du point de terminaison de l’application.
   Méthode	Sélectionnez une méthode HTTP dans la liste. Azure Load Testing 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. Azure Load Testing 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 flux de travail 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 testPlan propriété.

1. Créez un requests.json fichier 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
           }
       ]
   }
   

   Si vous le souhaitez, configurez les paramètres de chargement dans la testSetup propriété. En savoir plus sur la configuration des paramètres de charge pour les tests de charge basés sur l’URL.

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

   L’extrait de code suivant montre un exemple de requête HTTP POST. Notez que l’objet 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 de test de charge et définissez les paramètres et testPlan les testType paramètres suivants :

   Veillez à définir la testType propriété pour URL indiquer que vous exécutez un test de charge basé sur l’URL.

   La testPlan propriété 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 fichiers et validez-les dans votre référentiel de contrôle de code source.

Ajouter des requêtes à l’aide de 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 en ligne de commande et une bibliothèque pour les requêtes basées sur l’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.

   Veillez à sélectionner un test de charge basé sur l’URL dans la liste et que vous avez activé Activer les paramètres avancés sous l’onglet Informations de base.

2. Accédez à l’onglet Plan de test, puis sélectionnez Ajouter une demande.

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

4. Entrez la commande cURL dans le champ de commande cURL, puis sélectionnez Ajouter pour ajouter la demande à 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 flux de travail 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 testPlan propriété.

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
           }
       ]
   }
   

   Si vous le souhaitez, configurez les paramètres de chargement dans la testSetup propriété. En savoir plus sur la configuration des paramètres de charge pour les tests de charge basés sur l’URL.

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

   L’extrait de code suivant montre un exemple de requête HTTP POST. Notez que l’objet 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 et testPlan les testType paramètres dans le fichier YAML de configuration de test de charge pour référencer le fichier JSON des demandes :

   Veillez à définir la testType propriété pour URL indiquer que vous exécutez un test de charge basé sur l’URL.

   La testPlan propriété 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 fichiers et validez-les dans votre référentiel de contrôle de code source.

Utiliser 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 variable dans les requêtes HTTP individuelles. L’utilisation de variables rend votre plan de test plus flexible et plus facile à gérer.

Avec les tests de charge basés sur l’URL dans Azure Load Testing, 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 : configurer 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 demande pour chaque ligne du fichier.
• Variables de réponse : extraire des valeurs d’une requête HTTP précédente

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

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

Remarque

Si vous spécifiez des certificats, Azure Load Testing transmet automatiquement les certificats dans chaque requête HTTP.

Utiliser des variables de réponse pour les demandes dépendantes

Pour créer des requêtes HTTP qui depent sur 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 opération suivante et passer cet ID en tant que paramètre de chaîne de requête.

Azure Load Testing 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 token variable de réponse. Vous pouvez ensuite 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

• Configurer un test de charge avec des variables d’environnement et des secrets
• Lire des données à partir d’un fichier CSV d’entrée
• Référence YAML de configuration de test de charge