Hinzufügen von Anforderungen zu URL-basierten Auslastungstests in Azure Load Testing

In diesem Artikel erfahren Sie, wie Sie HTTP-Anforderungen zu einem URL-basierten Auslastungstest in Azure Load Testing hinzufügen. Verwenden Sie einen URL-basierten Auslastungstest, um HTTP-Endpunkte, z. B. Webanwendungen oder REST-Endpunkte, zu validieren, ohne vorherige Kenntnisse über Auslastungstest und Skripts.

Azure unterstützt zwei Möglichkeiten zum Definieren von HTTP-Anforderungen in einem URL-basierten Auslastungstest. Sie können beide Methoden innerhalb eines Auslastungstests kombinieren.

• Geben Sie die HTTP-Endpunktdetails an, z. B. die Endpunkt-URL, die HTTP-Methode, den Header, die Abfrageparameter oder den Anforderungstext.
• Geben Sie einen cURL-Befehl für die HTTP-Anforderung ein.

Wenn Sie abhängige Anforderungen haben, können Sie Antwortwerte aus einer Anforderung extrahieren und als Eingabe an eine nachfolgende Anforderung übergeben. Sie können beispielsweise zuerst die Kundendetails abrufen und die Kunden-ID extrahieren, um die Kundenauftragsdetails abzurufen.

Wenn Sie einen URL-basierten Auslastungstest in Ihrem CI/CD-Workflow verwenden, können Sie eine JSON-Datei übergeben, die die HTTP-Anforderungen an Ihren Auslastungstest enthält.

Sie können bis zu fünf Anforderungen zu einem URL-basierten Auslastungstest hinzufügen. Für komplexere Auslastungstests können Sie einen Auslastungstest erstellen, indem Sie ein Apache JMeter-Testskript hochladen. Wenn Sie beispielsweise mehr als fünf Anforderungen haben, wenn Sie Nicht-HTTP-Protokolle verwenden oder wenn Sie JMeter-Plug-Ins verwenden müssen.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie kein Azure-Abonnement besitzen, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.
• Eine Azure Load Testing-Ressource. Informationen zum Erstellen einer Azure Load Testing-Ressource finden Sie unter Erstellen und Ausführen eines Auslastungstests.

Hinzufügen von Anforderungen mit HTTP-Details

Sie können eine HTTP-Anforderung für einen URL-basierten Auslastungstest angeben, indem Sie die HTTP-Anforderungsdetails angeben. In der folgenden Tabelle sind die Felder aufgeführt, die Sie für eine HTTP-Anforderung in Azure Load Testing konfigurieren können:

Feld	Details
URL	Die URL des HTTP-Endpunkts. Beispiel: https://www.contoso.com/products.
Methode	Die HTTP-Methode. Azure Load Testing unterstützt GET, POST, PUT, DELETE, PATCH, HEAD und OPTIONS.
Abfrageparameter	(Optional) Geben Sie Abfragezeichenfolgenparameter ein, die an die URL angefügt werden sollen.
HTTP-Header	(Optional) Geben Sie HTTP-Header ein, die in die HTTP-Anforderung eingeschlossen werden sollen. Sie können bis zu 20 Header für eine Anforderung hinzufügen.
Anforderungstext	(Optional) Abhängig von der HTTP-Methode können Sie den HTTP-Textkörperinhalt angeben. Azure Load Testing unterstützt die folgenden Formate: Rohdaten, JSON-Ansicht, JavaScript, HTML und XML.

Führen Sie die folgenden Schritte aus, um einem URL-basierten Auslastungstest eine HTTP-Anforderung hinzuzufügen:

Azure portal

1. Wechseln Sie im Azure-Portal zu Ihrer Azure Load Testing-Ressource.

2. Wählen Sie im linken Navigationsbereich Tests aus, um alle Tests anzuzeigen.

3. Wählen Sie in der Liste Ihren Auslastungstest und dann Bearbeiten aus.

   Stellen Sie sicher, dass Sie einen URL-basierten Auslastungstest aus der Liste auswählen und dass Erweiterte Einstellungen aktivieren auf der Registerkarte Grundlagen aktiviert ist.

4. Wechseln Sie zur Registerkarte Testplan, und wählen Sie Anforderung hinzufügen aus.

   

5. Wählen Sie Eingabe in der Benutzeroberfläche hinzufügen aus, um die HTTP-Anforderungsdetails einzugeben.

