Dodawanie żądań do testów obciążeniowych opartych na adresach URL w usłudze Azure Load Testing

Z tego artykułu dowiesz się, jak dodać żądania HTTP do testu obciążeniowego opartego na adresach URL w usłudze Azure Load Testing. Użyj testu obciążeniowego opartego na adresach URL, aby zweryfikować punkty końcowe HTTP, takie jak aplikacje internetowe lub punkty końcowe REST, bez wcześniejszej wiedzy na temat narzędzi do testowania obciążenia i skryptów.

pomoc techniczna platformy Azure dwa sposoby definiowania żądań HTTP w teście obciążeniowym opartym na adresach URL. Obie metody można połączyć w ramach testu obciążeniowego.

• Określ szczegóły punktu końcowego HTTP, takie jak adres URL punktu końcowego, metoda HTTP, nagłówki, parametry zapytania lub treść żądania.
• Wprowadź polecenie cURL dla żądania HTTP.

Jeśli masz zależne żądania, możesz wyodrębnić wartości odpowiedzi z jednego żądania i przekazać je jako dane wejściowe do kolejnego żądania. Na przykład możesz najpierw pobrać szczegóły klienta i wyodrębnić identyfikator klienta, aby pobrać szczegóły zamówienia klienta.

Jeśli używasz testu obciążeniowego opartego na adresie URL w przepływie pracy ciągłej integracji/ciągłego wdrażania, możesz przekazać plik JSON zawierający żądania HTTP do testu obciążeniowego.

Do testu obciążeniowego opartego na adresach URL można dodać maksymalnie pięć żądań. W przypadku bardziej złożonych testów obciążeniowych można utworzyć test obciążeniowy, przekazując skrypt testowy JMeter. Jeśli na przykład masz więcej niż pięć żądań, jeśli używasz protokołów innych niż HTTP lub jeśli musisz użyć wtyczek JMeter.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
• Zasób testowania obciążenia platformy Azure. Aby utworzyć zasób testowania obciążenia, zobacz Tworzenie i uruchamianie testu obciążeniowego.

Dodawanie żądań ze szczegółami protokołu HTTP

Możesz określić żądanie HTTP dla testu obciążeniowego opartego na adresie URL, podając szczegóły żądania HTTP. W poniższej tabeli wymieniono pola, które można skonfigurować dla żądania HTTP w usłudze Azure Load Testing:

Pole	Szczegóły
URL	Adres URL punktu końcowego HTTP. Na przykład https://www.contoso.com/products.
Metoda	Metoda HTTP. Testowanie obciążenia platformy Azure obsługuje polecenia GET, POST, PUT, DELETE, PATCH, HEAD i OPTIONS.
Parametry zapytań	(Opcjonalnie) Wprowadź parametry ciągu zapytania, aby dołączyć go do adresu URL.
Nagłówki HTTP	(Opcjonalnie) Wprowadź nagłówki HTTP do uwzględnienia w żądaniu HTTP. Dla żądania można dodać maksymalnie 20 nagłówków.
Treść żądania	(Opcjonalnie) W zależności od metody HTTP można określić zawartość treści HTTP. Testowanie obciążenia platformy Azure obsługuje następujące formaty: nieprzetworzone dane, widok JSON, JavaScript, HTML i XML.

Wykonaj następujące kroki, aby dodać żądanie HTTP do testu obciążeniowego opartego na adresach URL:

Witryna Azure Portal

1. W witrynie Azure Portal przejdź do zasobu testowania obciążenia.

2. W obszarze nawigacji po lewej stronie wybierz pozycję Testy , aby wyświetlić wszystkie testy.

3. Na liście wybierz test obciążeniowy, a następnie wybierz pozycję Edytuj.

   Pamiętaj, aby wybrać test obciążeniowy oparty na adresie URL z listy i że włączono opcję Włącz ustawienia zaawansowane na karcie Podstawowe .

4. Przejdź do karty Plan testów i wybierz pozycję Dodaj żądanie.

   

5. Wybierz pozycję Dodaj dane wejściowe w interfejsie użytkownika , aby wprowadzić szczegóły żądania HTTP.

