Lägga till begäranden i URL-baserade belastningstester i Azure Load Testing

I den här artikeln får du lära dig hur du lägger till HTTP-begäranden i ett URL-baserat belastningstest i Azure Load Testing. Använd ett URL-baserat belastningstest för att verifiera HTTP-slutpunkter, till exempel webbprogram eller REST-slutpunkter, utan förkunskaper om verktyg för belastningstestning och skript.

Azure har stöd för två sätt att definiera HTTP-begäranden i ett URL-baserat belastningstest. Du kan kombinera båda metoderna i ett belastningstest.

• Ange information om HTTP-slutpunkten, till exempel slutpunkts-URL, HTTP-metod, rubriker, frågeparametrar eller begärandetexten.
• Ange ett cURL-kommando för HTTP-begäran.

Om du har beroende begäranden kan du extrahera svarsvärden från en begäran och skicka dem som indata till en efterföljande begäran. Du kan till exempel först hämta kundinformationen och extrahera kund-ID:t för att hämta kundorderinformationen.

Om du använder ett URL-baserat belastningstest i ditt CI/CD-arbetsflöde kan du skicka en JSON-fil som innehåller HTTP-begäranden till ditt belastningstest.

Du kan lägga till upp till fem begäranden i ett URL-baserat belastningstest. För mer komplexa belastningstester kan du skapa ett belastningstest genom att ladda upp ett JMeter-testskript. Om du till exempel har fler än fem begäranden, om du använder icke-HTTP-protokoll eller om du behöver använda JMeter-plugin-program.

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.
• En Azure-belastningstestningsresurs. Information om hur du skapar en belastningstestresurs finns i Skapa och köra ett belastningstest.

Lägga till begäranden med HTTP-information

Du kan ange en HTTP-begäran för ett URL-baserat belastningstest genom att ange HTTP-begärandeinformationen. I följande tabell visas de fält som du kan konfigurera för en HTTP-begäran i Azure Load Testing:

Fält	Details
webbadress	URL:en för HTTP-slutpunkten. Exempel: https://www.contoso.com/products
Metod	HTTP-metoden. Azure Load Testing stöder GET, POST, PUT, DELETE, PATCH, HEAD och OPTIONS.
Frågeparametrar	(Valfritt) Ange frågesträngsparametrar som ska läggas till i URL:en.
HTTP-rubriker	(Valfritt) Ange HTTP-huvuden som ska inkluderas i HTTP-begäran. Du kan lägga till upp till 20 huvuden för en begäran.
Begärandetext	(Valfritt) Beroende på HTTP-metoden kan du ange HTTP-brödtextinnehållet. Azure Load Testing stöder följande format: rådata, JSON-vy, JavaScript, HTML och XML.

Följ de här stegen för att lägga till en HTTP-begäran i ett URL-baserat belastningstest:

Azure-portalen

1. Gå till din belastningstestningsresurs i Azure-portalen.

2. I det vänstra navigeringsfältet väljer du Tester för att visa alla tester.

3. I listan väljer du ditt belastningstest och väljer sedan Redigera.

   Se till att välja ett URL-baserat belastningstest i listan och att du har aktiverat Aktivera avancerade inställningar på fliken Grundläggande.

4. Gå till fliken Testplan och välj Lägg till begäran.

   

5. Välj Lägg till indata i användargränssnittet för att ange INFORMATION om HTTP-begäran.

6. Ange information om HTTP-begäran och välj sedan Lägg till för att lägga till begäran i belastningstestet.

   Fält	beskrivning
   Begärandeformat	Välj Lägg till indata i användargränssnittet för att konfigurera information om begäran via fält i Azure-portalen.
   Request name (Begärans namn)	Ange ett unikt namn för begäran. Du kan referera till det här begärandenamnet när du definierar villkor för testfel.
   URL	URL:en för programslutpunkten.
   Metod	Välj en HTTP-metod i listan. Azure Load Testing stöder GET, POST, PUT, DELETE, PATCH, HEAD och OPTIONS.
   Frågeparametrar	(Valfritt) Ange frågesträngsparametrar som ska läggas till i URL:en.
   Rubriker	(Valfritt) Ange HTTP-huvuden som ska inkluderas i HTTP-begäran.
   Brödtext	(Valfritt) Beroende på HTTP-metoden kan du också ange HTTP-brödtextinnehållet. Azure Load Testing stöder följande format: rådata, JSON-vy, JavaScript, HTML och XML.

   

7. Välj Använd för att spara belastningstestet.

Azure Pipelines/GitHub Actions

När du kör belastningstestet som en del av ett CI/CD-arbetsflöde, till exempel GitHub Actions eller Azure Pipelines, anger du listan över HTTP-begäranden i en JSON-fil för begäranden. I YAML-filen för belastningstestkonfiguration refererar du till JSON-filen i egenskapen testPlan .

1. Skapa en requests.json fil för att lagra HTTP-begäranden och klistra in följande kodfragment i filen:

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

   Du kan också konfigurera inläsningsinställningarna i egenskapen testSetup . Läs mer om hur du konfigurerar inläsningsparametrar för URL-baserade belastningstester.