6. Geben Sie die HTTP-Anforderungsdetails ein, und wählen Sie dann Hinzufügen aus, um die Anforderung zum Auslastungstest hinzuzufügen.

   Feld	Beschreibung
   Anforderungsformat	Wählen Sie Eingabe in der Benutzeroberfläche hinzufügen aus, um die Anforderungsdetails über Felder im Azure-Portal zu konfigurieren.
   Request name (Anforderungsname)	Geben Sie einen eindeutigen Namen für die Anforderung ein. Sie können auf diesen Anforderungsnamen verweisen, wenn Sie Test-Fehlschlagkriterien definieren.
   URL	Die URL des Anwendungsendpunkts.
   Methode	Wählen Sie eine HTTP-Methode aus der Liste aus. Azure Load Testing unterstützt GET, POST, PUT, DELETE, PATCH, HEAD und OPTIONS.
   Abfrageparameter	(Optional) Geben Sie Abfragezeichenfolgenparameter ein, die an die URL angefügt werden sollen.
   Headers	(Optional) Geben Sie HTTP-Header ein, die in die HTTP-Anforderung eingeschlossen werden sollen.
   Text	(Optional) Abhängig von der HTTP-Methode können Sie auch den HTTP-Textkörperinhalt angeben. Azure Load Testing unterstützt die folgenden Formate: Rohdaten, JSON-Ansicht, JavaScript, HTML und XML.

   

7. Klicken Sie auf Anwenden, um den Auslastungstest zu speichern.

Azure Pipelines/GitHub Actions

Wenn Sie Ihren Auslastungstest als Teil eines CI/CD-Workflows ausführen, z. B. GitHub Actions oder Azure Pipelines, stellen Sie die Liste der HTTP-Anforderungen in einer JSON-Anforderungsdatei bereit. In der Auslastungstestkonfigurations-YAML-Datei verweisen Sie auf die JSON-Datei in der Eigenschaft „testPlan“.

1. Erstellen Sie eine requests.json-Datei, um die HTTP-Anforderungen zu speichern, und fügen Sie den folgenden Codeausschnitt in die Datei ein:

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

   Konfigurieren Sie optional die Auslastungseinstellungen in der Eigenschaft „testSetup“. Erfahren Sie mehr über das Konfigurieren von Auslastungsparametern für URL-basierte Auslastungstests.