6. Wprowadź szczegóły żądania HTTP, a następnie wybierz pozycję Dodaj , aby dodać żądanie do testu obciążeniowego.

   Pole	opis
   Format żądania	Wybierz pozycję Dodaj dane wejściowe w interfejsie użytkownika , aby skonfigurować szczegóły żądania za pomocą pól w witrynie Azure Portal.
   Nazwa żądania	Wprowadź unikatową nazwę żądania. Możesz odwołać się do tej nazwy żądania podczas definiowania kryteriów testu niepowodzenia.
   Adres URL	Adres URL punktu końcowego aplikacji.
   Metoda	Wybierz metodę HTTP z listy. Testowanie obciążenia platformy Azure obsługuje polecenia GET, POST, PUT, DELETE, PATCH, HEAD i OPTIONS.
   Parametry zapytań	(Opcjonalnie) Wprowadź parametry ciągu zapytania, aby dołączyć go do adresu URL.
   Nagłówki	(Opcjonalnie) Wprowadź nagłówki HTTP do uwzględnienia w żądaniu HTTP.
   Treść	(Opcjonalnie) W zależności od metody HTTP można również określić zawartość treści HTTP. Testowanie obciążenia platformy Azure obsługuje następujące formaty: nieprzetworzone dane, widok JSON, JavaScript, HTML i XML.

   

7. Wybierz pozycję Zastosuj , aby zapisać test obciążeniowy.

Azure Pipelines /GitHub Actions

Po uruchomieniu testu obciążeniowego w ramach przepływu pracy ciągłej integracji/ciągłego wdrażania, takiego jak GitHub Actions lub Azure Pipelines, należy podać listę żądań HTTP w pliku JSON żądań. W pliku YAML konfiguracji testu obciążeniowego należy odwołać się do pliku JSON we testPlan właściwości .

1. requests.json Utwórz plik do przechowywania żądań HTTP i wklej następujący fragment kodu w pliku:

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

   Opcjonalnie skonfiguruj ustawienia ładowania we testSetup właściwości . Dowiedz się więcej o konfigurowaniu parametrów ładowania dla testów obciążeniowych opartych na adresach URL.

2. Dodaj szczegóły żądania HTTP we requests właściwości :

   Poniższy fragment kodu przedstawia przykład żądania HTTP POST. Zwróć uwagę, że element ma wartość requestType 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. Zaktualizuj plik YAML konfiguracji testu obciążeniowego i ustaw testType ustawienia i testPlan :

   Upewnij się, że właściwość URL ma testType wartość , aby wskazać, że uruchamiasz test obciążeniowy oparty na adresie URL.

   Właściwość testPlan odwołuje się do pliku JSON żądania utworzonego w poprzednim kroku.

   Poniższy fragment kodu przedstawia fragment przykładowego pliku konfiguracji testu obciążeniowego:

   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. Zapisz oba pliki i zatwierdź je w repozytorium kontroli źródła.

Dodawanie żądań przy użyciu biblioteki cURL

Zamiast udostępniać szczegóły żądania HTTP, można również podać polecenia cURL dla żądań HTTP w teście obciążeniowym opartym na adresach URL. cURL to narzędzie wiersza polecenia i biblioteka dla żądań opartych na adresach URL.

Wykonaj następujące kroki, aby dodać żądanie HTTP do testu obciążeniowego przy użyciu polecenia cURL.

Witryna Azure Portal

1. Na liście testów wybierz test obciążeniowy, a następnie wybierz pozycję Edytuj.

   Pamiętaj, aby wybrać test obciążeniowy oparty na adresie URL z listy i że włączono opcję Włącz ustawienia zaawansowane na karcie Podstawowe .

2. Przejdź do karty Plan testów i wybierz pozycję Dodaj żądanie.

3. Wybierz pozycję Dodaj polecenie cURL, aby utworzyć żądanie HTTP przy użyciu biblioteki cURL.

4. Wprowadź polecenie cURL w polu polecenia cURL, a następnie wybierz pozycję Dodaj , aby dodać żądanie do testu obciążeniowego.

   W poniższym przykładzie użyto biblioteki cURL do wykonania żądania HTTP GET, określając nagłówek HTTP:

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

   

5. Wybierz pozycję Zastosuj , aby zapisać test obciążeniowy.

Azure Pipelines /GitHub Actions

