Biblioteca de clientes do Teste de Carga do Azure para .NET – versão 1.0.1

Artigo
04/03/2023

O Teste de Carga do Azure fornece biblioteca de clientes no .NET para o usuário pelo qual ele pode interagir nativamente com o serviço de Teste de Carga do Azure. Teste de Carga do Azure é um serviço de teste de carga totalmente gerenciado que permite gerar cargas de alta escala. O serviço simula o tráfego para seus aplicativos, independentemente de onde estão hospedados. Desenvolvedores, testadores e engenheiros de QA (garantia de qualidade) podem usá-lo para otimizar o desempenho, a escalabilidade ou a capacidade do aplicativo.

Código-fonte | Pacote (NuGet) | Documentação | de referência da API Documentação do produto

Documentação

Várias documentações estão disponíveis para ajudá-lo a começar

Introdução

Instalar o pacote

Instale a biblioteca de clientes para .NET com o NuGet:

dotnet add package Azure.Developer.LoadTesting

Pré-requisitos

Você deve ter uma assinatura do Azure e um Recurso do Serviço de Teste de Carga do Azure. Para aproveitar a sintaxe do C# 8.0, é recomendável compilar usando o SDK do .NET Core 3.0 ou superior com uma versão de idioma do latest. Também é possível compilar com o SDK do .NET Core 2.1.x usando uma versão de linguagem do preview.

Autenticar o cliente

Para usar uma credencial de token do AAD (Azure Active Directory), forneça uma instância do tipo de credencial desejado obtido da biblioteca azure-identity .

Para autenticar com o AAD, primeiro você deve usar a instalação do nuget azure-identity

Após a instalação, você pode escolher qual tipo de credencial do Azure.Identity usar.

Por exemplo, entre por meio do comando da CLI az login do Azure e DefaultAzureCredential será autenticado como esse usuário.

Use a credencial de token retornada para autenticar o cliente.

Principais conceitos

Os componentes a seguir compõem o serviço de Teste de Carga do Azure. A biblioteca de clientes do Teste de Carga do Azure para C# permite que você interaja com cada um desses componentes por meio do uso de clientes. Há dois clientes:

LoadTestAdministrationClient
LoadTestRunClient

Esses clientes são usados para gerenciar e usar diferentes componentes do serviço. Para cada método em ambos os sub-clientes, há um método Async correspondente na mesma classe, com a mesma implementação, no entanto, habilitando funcionalidades assíncronas. Por exemplo, se houver um método , CreateOrUpdateTest como parte do LoadTestAdministrationClient , sempre haverá mais uma função CreateOrUpdateTestAsync na mesma classe de cliente.

Cliente de Administração de Teste de Carga

O LoadTestAdministrationClient cliente é usado para administrar e configurar os testes de carga, os componentes do aplicativo e as métricas.

Teste

Um teste especifica o script de teste e as definições de configuração para executar um teste de carga. É possível criar um ou mais testes em um recurso de Teste de Carga do Azure.

Componente do aplicativo

Ao executar um teste de carga para um aplicativo hospedado no Azure, você pode monitorar as métricas de recursos para os diferentes componentes de aplicativo do Azure (métricas do lado do servidor). Enquanto o teste de carga é executado e após a conclusão do teste, você pode monitorar e analisar as métricas de recurso no painel de Teste de Carga do Azure.

Métricas

Durante um teste de carga, o Teste de Carga do Azure coleta métricas sobre a execução do teste. Há dois tipos de métricas:

Métricas do lado do cliente fornecem detalhes relatados pelo mecanismo de teste. Essas métricas incluem o número de usuários virtuais, o tempo de resposta da solicitação, o número de solicitações com falha ou o número de solicitações por segundo.
As métricas do lado do servidor estão disponíveis para aplicativos hospedados no Azure e fornecem informações sobre os componentes do aplicativo do Azure. As métricas podem ser para o número de leituras de banco de dados, o tipo de respostas HTTP ou o consumo de recursos de contêiner.

Testar Executar Cliente

O LoadTestRunClient cliente é usado para iniciar e parar execuções de teste correspondentes a um teste de carga. Uma execução de teste representa uma execução de um teste de carga. Ele coleta os logs associados à execução do script Apache JMeter, a configuração yaml de teste de carga, a lista de componentes do aplicativo a monitorar e os resultados do teste.

ponto de extremidade Data-Plane

O plano de dados dos recursos do Teste de Carga do Azure é endereçável usando o seguinte formato de URL:

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

O primeiro GUID 00000000-0000-0000-0000-000000000000 é o identificador exclusivo usado para acessar o recurso de Teste de Carga do Azure. Isso é seguido por aaa qual é a região do Azure do recurso.

O ponto de extremidade do plano de dados é obtido das APIs do Painel de Controle.

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

No exemplo acima, eus representa a região East USdo Azure .

Exemplos

Você pode se familiarizar com APIs diferentes usando Exemplos.

Solução de problemas

Mais sobre isso está chegando em breve...

Acesso thread-safe

Garantimos que todos os métodos de instância do cliente sejam thread-safe e independentes uns dos outros (diretriz). Isso garante que a recomendação de reutilize instâncias de cliente seja sempre segura, mesmo entre threads.

Próximas etapas

Comece agora com os nossos exemplos.

Participante

Esse é um modelo, mas o leiame do SDK deve incluir detalhes sobre como contribuir com o código para o repositório/pacote.

Conceitos adicionais

Compartilhar via