2. Fügen Sie die HTTP-Anforderungsdetails in der Eigenschaft „requests“ hinzu:

   Der folgende Codeausschnitt zeigt ein Beispiel für eine HTTP POST-Anforderung. Beachten Sie, dass requestType URL ist.

   {
       "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. Aktualisieren Sie die YAML-Datei für die Auslastungstestkonfiguration, und legen Sie die Einstellungen „testType“ und „testPlan“ fest:

   Stellen Sie sicher, dass die testType-Eigenschaft auf URL festgelegt ist, um anzugeben, dass Sie einen URL-basierten Auslastungstest ausführen.

   Die testPlan-Eigenschaft verweist auf die Anforderungs-JSON-Datei, die Sie im vorherigen Schritt erstellt haben.

   Der folgende Codeausschnitt zeigt ein Fragment einer Beispieldatei für die Auslastungstestkonfiguration:

   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. Speichern Sie beide Dateien, und committen Sie sie in Ihr Quellcodeverwaltungs-Repository.

Hinzufügen von Anforderungen mithilfe von cURL

Anstatt die HTTP-Anforderungsdetails bereitzustellen, können Sie auch cURL-Befehle für die HTTP-Anforderungen in Ihrem URL-basierten Auslastungstest bereitstellen. cURL ist ein Befehlszeilentool und eine Bibliothek für URL-basierte Anforderungen.

Führen Sie die folgenden Schritte aus, um einem Auslastungstest eine HTTP-Anforderung mit einem cURL-Befehl hinzuzufügen.

Azure portal

1. Wählen Sie in der Testliste Ihren Auslastungstest und dann Bearbeiten aus.

   Stellen Sie sicher, dass Sie einen URL-basierten Auslastungstest aus der Liste auswählen und dass Erweiterte Einstellungen aktivieren auf der Registerkarte Grundlagen aktiviert ist.

2. Wechseln Sie zur Registerkarte Testplan, und wählen Sie Anforderung hinzufügen aus.

3. Wählen Sie cURL-Befehl hinzufügen aus, um eine HTTP-Anforderung mithilfe von cURL zu erstellen.

4. Geben Sie den cURL-Befehl im Feld cURL-Befehl ein, und wählen Sie dann Hinzufügen aus, um die Anforderung zum Auslastungstest hinzuzufügen.

   Im folgenden Beispiel wird cURL verwendet, um eine HTTP GET-Anforderung auszuführen und einen HTTP-Header anzugeben:

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

   

5. Klicken Sie auf Anwenden, um den Auslastungstest zu speichern.

Azure Pipelines/GitHub Actions

Wenn Sie Ihren Auslastungstest als Teil eines CI/CD-Workflows ausführen, z. B. GitHub Actions oder Azure Pipelines, stellen Sie die Liste der HTTP-Anforderungen in einer JSON-Anforderungsdatei bereit. In der Auslastungstestkonfigurations-YAML-Datei verweisen Sie auf die JSON-Datei in der Eigenschaft „testPlan“.

1. Erstellen Sie eine JSON-Datei, um die HTTP-Anforderungen zu speichern, und fügen Sie den folgenden Codeausschnitt in die Datei ein:

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

   Konfigurieren Sie optional die Auslastungseinstellungen in der Eigenschaft „testSetup“. Erfahren Sie mehr über das Konfigurieren von Auslastungsparametern für URL-basierte Auslastungstests.

2. Fügen Sie in der Eigenschaft „requests“ einen cURL-Befehl hinzu:

   Der folgende Codeausschnitt zeigt ein Beispiel für eine HTTP POST-Anforderung. Beachten Sie, dass requestType CURL ist.

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

3. Legen Sie die Einstellungen „testType“ und „testPlan“ in der YAML-Datei für die Auslastungstestkonfiguration so fest, dass sie auf die JSON-Anforderungsdatei verweisen:

   Stellen Sie sicher, dass die testType-Eigenschaft auf URL festgelegt ist, um anzugeben, dass Sie einen URL-basierten Auslastungstest ausführen.

   Die testPlan-Eigenschaft verweist auf die Anforderungs-JSON-Datei, die Sie im vorherigen Schritt erstellt haben.

   Der folgende Codeausschnitt zeigt ein Fragment einer Beispieldatei für die Auslastungstestkonfiguration:

   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. Speichern Sie beide Dateien, und committen Sie sie in Ihr Quellcodeverwaltungs-Repository.

Verwenden von Variablen in HTTP-Anforderungen

Sie können Variablen in Ihrer HTTP-Anforderung verwenden, um Ihre Tests flexibler zu gestalten oder Geheimnisse in Ihren Testplan zu vermeiden. Sie können beispielsweise eine Umgebungsvariable mit dem Domänennamen Ihres Endpunkts verwenden und dann den Variablennamen in den einzelnen HTTP-Anforderungen verwenden. Die Verwendung von Variablen macht Ihren Testplan flexibler und einfacher zu warten.

Mit URL-basierten Auslastungstests in Azure Load Testing können Sie Variablen verwenden, um auf die folgenden Informationen zu verweisen:

• Umgebungsvariablen: Sie können für den Auslastungstest Umgebungsvariablen konfigurieren.
• Geheimnisse: Konfigurieren Sie Azure Key Vault-Geheimnisse in Ihrem Auslastungstest.
• Werte aus einer CSV-Eingabedatei: Verwenden Sie Variablen für die Spalten in einer CSV-Eingabedatei, und führen Sie eine Anforderung für jede Zeile in der Datei aus.
• Antwortvariablen: Extrahieren Sie Werte aus einer vorherigen HTTP-Anforderung.

Die Syntax für den Verweis auf eine Variable in einer Anforderung lautet: ${variable-name}.

Der folgende Screenshot zeigt, wie Sie mithilfe von ${token} auf eine token-Variable in einem HTTP-Header verweisen.

Hinweis

Wenn Sie Zertifikate angeben, übergibt Azure Load Testing die Zertifikate automatisch in jeder HTTP-Anforderung.

Verwenden von Antwortvariablen für abhängige Anforderungen

Um HTTP-Anforderungen zu erstellen, die von einer vorherigen Anforderung abhängen, können Sie Antwortvariablen verwenden. In der ersten Anforderung können Sie beispielsweise eine Liste von Elementen aus einer API abrufen, die ID aus dem ersten Ergebnis extrahieren und dann eine nachfolgende ID erstellen und diese ID als Abfragezeichenfolgenparameter übergeben.

Azure Load Testing unterstützt die folgenden Optionen, um Werte aus einer HTTP-Anforderung zu extrahieren und in einer Variablen zu speichern:

• JSONPath
• XPath
• Regulärer Ausdruck

Im folgenden Beispiel wird gezeigt, wie sie mit einem XPathExtractor den Text einer Anforderung in der token-Antwortvariable speichern. Anschließend können Sie ${token} in anderen HTTP-Anforderungen verwenden, um auf diesen Wert zu verweisen.

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

Zugehöriger Inhalt

• Konfigurieren eines Auslastungstests mit Umgebungsvariablen und Geheimnissen
• Lesen von Daten aus einer CSV-Eingabedatei
• Auslastungstestkonfiguration-YAML-Verweis