Azure Load Testing-klientbibliotek för .NET – version 1.0.1

Artikel
04/03/2023

Azure Load Testing tillhandahåller klientbibliotek i .NET till användaren som de kan interagera med internt med Azure Load Testing-tjänsten. Azure Load Testing är en fullständigt hanterad tjänst för belastningstestning som gör att du kan generera högskalig belastning. Tjänsten simulerar trafik för dina program, oavsett var de finns. Utvecklare, testare och kvalitetssäkringstekniker kan använda den för att optimera programmets prestanda, skalbarhet eller kapacitet.

| Källkod Paket (NuGet) | API-referensdokumentation | Produktdokumentation

Dokumentation

Det finns olika dokumentation som hjälper dig att komma igång

Komma igång

Installera paketet

Installera klientbiblioteket för .NET med NuGet:

dotnet add package Azure.Developer.LoadTesting

Förutsättningar

Du måste ha en Azure-prenumeration och en Azure Load Test Service-resurs. För att kunna dra nytta av C# 8.0-syntaxen rekommenderar vi att du kompilerar med hjälp av .NET Core SDK 3.0 eller senare med en språkversion av latest. Det går också att kompilera med .NET Core SDK 2.1.x med hjälp av en språkversion av preview.

Autentisera klienten

Om du vill använda en AAD-tokenautentisering (Azure Active Directory) anger du en instans av önskad typ av autentiseringsuppgifter som hämtats från biblioteket azure-identity .

Om du vill autentisera med AAD måste du först använda nuget-installation azure-identity

Efter installationen kan du välja vilken typ av autentiseringsuppgifter från Azure.Identity som ska användas.

Logga till exempel in via Azure CLI-kommandot az login så autentiseras DefaultAzureCredential som den användaren.

Använd den returnerade tokenautentiseringsuppgiften för att autentisera klienten.

Viktiga begrepp

Följande komponenter utgör Azure Load Testing-tjänsten. Med Azure Load Test-klientbiblioteket för C# kan du interagera med var och en av dessa komponenter med hjälp av klienter. Det finns två klienter:

LoadTestAdministrationClient
LoadTestRunClient

Dessa klienter används för att hantera och använda olika komponenter i tjänsten. För varje metod i båda dessa underklienter finns det en motsvarande Async-metod i samma klass, där samma implementering dock möjliggör asynkrona funktioner. Om det till exempel finns en metod, CreateOrUpdateTest som en del av LoadTestAdministrationClient så finns det alltid en funktion CreateOrUpdateTestAsync till i samma klientklass.

Belastningstestadministrationsklient

Klienten LoadTestAdministrationClient används för att administrera och konfigurera belastningstester, appkomponenter och mått.

Testa

Ett test anger testskriptet och konfigurationsinställningarna för att köra ett belastningstest. Du kan skapa ett eller flera tester i en Azure Load Testing-resurs.

Appkomponent

När du kör ett belastningstest för ett Azure-värdbaserat program kan du övervaka resursmått för de olika Azure-programkomponenterna (mått på serversidan). När belastningstestet körs och när testet har slutförts kan du övervaka och analysera resursmåtten på instrumentpanelen för Azure Load Testing.

Mått

Under ett belastningstest samlar Azure Load Testing in mått om testkörningen. Det finns två typer av mått:

Mått på klientsidan ger information som rapporterats av testmotorn. Dessa mått omfattar antalet virtuella användare, svarstiden för begäran, antalet misslyckade begäranden eller antalet begäranden per sekund.
Mått på serversidan är tillgängliga för Azure-värdbaserade program och ger information om dina Azure-programkomponenter. Mått kan vara för antalet databasläsningar, typen av HTTP-svar eller förbrukningen av containerresurser.

Testkörningsklient

Klienten LoadTestRunClient används för att starta och stoppa testkörningar som motsvarar ett belastningstest. En testkörning representerar en körning av ett belastningstest. Den samlar in loggarna som är associerade med att köra Apache JMeter-skriptet, YAML-konfigurationen för belastningstestet, listan över appkomponenter som ska övervakas och resultatet av testet.

Data-Plane slutpunkt

Dataplanet för Azure Load Testing-resurser kan adresseras med följande URL-format:

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

Det första GUID 00000000-0000-0000-0000-000000000000 :t är den unika identifierare som används för åtkomst till Azure Load Testing-resursen. Detta följs av aaa som är Azure-regionen för resursen.

Dataplanets slutpunkt hämtas från API:er för kontrollplanet.

Exempel:1234abcd-12ab-12ab-12ab-123456abcdef.eus.cnt-prod.loadtesting.azure.com

I exemplet ovan eus representerar azure-regionen East US.

Exempel

Du kan bekanta dig med olika API:er med hjälp av exempel.

Felsökning

Mer om det kommer snart...

Trådsäkerhet

Vi garanterar att alla klientinstansmetoder är trådsäkra och oberoende av varandra (riktlinje). Detta säkerställer att rekommendationen att återanvända klientinstanser alltid är säker, även över trådar.

Nästa steg

Kom igång med våra exempel.

Bidra

Det här är en mall, men SDK-läsningen bör innehålla information om hur du bidrar med kod till lagringsplatsen/paketet.

Ytterligare begrepp

Dela via