Aanvragen toevoegen aan op URL gebaseerde belastingstests in Azure Load Testing

In dit artikel leert u hoe u HTTP-aanvragen toevoegt aan een op URL gebaseerde belastingstest in Azure Load Testing. Gebruik een op URL gebaseerde belastingstest om HTTP-eindpunten, zoals webtoepassingen of REST-eindpunten, te valideren zonder voorafgaande kennis van hulpprogramma's voor belastingtests en scripting.

ondersteuning voor Azure twee manieren om HTTP-aanvragen te definiëren in een op URL gebaseerde belastingstest. U kunt beide methoden in een belastingstest combineren.

• Geef de details van het HTTP-eindpunt op, zoals de eindpunt-URL, de HTTP-methode, headers, queryparameters of de aanvraagbody.
• Voer een cURL-opdracht in voor de HTTP-aanvraag.

Als u afhankelijke aanvragen hebt, kunt u antwoordwaarden uit één aanvraag extraheren en deze doorgeven als invoer voor een volgende aanvraag. U kunt bijvoorbeeld eerst de klantgegevens ophalen en de klant-id extraheren om de klantordergegevens op te halen.

Als u een op URL gebaseerde belastingstest gebruikt in uw CI/CD-werkstroom, kunt u een JSON-bestand doorgeven dat de HTTP-aanvragen bevat voor uw belastingstest.

U kunt maximaal vijf aanvragen toevoegen aan een op URL gebaseerde belastingstest. Voor complexere belastingstests kunt u een belastingstest maken door een JMeter-testscript te uploaden. Als u bijvoorbeeld meer dan vijf aanvragen hebt, als u niet-HTTP-protocollen gebruikt of als u JMeter-invoegtoepassingen moet gebruiken.

Vereisten

• Een Azure-account met een actief abonnement. Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
• Een Azure Load Testing-resource. Zie Een belastingstest maken en uitvoeren om een resource voor belastingstests te maken.

Aanvragen toevoegen met HTTP-details

U kunt een HTTP-aanvraag voor een op URL gebaseerde belastingstest opgeven door de details van de HTTP-aanvraag op te geven. De volgende tabel bevat de velden die u kunt configureren voor een HTTP-aanvraag in Azure Load Testing:

Veld	Details
URL	De URL van het HTTP-eindpunt. Bijvoorbeeld https://www.contoso.com/products.
Methode	De HTTP-methode. Azure Load Testing ondersteunt GET, POST, PUT, DELETE, PATCH, HEAD en OPTIONS.
Queryparameters	(Optioneel) Voer queryreeksparameters in die u wilt toevoegen aan de URL.
HTTP-kopteksten	(Optioneel) Voer HTTP-headers in die u wilt opnemen in de HTTP-aanvraag. U kunt maximaal 20 headers toevoegen voor een aanvraag.
Aanvraagtekst	(Optioneel) Afhankelijk van de HTTP-methode kunt u de INHOUD van de HTTP-hoofdtekst opgeven. Azure Load Testing ondersteunt de volgende indelingen: onbewerkte gegevens, JSON-weergave, JavaScript, HTML en XML.

Volg deze stappen om een HTTP-aanvraag toe te voegen aan een op URL gebaseerde belastingstest:

Azure-portal

1. Ga in Azure Portal naar uw resource voor belastingstests.

2. Selecteer in het linkernavigatievenster Tests om alle tests weer te geven.

3. Selecteer uw belastingstest in de lijst en selecteer vervolgens Bewerken.

   Zorg ervoor dat u een op URL gebaseerde belastingstest selecteert in de lijst en dat u geavanceerde instellingen inschakelt op het tabblad Basisbeginselen.

4. Ga naar het tabblad Plan testen en selecteer Aanvraag toevoegen.

   

5. Selecteer Invoer toevoegen in de gebruikersinterface om de details van de HTTP-aanvraag in te voeren.

