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

  • Artigo

Os Testes de Carga do Azure fornecem a biblioteca de cliente no .NET ao utilizador através da qual podem interagir nativamente com o serviço de Teste de Carga do Azure. O Teste de Carga do Azure é um serviço de teste de carga totalmente gerido que lhe permite gerar carga de grande escala. O serviço simula o tráfego para as suas aplicações, independentemente do local onde estão alojadas. Os programadores, testadores e engenheiros de garantia de qualidade (QA) podem utilizá-lo para otimizar o desempenho, escalabilidade ou capacidade da aplicação.

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

Documentação

Estão disponíveis várias documentação para o ajudar a começar

Introdução

Instalar o pacote

Instale a biblioteca de cliente para .NET com NuGet:

dotnet add package Azure.Developer.LoadTesting

Pré-requisitos

Tem de ter uma subscrição do Azure e um Recurso do Serviço de Teste de Carga do Azure. Para tirar partido da sintaxe C# 8.0, recomenda-se que compile com o SDK .NET Core 3.0 ou superior com uma versão de linguagem do latest. Também é possível compilar com o SDK .NET Core 2.1.x com uma versão de linguagem do preview.

Autenticar o cliente

Para utilizar uma credencial de token do Azure Active Directory (AAD), forneça uma instância do tipo de credencial pretendido obtido a partir da biblioteca de identidades do azure .

Para autenticar com o AAD, primeiro tem de utilizar a instalação nugetazure-identity

Após a configuração, pode escolher o tipo de credencial a utilizar em Azure.Identity.

Por exemplo, inicie sessão através do comando da CLI az login do Azure e DefaultAzureCredential será autenticado como esse utilizador.

Utilize a credencial do token devolvido para autenticar o cliente.

Conceitos-chave

Os seguintes componentes compõem o serviço Azure Load Testing. A biblioteca de cliente do Azure Load Test para C# permite-lhe interagir com cada um destes componentes através da utilização de clientes. Existem dois clientes:

  • LoadTestAdministrationClient

  • LoadTestRunClient

Estes clientes são utilizados para gerir e utilizar diferentes componentes do serviço. Para cada método em ambos os sub-clientes, existe um método Assíncrono correspondente na mesma classe, com a mesma implementação, no entanto, a ativar funcionalidades assíncronas. Por exemplo, se existir um método, CreateOrUpdateTest como parte de LoadTestAdministrationClient , existe sempre mais uma função CreateOrUpdateTestAsync na mesma classe de cliente.

Cliente de Administração do Teste de Carga

O LoadTestAdministrationClient cliente é utilizado para administrar e configurar os testes de carga, componentes da aplicação e métricas.

Teste

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

Componente da Aplicação

Quando executa um teste de carga para uma aplicação alojada no Azure, pode monitorizar as métricas de recursos para os diferentes componentes da aplicação do Azure (métricas do lado do servidor). Enquanto o teste de carga é executado e após a conclusão do teste, pode monitorizar e analisar as métricas de recursos no dashboard do Teste de Carga do Azure.

Métricas

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

  1. As métricas do lado do cliente fornecem-lhe detalhes comunicados pelo motor de teste. Estas métricas incluem o número de utilizadores virtuais, o tempo de resposta do pedido, o número de pedidos falhados ou o número de pedidos por segundo.

  2. As métricas do lado do servidor estão disponíveis para aplicações alojadas no Azure e fornecem informações sobre os componentes da aplicação do Azure. As métricas podem ser para o número de leituras da base de dados, o tipo de respostas HTTP ou o consumo de recursos de contentor.

Cliente de Execução de Teste

O LoadTestRunClient cliente é utilizado para iniciar e parar execuções de testes correspondentes a um teste de carga. Uma execução de teste representa uma execução de um teste de carga. Recolhe os registos associados à execução do script do Apache JMeter, a configuração do YAML do teste de carga, a lista de componentes da aplicação a monitorizar e os resultados do teste.

Ponto Final do Data-Plane

O plano de dados dos recursos do Teste de Carga do Azure é endereçável com 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 utilizado para aceder ao recurso de Teste de Carga do Azure. Segue-se aaa a região do Azure do recurso.

O ponto final do plano de dados é obtido a partir das APIs do Plano de Controlo.

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

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

Exemplos

Pode familiarizar-se com diferentes APIs com Exemplos.

Resolução de problemas

Mais sobre isso está para breve...

Segurança de threads

Garantimos que todos os métodos de instância de cliente são seguros para threads e independentes uns dos outros (orientação). Isto garante que a recomendação de reutilização de instâncias de cliente é sempre segura, mesmo entre threads.

Passos seguintes

Comece a utilizar os nossos exemplos.

Contribuir

Este é um modelo, mas o seu nome de leitura do SDK deve incluir detalhes sobre como contribuir com código para o repositório/pacote.

Conceitos adicionais

Opções de | cliente Aceder à resposta | Operações de execução prolongada | Lidar com falhas | Diagnósticos | A gozar | Duração do cliente