Po uruchomieniu testu obciążeniowego w ramach przepływu pracy ciągłej integracji/ciągłego wdrażania, takiego jak GitHub Actions lub Azure Pipelines, należy podać listę żądań HTTP w pliku JSON żądań. W pliku YAML konfiguracji testu obciążeniowego należy odwołać się do pliku JSON we testPlan właściwości .

1. Utwórz plik JSON do przechowywania żądań HTTP i wklej następujący fragment kodu w pliku:

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

   Opcjonalnie skonfiguruj ustawienia ładowania we testSetup właściwości . Dowiedz się więcej o konfigurowaniu parametrów ładowania dla testów obciążeniowych opartych na adresach URL.

2. Dodaj polecenie cURL we requests właściwości :

   Poniższy fragment kodu przedstawia przykład żądania HTTP POST. Zwróć uwagę, że element ma wartość requestType 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 Ustaw ustawienia i testPlan w pliku YAML konfiguracji testu obciążeniowego, aby odwoływać się do pliku JSON żądań:

   Upewnij się, że właściwość URL ma testType wartość , aby wskazać, że uruchamiasz test obciążeniowy oparty na adresie URL.

   Właściwość testPlan odwołuje się do pliku JSON żądania utworzonego w poprzednim kroku.

   Poniższy fragment kodu przedstawia fragment przykładowego pliku konfiguracji testu obciążeniowego:

   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. Zapisz oba pliki i zatwierdź je w repozytorium kontroli źródła.

Używanie zmiennych w żądaniach HTTP

Możesz użyć zmiennych w żądaniu HTTP, aby zwiększyć elastyczność testów lub uniknąć dołączania wpisów tajnych w planie testów. Można na przykład użyć zmiennej środowiskowej z nazwą domeny punktu końcowego, a następnie użyć nazwy zmiennej w poszczególnych żądaniach HTTP. Użycie zmiennych sprawia, że plan testu jest bardziej elastyczny i konserwowalny.

W przypadku testów obciążeniowych opartych na adresach URL w usłudze Azure Load Testing można użyć zmiennych w celu odwoływania się do następujących informacji:

• Zmienne środowiskowe: można skonfigurować zmienne środowiskowe dla testu obciążeniowego
• Wpisy tajne: konfigurowanie wpisów tajnych usługi Azure Key Vault w teście obciążeniowym
• Wartości z pliku wejściowego CSV: użyj zmiennych dla kolumn w pliku wejściowym CSV i uruchom żądanie dla każdego wiersza w pliku
• Zmienne odpowiedzi: wyodrębnianie wartości z poprzedniego żądania HTTP

Składnia odwołująca się do zmiennej w żądaniu to: ${variable-name}.

Poniższy zrzut ekranu przedstawia sposób odwoływania się do zmiennej token w nagłówku HTTP przy użyciu polecenia ${token}.

Uwaga

Jeśli określisz certyfikaty, testowanie obciążenia platformy Azure automatycznie przekazuje certyfikaty w każdym żądaniu HTTP.

Używanie zmiennych odpowiedzi dla żądań zależnych

Aby utworzyć żądania HTTP, które są przestarzałe w poprzednim żądaniu, możesz użyć zmiennych odpowiedzi. Na przykład w pierwszym żądaniu możesz pobrać listę elementów z interfejsu API, wyodrębnić identyfikator z pierwszego wyniku, a następnie utworzyć kolejny i przekazać ten identyfikator jako parametr ciągu zapytania.

Testowanie obciążenia platformy Azure obsługuje następujące opcje wyodrębniania wartości z żądania HTTP i przechowywania ich w zmiennej:

• JSONPath
• XPath
• Regular expression

Na przykład w poniższym przykładzie pokazano, jak używać klasy XPathExtractor do przechowywania treści żądania w zmiennej token odpowiedzi. Następnie możesz użyć ${token} w innych żądaniach HTTP, aby odwołać się do tej wartości.

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

Powiązana zawartość

• Konfigurowanie testu obciążeniowego przy użyciu zmiennych środowiskowych i wpisów tajnych
• Odczytywanie danych z wejściowego pliku CSV
• Dokumentacja kodu YAML konfiguracji testu obciążeniowego