6. Voer de details van de HTTP-aanvraag in en selecteer Vervolgens Toevoegen om de aanvraag toe te voegen aan uw belastingstest.

   Veld	Beschrijving
   Aanvraagindeling	Selecteer Invoer toevoegen in de gebruikersinterface om de aanvraagdetails te configureren via velden in Azure Portal.
   Naam van aanvraag	Voer een unieke naam in voor de aanvraag. U kunt deze aanvraagnaam raadplegen wanneer u test mislukte criteria definieert.
   URL	De URL van het toepassingseindpunt.
   Methode	Selecteer een HTTP-methode in de lijst. Azure Load Testing ondersteunt GET, POST, PUT, DELETE, PATCH, HEAD en OPTIONS.
   Queryparameters	(Optioneel) Voer queryreeksparameters in die u wilt toevoegen aan de URL.
   Kopteksten	(Optioneel) Voer HTTP-headers in die u wilt opnemen in de HTTP-aanvraag.
   Tekst	(Optioneel) Afhankelijk van de HTTP-methode kunt u ook de INHOUD van de HTTP-hoofdtekst opgeven. Azure Load Testing ondersteunt de volgende indelingen: onbewerkte gegevens, JSON-weergave, JavaScript, HTML en XML.

   

7. Selecteer Toepassen om de belastingtest op te slaan.

Azure Pipelines/GitHub Actions

Wanneer u uw belastingstest uitvoert als onderdeel van een CI/CD-werkstroom, zoals GitHub Actions of Azure Pipelines, geeft u de lijst met HTTP-aanvragen op in een JSON-bestand met aanvragen. In het YAML-bestand voor de belastingtestconfiguratie verwijst u naar het JSON-bestand in de testPlan eigenschap.

1. Maak een requests.json bestand om de HTTP-aanvragen op te slaan en plak het volgende codefragment in het bestand:

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

   Configureer eventueel de laadinstellingen in de testSetup eigenschap. Meer informatie over het configureren van belastingparameters voor op URL's gebaseerde belastingstests.

