Bibliothèque de client Test de charge Azure pour .NET - version 1.0.1

Article
04/03/2023

Test de charge Azure fournit une bibliothèque cliente dans .NET à l’utilisateur grâce à laquelle il peut interagir en mode natif avec le service Test de charge Azure. Test de charge Azure est un service complètement managé qui permet de générer une charge à grande échelle. Il simule un trafic pour vos applications, quel que soit l’endroit où elles sont hébergées. Les développeurs, testeurs et ingénieurs d’assurance qualité peuvent l’utiliser pour optimiser les performances, la scalabilité ou la capacité d’une application.

| Code source Package (NuGet) | Documentation de référence sur les | API Documentation produit

Documentation

Diverses documentations sont disponibles pour vous aider à démarrer

Prise en main

Installer le package

Installez la bibliothèque cliente pour .NET avec NuGet :

dotnet add package Azure.Developer.LoadTesting

Prérequis

Vous devez disposer d’un abonnement Azure et d’une ressource de service de test de charge Azure. Pour tirer parti de la syntaxe C# 8.0, il est recommandé de compiler à l’aide du KIT de développement logiciel (SDK) .NET Core 3.0 ou version ultérieure avec une version linguistique de latest. Il est également possible de compiler avec le Kit de développement logiciel (SDK) .NET Core 2.1.x à l’aide d’une version linguistique de preview.

Authentifier le client

Pour utiliser des informations d’identification de jeton Azure Active Directory (AAD), fournissez une instance du type d’informations d’identification souhaité obtenu à partir de la bibliothèque d’identité Azure.

Pour vous authentifier auprès d’AAD, vous devez d’abord utiliser nuget install azure-identity

Après l’installation, vous pouvez choisir le type d’informations d’identification d’Azure.Identity à utiliser.

Par exemple, connectez-vous via la commande Azure CLI az login et DefaultAzureCredential s’authentifiera en tant qu’utilisateur.

Utilisez les informations d’identification de jeton retournées pour authentifier le client.

Concepts clés

Les composants suivants composent le service Test de charge Azure. La bibliothèque cliente test de charge Azure pour C# vous permet d’interagir avec chacun de ces composants via l’utilisation de clients. Il existe deux clients :

LoadTestAdministrationClient
LoadTestRunClient

Ces clients sont utilisés pour gérer et utiliser différents composants du service. Pour chaque méthode de ces deux sous-clients, il existe une méthode Async correspondante dans la même classe, avec la même implémentation qui permet toutefois d’activer des fonctionnalités asynchrones. Par exemple, s’il existe une méthode, CreateOrUpdateTest dans le cadre de LoadTestAdministrationClient , il existe toujours une fonction CreateOrUpdateTestAsync de plus dans la même classe cliente.

Client d’administration de test de charge

Le LoadTestAdministrationClient client est utilisé pour administrer et configurer les tests de charge, les composants d’application et les métriques.

Test

Un test spécifie le script de test et les paramètres de configuration pour l’exécution d’un test de charge. Vous pouvez créer un ou plusieurs tests dans une ressource de test de charge Azure.

Composant d’application

Lorsque vous exécutez un test de charge pour une application hébergée sur Azure, vous pouvez surveiller les métriques des ressources pour les différents composants de l’application Azure (métriques côté serveur). Pendant l’exécution du test de charge et après l’achèvement du test, vous pouvez surveiller et analyser les métriques de ressources dans le tableau de bord de test de charge Azure.

Mesures

Pendant un test de charge, le test de charge Azure collecte des métriques sur l’exécution des tests. Il existe deux types de métriques :

Les métriques côté client fournissent des détails signalés par le moteur de test. Ces métriques comprennent le nombre d’utilisateurs virtuels, le temps de réponse aux requêtes, le nombre de requêtes ayant échoué et le nombre de requêtes par seconde.
Les métriques côté serveur sont disponibles pour les applications hébergées par Azure et fournissent des informations sur vos composants d’application Azure. Les métriques peuvent concerner le nombre de lectures de base de données, le type de réponses HTTP ou la consommation de ressources de conteneur.

Client d’exécution de test

Le LoadTestRunClient client est utilisé pour démarrer et arrêter des exécutions de test correspondant à un test de charge. Une série de tests représente une exécution d’un test de charge. Elle collecte les journaux associés à l’exécution du script Apache JMeter, la configuration YAML du test de charge, la liste des composants d’application à analyser et les résultats du test.

point de terminaison Data-Plane

Le plan de données des ressources Test de charge Azure est adressable au format d’URL suivant :

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

Le premier GUID 00000000-0000-0000-0000-000000000000 est l’identificateur unique utilisé pour accéder à la ressource Test de charge Azure. Suivi de aaa la région Azure de la ressource.

Le point de terminaison du plan de données est obtenu à partir des API de plan de contrôle.

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

Dans l’exemple ci-dessus, eus représente la région East USAzure .

Exemples

Vous pouvez vous familiariser avec différentes API à l’aide d’exemples.

Résolution des problèmes

Plus d’informations à ce sujet sera bientôt disponible...

Sécurité des threads

Nous garantissons que toutes les méthodes de instance client sont sécurisées pour les threads et indépendantes les unes des autres (recommandations). Cela garantit que la recommandation de réutilisation des instances clientes est toujours sécurisée, même entre les threads.

Étapes suivantes

Bien commencer avec nos exemples.

Contribution

Il s’agit d’un modèle, mais votre fichier readme sdk doit inclure des détails sur la façon de contribuer du code au dépôt/package.

Concepts supplémentaires