2. Lägg till HTTP-begärandeinformationen i egenskapen requests :

   Följande kodfragment visar ett exempel på en HTTP POST-begäran. Observera att requestType är 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. Uppdatera YAML-filen för belastningstestkonfigurationen testType och ange inställningarna och testPlan :

   Se till att ange egenskapen så URL att den testType anger att du kör ett URL-baserat belastningstest.

   Egenskapen testPlan refererar till JSON-filen för begäranden som du skapade i föregående steg.

   Följande kodfragment visar ett fragment av en exempelkonfigurationsfil för belastningstest:

   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. Spara båda filerna och checka in dem på källkontrolllagringsplatsen.

Lägga till begäranden med cURL

I stället för att ange INFORMATION om HTTP-begäran kan du även ange cURL-kommandon för HTTP-begäranden i ditt URL-baserade belastningstest. cURL är ett kommandoradsverktyg och bibliotek för URL-baserade begäranden.

Följ de här stegen för att lägga till en HTTP-begäran i ett belastningstest med hjälp av ett cURL-kommando.

Azure-portalen

1. I listan över tester väljer du ditt belastningstest och väljer sedan Redigera.

   Se till att välja ett URL-baserat belastningstest i listan och att du har aktiverat Aktivera avancerade inställningar på fliken Grundläggande.

2. Gå till fliken Testplan och välj Lägg till begäran.

3. Välj Lägg till cURL-kommando för att skapa en HTTP-begäran med hjälp av cURL.

4. Ange cURL-kommandot i kommandofältet cURL och välj sedan Lägg till för att lägga till begäran i belastningstestet.

   I följande exempel används cURL för att utföra en HTTP GET-begäran och ange ett HTTP-huvud:

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

   

5. Välj Använd för att spara belastningstestet.

Azure Pipelines/GitHub Actions

När du kör belastningstestet som en del av ett CI/CD-arbetsflöde, till exempel GitHub Actions eller Azure Pipelines, anger du listan över HTTP-begäranden i en JSON-fil för begäranden. I YAML-filen för belastningstestkonfiguration refererar du till JSON-filen i egenskapen testPlan .

1. Skapa en JSON-fil för att lagra HTTP-begäranden och klistra in följande kodfragment i filen:

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

   Du kan också konfigurera inläsningsinställningarna i egenskapen testSetup . Läs mer om hur du konfigurerar inläsningsparametrar för URL-baserade belastningstester.

2. Lägg till ett cURL-kommando i egenskapen requests :

   Följande kodfragment visar ett exempel på en HTTP POST-begäran. Observera att requestType är CURL.

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

3. testType Ange inställningarna och testPlan i YAML-filen för belastningstestkonfiguration för att referera till JSON-filen för begäranden:

   Se till att ange egenskapen så URL att den testType anger att du kör ett URL-baserat belastningstest.

   Egenskapen testPlan refererar till JSON-filen för begäranden som du skapade i föregående steg.

   Följande kodfragment visar ett fragment av en exempelkonfigurationsfil för belastningstest:

   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. Spara båda filerna och checka in dem på källkontrolllagringsplatsen.

Använda variabler i HTTP-begäranden

Du kan använda variabler i DIN HTTP-begäran för att göra dina tester mer flexibla eller för att undvika att inkludera hemligheter i testplanen. Du kan till exempel använda en miljövariabel med domännamnet för slutpunkten och sedan använda variabelnamnet i de enskilda HTTP-begärandena. Användningen av variabler gör testplanen mer flexibel och underhållsbar.

Med URL-baserade belastningstester i Azure Load Testing kan du använda variabler för att referera till följande information:

• Miljövariabler: du kan konfigurera miljövariabler för belastningstestet
• Hemligheter: Konfigurera Azure Key Vault-hemligheter i belastningstestet
• Värden från en CSV-indatafil: Använd variabler för kolumnerna i en CSV-indatafil och kör en begäran för varje rad i filen
• Svarsvariabler: extrahera värden från en tidigare HTTP-begäran

Syntaxen för att referera till en variabel i en begäran är: ${variable-name}.

Följande skärmbild visar hur du refererar till en token variabel i en HTTP-rubrik med hjälp ${token}av .

Kommentar

Om du anger certifikat skickar Azure Load Testing automatiskt certifikaten i varje HTTP-begäran.

Använda svarsvariabler för beroende begäranden

Om du vill skapa HTTP-begäranden som används för en tidigare begäran kan du använda svarsvariabler. I den första begäran kan du till exempel hämta en lista med objekt från ett API, extrahera ID:t från det första resultatet och sedan göra ett efterföljande och skicka detta ID som en frågesträngsparameter.

Azure Load Testing stöder följande alternativ för att extrahera värden från en HTTP-begäran och lagra dem i en variabel:

• JSONPath
• Xpath
• Regular expression

I följande exempel visas till exempel hur du använder en XPathExtractor för att lagra brödtexten för en begäran i svarsvariabeln token . Du kan sedan använda ${token} i andra HTTP-begäranden för att referera till det här värdet.

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

Relaterat innehåll

• Konfigurera ett belastningstest med miljövariabler och hemligheter
• Läsa data från en CSV-indatafil
• Yaml-referens för belastningstestkonfiguration