Biblioteka klienta testowania obciążenia platformy Azure dla platformy .NET — wersja 1.0.1

Artykuł
04/03/2023

Testowanie obciążenia platformy Azure udostępnia bibliotekę klienta na platformie .NET użytkownikowi, za pomocą którego mogą natywnie korzystać z usługi Azure Load Testing. Testowanie obciążenia platformy Azure to w pełni zarządzana usługa testowania obciążenia, która umożliwia generowanie obciążenia na dużą skalę. Usługa symuluje ruch dla aplikacji, niezależnie od tego, gdzie są hostowane. Deweloperzy, testerzy i inżynierowie zapewniania jakości (QA) mogą jej używać do optymalizowania wydajności, skalowalności lub pojemności aplikacji.

Kod | źródłowy Pakiet (NuGet) | Dokumentacja referencyjna interfejsu | API Dokumentacja produktu

Dokumentacja

Dostępna jest różne dokumenty ułatwiające rozpoczęcie pracy

Wprowadzenie

Instalowanie pakietu

Zainstaluj bibliotekę klienta dla platformy .NET przy użyciu narzędzia NuGet:

dotnet add package Azure.Developer.LoadTesting

Wymagania wstępne

Musisz mieć subskrypcję platformy Azure i zasób usługi Azure Load Test Service. Aby korzystać ze składni języka C# 8.0, zaleca się skompilowanie przy użyciu zestawu .NET Core SDK 3.0 lub nowszego latestz wersją języka . Można również skompilować zestaw .NET Core SDK 2.1.x przy użyciu wersji językowej .preview

Uwierzytelnianie klienta

Aby użyć poświadczeń tokenu usługi Azure Active Directory (AAD), podaj wystąpienie żądanego typu poświadczeń uzyskanego z biblioteki azure-identity .

Aby uwierzytelnić się w usłudze AAD, należy najpierw użyć instalacji nuget azure-identity

Po skonfigurowaniu można wybrać typ poświadczeń z witryny Azure.Identity do użycia.

Na przykład zaloguj się za pomocą polecenia interfejsu wiersza polecenia az login platformy Azure, a parametr DefaultAzureCredential będzie uwierzytelniany jako ten użytkownik.

Użyj zwróconego poświadczenia tokenu, aby uwierzytelnić klienta.

Kluczowe pojęcia

Poniższe składniki składają się na usługę Azure Load Testing. Biblioteka klienta usługi Azure Load Test dla języka C# umożliwia interakcję z każdym z tych składników przy użyciu klientów. Istnieją dwa klientów:

LoadTestAdministrationClient
LoadTestRunClient

Ci klienci są przyzwyczajeni do zarządzania różnymi składnikami usługi i korzystania z nich. Dla każdej metody w obu tych podrzędnych klientach istnieje odpowiednia metoda asynchroniczna w tej samej klasie, z tą samą implementacją, jednak umożliwiającą funkcje asynchroniczne. Jeśli na przykład istnieje metoda, CreateOrUpdateTest w ramach tej LoadTestAdministrationClient samej klasy klienta zawsze istnieje jeszcze jedna funkcja CreateOrUpdateTestAsync .

Klient administracji testów obciążeniowych

Klient LoadTestAdministrationClient służy do administrowania i konfigurowania testów obciążeniowych, składników aplikacji i metryk.

Testowanie

Test określa skrypt testowy i ustawienia konfiguracji do uruchamiania testu obciążeniowego. Co najmniej jeden test można utworzyć w zasobie testowania obciążenia platformy Azure.

Składnik aplikacji

Po uruchomieniu testu obciążeniowego dla aplikacji hostowanej na platformie Azure można monitorować metryki zasobów dla różnych składników aplikacji platformy Azure (metryki po stronie serwera). Podczas uruchamiania testu obciążeniowego i po zakończeniu testu można monitorować i analizować metryki zasobów na pulpicie nawigacyjnym testowania obciążenia platformy Azure.

Metryki

Podczas testu obciążeniowego usługa Azure Load Testing zbiera metryki dotyczące wykonywania testu. Istnieją dwa typy metryk:

Metryki po stronie klienta zawierają szczegółowe informacje zgłaszane przez aparat testowy. Te metryki obejmują liczbę użytkowników wirtualnych, czas odpowiedzi żądania, liczbę żądań zakończonych niepowodzeniem lub liczbę żądań na sekundę.
Metryki po stronie serwera są dostępne dla aplikacji hostowanych na platformie Azure i zawierają informacje o składnikach aplikacji platformy Azure. Metryki mogą być przeznaczone dla liczby odczytów bazy danych, typu odpowiedzi HTTP lub użycia zasobów kontenera.

Test Run Client

Klient jest używany do uruchamiania LoadTestRunClient i zatrzymywania przebiegów testów odpowiadających testowi obciążeniowemu. Przebieg testu reprezentuje jedno wykonanie testu obciążeniowego. Zbiera dzienniki skojarzone z uruchomieniem skryptu Apache JMeter, konfiguracją testu obciążeniowego YAML, listą składników aplikacji do monitorowania oraz wynikami testu.

punkt końcowy Data-Plane

Płaszczyzna danych zasobów testowania obciążenia platformy Azure jest adresowalna przy użyciu następującego formatu adresu URL:

00000000-0000-0000-0000-000000000000.aaa.cnt-prod.loadtesting.azure.com

Pierwszy identyfikator GUID 00000000-0000-0000-0000-000000000000 jest unikatowym identyfikatorem używanym do uzyskiwania dostępu do zasobu testowania obciążenia platformy Azure. Następuje aaa po tym, który jest regionem świadczenia usługi Azure zasobu.

Punkt końcowy płaszczyzny danych jest uzyskiwany z interfejsów API płaszczyzny sterowania.

Przykład:1234abcd-12ab-12ab-12ab-123456abcdef.eus.cnt-prod.loadtesting.azure.com

W powyższym przykładzie eus reprezentuje region East USświadczenia usługi Azure .

Przykłady

Możesz zapoznać się z różnymi interfejsami API przy użyciu przykładów.

Rozwiązywanie problemów

Więcej o tym wkrótce...

Bezpieczeństwo wątkowe

Gwarantujemy, że wszystkie metody wystąpienia klienta są bezpieczne wątkowo i niezależne od siebie (wytyczne). Dzięki temu zalecenie ponownego instalowania wystąpień klienta jest zawsze bezpieczne, nawet w wątkach.

Następne kroki

Rozpocznij pracę z naszymi przykładami.

Współtworzenie

Jest to szablon, ale plik readme zestawu SDK powinien zawierać szczegółowe informacje na temat współtworzenia kodu w repozytorium/pakiecie.

Dodatkowe pojęcia

Udostępnij za pośrednictwem