Libreria client di Test di carico di Azure per .NET - versione 1.0.1

Articolo
04/03/2023

Test di carico di Azure fornisce la libreria client in .NET all'utente tramite cui può interagire in modo nativo con il servizio Test di carico di Azure. Test di carico di Azure è un servizio di test del carico completamente gestito che consente di generare un carico su larga scala. Il servizio simula il traffico per le applicazioni, indipendentemente dalla posizione in cui sono ospitate. Gli sviluppatori, i tester e i tecnici di controllo qualità possono usarlo per ottimizzare le prestazioni, la scalabilità o la capacità dell'applicazione.

Codice | sorgente Pacchetto (NuGet) | Documentazione | di riferimento sulle API Documentazione del prodotto

Documentazione

Sono disponibili varie documentazioni per iniziare

Introduzione

Installare il pacchetto

Installare la libreria client per .NET con NuGet:

dotnet add package Azure.Developer.LoadTesting

Prerequisiti

È necessario avere una sottoscrizione di Azure e una risorsa del servizio test di carico di Azure. Per sfruttare i vantaggi della sintassi C# 8.0, è consigliabile compilare usando .NET Core SDK 3.0 o versione successiva con una versione del linguaggio di latest. È anche possibile compilare con .NET Core SDK 2.1.x usando una versione del linguaggio di preview.

Autenticare il client

Per usare una credenziale del token di Azure Active Directory (AAD), specificare un'istanza del tipo di credenziale desiderato ottenuto dalla libreria azure-identity .

Per eseguire l'autenticazione con AAD, è prima necessario usare l'installazione nuget azure-identity

Dopo l'installazione, è possibile scegliere il tipo di credenziale da usare in Azure.Identity.

Ad esempio, accedere tramite il comando dell'interfaccia della riga di comando di Azure az login e DefaultAzureCredential eseguirà l'autenticazione come tale utente.

Usare le credenziali del token restituite per autenticare il client.

Concetti chiave

I componenti seguenti costituiscono il servizio Test di carico di Azure. La libreria client di test di carico di Azure per C# consente di interagire con ognuno di questi componenti tramite l'uso dei client. Esistono due client:

LoadTestAdministrationClient
LoadTestRunClient

Questi client vengono usati per la gestione e l'uso di componenti diversi del servizio. Per ogni metodo in entrambi i client secondari esiste un metodo Async corrispondente nella stessa classe, con la stessa implementazione, ma abilitando le funzionalità asincrone. Ad esempio, se è presente un metodo, CreateOrUpdateTest come parte di LoadTestAdministrationClient allora esiste sempre un'altra funzione CreateOrUpdateTestAsync nella stessa classe client.

Client di amministrazione test di carico

Il LoadTestAdministrationClient client viene usato per amministrare e configurare i test di carico, i componenti e le metriche dell'app.

Test

Un test specifica lo script di test e le impostazioni di configurazione per l'esecuzione di un test di carico. È possibile creare uno o più test in una risorsa di Test di carico di Azure.

Componente dell'app

Quando si esegue un test di carico per un'applicazione ospitata in Azure, è possibile monitorare le metriche delle risorse per i diversi componenti dell'applicazione di Azure (metriche lato server). Durante l'esecuzione del test di carico e dopo il completamento del test, è possibile monitorare e analizzare le metriche delle risorse nel dashboard test di carico di Azure.

Metriche

Durante un test di carico, Test di carico di Azure raccoglie le metriche relative all'esecuzione del test. Esistono due tipi di metriche:

Le metriche lato client forniscono i dettagli segnalati dal motore di test. Queste metriche includono il numero di utenti virtuali, il tempo di risposta della richiesta, il numero di richieste non riuscite o il numero di richieste al secondo.
Le metriche lato server sono disponibili per le applicazioni ospitate in Azure e forniscono informazioni sui componenti dell'applicazione Azure. Le metriche possono essere relative al numero di letture del database, al tipo di risposte HTTP o all'utilizzo delle risorse del contenitore.

Test Run Client

Il LoadTestRunClient client viene usato per avviare e arrestare le esecuzioni di test corrispondenti a un test di carico. Un'esecuzione di test rappresenta un'esecuzione di un test di carico. Raccoglie i log associati all'esecuzione dello script Apache JMeter, la configurazione YAML del test di carico, l'elenco dei componenti dell'app da monitorare e i risultati del test.

endpoint Data-Plane

Il piano dati delle risorse di Test di carico di Azure è indirizzabile usando il formato URL seguente:

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

Il primo GUID 00000000-0000-0000-0000-000000000000 è l'identificatore univoco usato per accedere alla risorsa test di carico di Azure. Questo è seguito da aaa che è l'area di Azure della risorsa.

L'endpoint del piano dati viene ottenuto dalle API del piano di controllo.

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

Nell'esempio precedente rappresenta eus l'area di East USAzure .

Esempio

È possibile acquisire familiarità con api diverse usando esempi.

Risoluzione dei problemi

Altre informazioni sono presto disponibili...

Thread safety

Microsoft garantisce che tutti i metodi di istanza client siano thread-safe e indipendenti l'uno dall'altro (linee guida). Ciò garantisce che la raccomandazione di riutilizzare le istanze client sia sempre sicura, anche tra thread.

Passaggi successivi

Introduzione agli esempi.

Contributo

Si tratta di un modello, ma il file leggimi dell'SDK deve includere informazioni dettagliate su come contribuire al codice al repository/pacchetto.

Concetti aggiuntivi

Condividi tramite