Azure Load Testing-clientbibliotheek voor .NET - versie 1.0.1

Artikel
04/03/2023

Azure Load Testing biedt de gebruiker een clientbibliotheek in .NET waarmee deze systeemeigen kan communiceren met de Azure Load Testing-service. Azure Load Testing is een volledig beheerde service voor het testen van de belasting waarmee u grootschalige belasting kunt genereren. De service simuleert verkeer voor uw toepassingen, ongeacht waar ze worden gehost. Ontwikkelaars, testers en QA-technici (quality assurance) kunnen het gebruiken om de prestaties, schaalbaarheid of capaciteit van toepassingen te optimaliseren.

Broncode | Pakket (NuGet) | API-referentiedocumentatie | Productdocumentatie

Documentatie

Er is diverse documentatie beschikbaar om u op weg te helpen

Aan de slag

Het pakket installeren

Installeer de clientbibliotheek voor .NET met NuGet:

dotnet add package Azure.Developer.LoadTesting

Vereisten

U moet een Azure-abonnement en een Azure Load Test Service-resource hebben. Als u wilt profiteren van de C# 8.0-syntaxis, wordt u aangeraden te compileren met behulp van de .NET Core SDK 3.0 of hoger met een taalversie van latest. Het is ook mogelijk om te compileren met de .NET Core SDK 2.1.x met behulp van een taalversie van preview.

De client verifiëren

Als u een AAD-tokenreferentie (Azure Active Directory) wilt gebruiken, geeft u een exemplaar op van het gewenste referentietype dat is verkregen uit de azure-identity-bibliotheek .

Als u wilt verifiëren met AAD, moet u eerst nuget install gebruiken azure-identity

Na de installatie kunt u kiezen welk type referentie van Azure.Identity u wilt gebruiken.

Meld u bijvoorbeeld aan via de Azure CLI-opdracht az login en DefaultAzureCredential wordt geverifieerd als die gebruiker.

Gebruik de geretourneerde tokenreferentie om de client te verifiëren.

Belangrijkste concepten

De volgende onderdelen vormen de Azure Load Testing-service. Met de Azure Load Test-clientbibliotheek voor C# kunt u met elk van deze onderdelen communiceren via het gebruik van clients. Er zijn twee clients:

LoadTestAdministrationClient
LoadTestRunClient

Deze clients worden gebruikt voor het beheren en gebruiken van verschillende onderdelen van de service. Voor elke methode in beide subclients is er een overeenkomstige Async-methode in dezelfde klasse, met dezelfde implementatie, maar maakt asynchrone functies mogelijk. Als er bijvoorbeeld een methode is, CreateOrUpdateTest bestaat LoadTestAdministrationClient er altijd nog één functie CreateOrUpdateTestAsync in dezelfde clientklasse.

Client voor belastingstestbeheer

De LoadTestAdministrationClient client wordt gebruikt voor het beheren en configureren van de belastingstests, app-onderdelen en metrische gegevens.

Testen

Een test specificeert het testscript en de configuratie-instellingen voor het uitvoeren van een belastingstest. U kunt een of meer tests maken in een Azure Load Testing-resource.

App-onderdeel

Wanneer u een belastingstest uitvoert voor een door Azure gehoste toepassing, kunt u metrische resourcegegevens bewaken voor de verschillende Azure-toepassingsonderdelen (metrische gegevens aan de serverzijde). Terwijl de belastingstest wordt uitgevoerd, en na voltooiing van de test, kunt u de metrische resourcegegevens bewaken en analyseren in het Azure Load Testing-dashboard.

Metrische gegevens

Tijdens een belastingstest verzamelt Azure Load Testing metrische gegevens over de uitvoering van de test. Er zijn twee typen metrische gegevens:

Metrische gegevens aan de clientzijde bieden u details die zijn gerapporteerd door de testengine. Deze metrische gegevens omvatten het aantal virtuele gebruikers, de reactietijd van de aanvraag, het aantal mislukte aanvragen of het aantal aanvragen per seconde.
Metrische gegevens aan de serverzijde zijn beschikbaar voor door Azure gehoste toepassingen en bieden informatie over de onderdelen van uw Azure-toepassing. Metrische gegevens kunnen betrekking hebben op het aantal databaseleesbewerkingen, het type HTTP-antwoorden of het verbruik van containerresources.

Test Run Client

De LoadTestRunClient client wordt gebruikt om testuitvoeringen te starten en te stoppen die overeenkomen met een belastingstest. Een testuitvoering vertegenwoordigt één uitvoering van een belastingstest. Het verzamelt de logboeken die zijn gekoppeld aan het uitvoeren van het Apache JMeter-script, de YAML-configuratie van de belastingstest, de lijst met app-onderdelen die moeten worden bewaakt en de resultaten van de test.

Data-Plane-eindpunt

Het gegevensvlak van Azure Load Testing-resources kan worden adresseerbaar met behulp van de volgende URL-indeling:

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

De eerste GUID 00000000-0000-0000-0000-000000000000 is de unieke id die wordt gebruikt voor toegang tot de Azure Load Testing-resource. Dit wordt gevolgd door aaa de Azure-regio van de resource.

Het eindpunt van het gegevensvlak wordt verkregen uit besturingsvlak-API's.

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

In het bovenstaande voorbeeld eus vertegenwoordigt de Azure-regio East US.

Voorbeelden

U kunt uzelf vertrouwd maken met verschillende API's met behulp van Voorbeelden.

Problemen oplossen

Meer hierover is binnenkort beschikbaar...

Veiligheid van schroefdraad

We garanderen dat alle clientexemplaren veilig zijn en onafhankelijk van elkaar zijn (richtlijn). Dit zorgt ervoor dat de aanbeveling om clientexemplaren opnieuw te gebruiken altijd veilig is, zelfs voor alle threads.

Volgende stappen

Ga aan de slag met onze voorbeelden.

Bijdragen

Dit is een sjabloon, maar uw SDK-leesmij moet details bevatten over hoe u code kunt bijdragen aan de opslagplaats/het pakket.

Aanvullende concepten

Delen via