Biblioteca cliente de Azure Load Testing para .NET: versión 1.0.1

Artículo
04/03/2023

Azure Load Testing proporciona biblioteca cliente en .NET al usuario mediante la cual puede interactuar de forma nativa con el servicio Azure Load Testing. Azure Load Testing es un servicio de prueba de carga totalmente administrado que permite generar una carga a gran escala. El servicio simula el tráfico de las aplicaciones, independientemente del lugar en que se hospeden. Los desarrolladores, evaluadores e ingenieros de control de calidad (QA) pueden usarlo para optimizar el rendimiento, la escalabilidad o la capacidad de las aplicaciones.

Código | fuente Paquete (NuGet) | Documentación | de referencia de API Documentación del producto

Documentación

Hay varias documentación disponibles para ayudarle a empezar.

Introducción

Instalar el paquete

Instale la biblioteca cliente para .NET con NuGet:

dotnet add package Azure.Developer.LoadTesting

Prerrequisitos

Debe tener una suscripción de Azure y un recurso de Azure Load Test Service. Para aprovechar la sintaxis de C# 8.0, se recomienda compilar mediante el SDK de .NET Core 3.0 o posterior con una versión de lenguaje de .latest También es posible compilar con el SDK de .NET Core 2.1.x mediante una versión de lenguaje de preview.

Autenticar el cliente

Para usar una credencial de token de Azure Active Directory (AAD), proporcione una instancia del tipo de credencial deseado obtenido de la biblioteca azure-identity .

Para autenticarse con AAD, primero debe usar la instalación de NuGet . azure-identity

Después de la instalación, puede elegir el tipo de credencial de Azure.Identity que se va a usar.

Por ejemplo, inicie sesión mediante el comando de la CLI az login de Azure y DefaultAzureCredential se autenticará como ese usuario.

Use la credencial de token devuelta para autenticar al cliente.

Conceptos clave

Los siguientes componentes componen el servicio Azure Load Testing. La biblioteca cliente de Prueba de carga de Azure para C# permite interactuar con cada uno de estos componentes mediante el uso de clientes. Hay dos clientes:

LoadTestAdministrationClient
LoadTestRunClient

Estos clientes se usan para administrar y usar distintos componentes del servicio. Para cada método de estos sub-clientes hay un método asincrónico correspondiente en la misma clase, con la misma implementación, pero habilitando las funcionalidades asincrónicas. Por ejemplo, si hay un método , CreateOrUpdateTest como parte de LoadTestAdministrationClient , siempre existe una función CreateOrUpdateTestAsync más en la misma clase de cliente.

Cliente de administración de pruebas de carga

El LoadTestAdministrationClient cliente se usa para administrar y configurar las pruebas de carga, los componentes de la aplicación y las métricas.

Prueba

Una prueba especifica el script de prueba y las opciones de configuración para ejecutar una prueba de carga. Puede crear una o varias pruebas en un recurso de Azure Load Testing.

Componente de aplicación

Al ejecutar una prueba de carga para una aplicación hospedada en Azure, puede supervisar las métricas de recursos de los distintos componentes de la aplicación de Azure (métricas del lado servidor). Mientras se ejecuta la prueba de carga y después de la finalización de la prueba, puede supervisar y analizar las métricas de recursos en el panel Azure Load Testing.

Métricas

Durante una prueba de carga, Azure Load Testing recopila métricas sobre la ejecución de pruebas. Existen dos tipos de métricas:

Las métricas del cliente proporcionan los detalles notificados por el motor de prueba. Estas métricas incluyen el número de usuarios virtuales, el tiempo de respuesta de la solicitud, el número de solicitudes con error o el número de solicitudes por segundo.
Las métricas del lado servidor están disponibles para las aplicaciones hospedadas en Azure y proporcionan información sobre los componentes de las aplicaciones de Azure. Las métricas pueden ser para el número de lecturas de base de datos, el tipo de respuestas HTTP o el consumo de recursos de contenedor.

Probar el cliente de ejecución

El LoadTestRunClient cliente se usa para iniciar y detener las ejecuciones de pruebas correspondientes a una prueba de carga. Una serie de pruebas representa la ejecución de una prueba de carga. Recopila los registros asociados a la ejecución del script de Apache JMeter, la configuración de YAML de prueba de carga, la lista de componentes de la aplicación que se va a supervisar y los resultados de la prueba.

punto de conexión de Data-Plane

El plano de datos de los recursos de Azure Load Testing se puede direccionable mediante el siguiente formato de dirección URL:

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

El primer GUID 00000000-0000-0000-0000-000000000000 es el identificador único que se usa para acceder al recurso de Azure Load Testing. Esto va seguido de aaa la región de Azure del recurso.

El punto de conexión del plano de datos se obtiene de las API del plano de control.

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

En el ejemplo anterior, eus representa la región East USde Azure .

Ejemplos

Puede familiarizarse con diferentes API mediante ejemplos.

Solución de problemas

Más información sobre él está disponible próximamente...

Seguridad para subprocesos

Garantizamos que todos los métodos de instancia de cliente son seguros para subprocesos e independientes entre sí (instrucciones). Esto garantiza que la recomendación de reutilizar instancias de cliente siempre es segura, incluso entre subprocesos.

Pasos siguientes

Comience a trabajar con nuestros ejemplos.

Contribuir

Se trata de una plantilla, pero el archivo Léame del SDK debe incluir detalles sobre cómo contribuir al código en el repositorio o paquete.

Conceptos adicionales

Compartir a través de