2. Voeg de details van de HTTP-aanvraag toe in de requests eigenschap:

   In het volgende codefragment ziet u een voorbeeld van een HTTP POST-aanvraag. Zoals u ziet, is URLhet requestType .

   {
       "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. Werk het YAML-bestand voor de belastingtestconfiguratie bij en stel de testType instellingen in testPlan :

   Zorg ervoor dat u de testType eigenschap instelt om URL aan te geven dat u een op URL gebaseerde belastingstest uitvoert.

   De testPlan eigenschap verwijst naar het JSON-bestand aanvragen dat u in de vorige stap hebt gemaakt.

   In het volgende codefragment ziet u een fragment van een voorbeeld van een configuratiebestand voor belastingstests:

   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. Sla beide bestanden op en voer ze door naar uw opslagplaats voor broncodebeheer.

Aanvragen toevoegen met cURL

In plaats van de HTTP-aanvraaggegevens op te geven, kunt u ook cURL-opdrachten opgeven voor de HTTP-aanvragen in uw op URL gebaseerde belastingstest. cURL is een opdrachtregelprogramma en -bibliotheek voor aanvragen op basis van URL's.

Volg deze stappen om een HTTP-aanvraag toe te voegen aan een belastingstest met behulp van een cURL-opdracht.

Azure-portal

1. Selecteer uw belastingtest in de lijst met tests en selecteer vervolgens Bewerken.

   Zorg ervoor dat u een op URL gebaseerde belastingstest selecteert in de lijst en dat u geavanceerde instellingen inschakelt op het tabblad Basisbeginselen.

2. Ga naar het tabblad Plan testen en selecteer Aanvraag toevoegen.

3. Selecteer CURL-opdracht toevoegen om een HTTP-aanvraag te maken met behulp van cURL.

4. Voer de cURL-opdracht in het cURL-opdrachtveld in en selecteer vervolgens Toevoegen om de aanvraag toe te voegen aan uw belastingstest.

   In het volgende voorbeeld wordt cURL gebruikt om een HTTP GET-aanvraag uit te voeren, waarbij een HTTP-header wordt opgegeven:

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

   

5. Selecteer Toepassen om de belastingtest op te slaan.

Azure Pipelines/GitHub Actions

Wanneer u uw belastingstest uitvoert als onderdeel van een CI/CD-werkstroom, zoals GitHub Actions of Azure Pipelines, geeft u de lijst met HTTP-aanvragen op in een JSON-bestand met aanvragen. In het YAML-bestand voor de belastingtestconfiguratie verwijst u naar het JSON-bestand in de testPlan eigenschap.

1. Maak een JSON-bestand om de HTTP-aanvragen op te slaan en plak het volgende codefragment in het bestand:

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

   Configureer eventueel de laadinstellingen in de testSetup eigenschap. Meer informatie over het configureren van belastingparameters voor op URL's gebaseerde belastingstests.

2. Voeg een cURL-opdracht toe in de requests eigenschap:

   In het volgende codefragment ziet u een voorbeeld van een HTTP POST-aanvraag. Zoals u ziet, is CURLhet requestType .

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

3. Stel de testType en testPlan instellingen in het YAML-bestand voor de belastingtestconfiguratie in om te verwijzen naar het JSON-bestand met aanvragen:

   Zorg ervoor dat u de testType eigenschap instelt om URL aan te geven dat u een op URL gebaseerde belastingstest uitvoert.

   De testPlan eigenschap verwijst naar het JSON-bestand aanvragen dat u in de vorige stap hebt gemaakt.

   In het volgende codefragment ziet u een fragment van een voorbeeld van een configuratiebestand voor belastingstests:

   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. Sla beide bestanden op en voer ze door naar uw opslagplaats voor broncodebeheer.

Variabelen gebruiken in HTTP-aanvragen

U kunt variabelen in uw HTTP-aanvraag gebruiken om uw tests flexibeler te maken of om geheimen in uw testplan te voorkomen. U kunt bijvoorbeeld een omgevingsvariabele gebruiken met de domeinnaam van uw eindpunt en vervolgens variabelenaam gebruiken in de afzonderlijke HTTP-aanvragen. Het gebruik van variabelen maakt uw testplan flexibeler en onderhoudbaarer.

Met op URL's gebaseerde belastingstests in Azure Load Testing kunt u variabelen gebruiken om te verwijzen naar de volgende informatie:

• Omgevingsvariabelen: u kunt omgevingsvariabelen configureren voor de belastingtest
• Geheimen: Azure Key Vault-geheimen configureren in uw belastingstest
• Waarden uit een CSV-invoerbestand: variabelen gebruiken voor de kolommen in een CSV-invoerbestand en een aanvraag uitvoeren voor elke rij in het bestand
• Antwoordvariabelen: waarden extraheren uit een vorige HTTP-aanvraag

De syntaxis voor het verwijzen naar een variabele in een aanvraag is: ${variable-name}.

In de volgende schermopname ziet u hoe u naar een token variabele in een HTTP-header verwijst met behulp van ${token}.

Notitie

Als u certificaten opgeeft, geeft Azure Load Testing automatisch de certificaten in elke HTTP-aanvraag door.

Antwoordvariabelen gebruiken voor afhankelijke aanvragen

Als u HTTP-aanvragen wilt maken die afhankelijk zijn van een vorige aanvraag, kunt u antwoordvariabelen gebruiken. In de eerste aanvraag kunt u bijvoorbeeld een lijst met items ophalen uit een API, de id uit het eerste resultaat extraheren en vervolgens een volgende maken en deze id doorgeven als een querytekenreeksparameter.

Azure Load Testing ondersteunt de volgende opties om waarden uit een HTTP-aanvraag te extraheren en op te slaan in een variabele:

• JSONPath
• Xpath
• Regular expression

In het volgende voorbeeld ziet u bijvoorbeeld hoe u een XPathExtractor gebruikt om de hoofdtekst van een aanvraag op te slaan in de token antwoordvariabele. U kunt vervolgens ${token} in andere HTTP-aanvragen naar deze waarde verwijzen.

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

Gerelateerde inhoud

• Een belastingstest configureren met omgevingsvariabelen en geheimen
• Gegevens lezen uit een CSV-invoerbestand
• YAML-referentie voor belastingtestconfiguratie