Adicionar solicitações a testes de carga baseados em URL no Teste de Carga do Azure

Neste artigo, você aprenderá a adicionar solicitações HTTP a um teste de carga baseado em URL no Teste de Carga do Azure. Use um teste de carga baseado em URL para validar pontos de extremidade HTTP, como aplicativos Web ou pontos de extremidade REST, sem conhecimento prévio de ferramentas de teste de carga e scripts.

O Azure dá suporte a duas maneiras de definir solicitações HTTP em um teste de carga baseado em URL. Você pode combinar os dois métodos em um teste de carga.

• Especifique os detalhes do ponto de extremidade HTTP, como a URL do ponto de extremidade, o método HTTP, os cabeçalhos, os parâmetros de consulta ou o corpo da solicitação.
• Insira um comando cURL para a solicitação HTTP.

Se você tiver solicitações dependentes, poderá extrair valores de resposta de uma solicitação e passá-los como entrada para uma solicitação subsequente. Por exemplo, você pode primeiro recuperar os detalhes do cliente e extrair a ID do cliente para recuperar os detalhes do pedido do cliente.

Se você usar um teste de carga baseado em URL no fluxo de trabalho de CI/CD, poderá passar um arquivo JSON que contém as solicitações HTTP para o teste de carga.

Você pode adicionar até cinco solicitações a um teste de carga baseado em URL. Para testes de carga mais complexos, você pode criar um teste de carga carregando um script de teste do JMeter. Por exemplo, quando você tiver mais de cinco solicitações, se usar protocolos não HTTP ou se precisar usar plug-ins JMeter.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
• Um recurso de teste de carga do Azure. Para criar um recurso de teste de carga, consulte Criar e executar um teste de carga.

Adicionar solicitações com detalhes HTTP

Você pode especificar uma solicitação HTTP para um teste de carga baseado em URL fornecendo os detalhes da solicitação HTTP. A seguinte tabela lista os campos que você pode configurar para uma solicitação HTTP no Teste de Carga do Azure:

Campo	Detalhes
URL	A URL do ponto de extremidade HTTP. Por exemplo, https://www.contoso.com/products.
Método	O método HTTP. O Teste de Carga do Azure dá suporte a GET, POST, PUT, DELETE, PATCH, HEAD e OPTIONS.
Parâmetros de consulta	(Opcional) Insira parâmetros de cadeia de caracteres de consulta para acrescentar à URL.
Cabeçalhos HTTP	(Opcional) Insira cabeçalhos HTTP para incluir na solicitação HTTP. Você pode adicionar até 20 cabeçalhos para uma solicitação.
Corpo da solicitação	(Opcional) Dependendo do método HTTP, você pode especificar o conteúdo do corpo HTTP. O Teste de Carga do Azure dá suporte aos seguintes formatos: dados brutos, modo de exibição JSON, JavaScript, HTML e XML.

Siga estas etapas para adicionar uma solicitação HTTP a um teste de carga baseado em URL:

Portal do Azure

1. No portal do Azure, acesse o recurso de teste de carga.

2. Na navegação à esquerda, selecione Testes para exibir todos os testes.

3. Na lista, selecione o teste de carga e, em seguida, selecione Editar.

   Selecione um teste de carga baseado em URL na lista e se você habilitou a opção Habilitar configurações avançadas na guia Básico.

4. Vá para a guia Plano de teste e selecione Adicionar solicitação.

   

5. Selecione Adicionar entrada na interface do usuário para inserir os detalhes da solicitação HTTP.

6. Insira os detalhes da solicitação HTTP e selecione Adicionar para adicionar a solicitação ao teste de carga.

   Campo	Descrição
   Formato de solicitação	Selecione Adicionar entrada na interface do usuário para configurar os detalhes da solicitação por meio de campos no portal do Azure.
   Nome da solicitação	Insira um nome exclusivo para a solicitação. Você pode consultar esse nome de solicitação quando definir critérios de falha de teste.
   URL	A URL do ponto de extremidade do aplicativo.
   Método	Selecione um método HTTP na lista. O Teste de Carga do Azure dá suporte a GET, POST, PUT, DELETE, PATCH, HEAD e OPTIONS.
   Parâmetros de consulta	(Opcional) Insira parâmetros de cadeia de caracteres de consulta para acrescentar à URL.
   Cabeçalhos	(Opcional) Insira cabeçalhos HTTP para incluir na solicitação HTTP.
   Corpo	(Opcional) Dependendo do método HTTP, você também pode especificar o conteúdo do corpo HTTP. O Teste de Carga do Azure dá suporte aos seguintes formatos: dados brutos, modo de exibição JSON, JavaScript, HTML e XML.

   

7. Selecione Aplicar para salvar o teste de carga.

Azure Pipelines / GitHub Actions

Ao executar o teste de carga como parte de um fluxo de trabalho de CI/CD, como o GitHub Actions ou o Azure Pipelines, você fornece a lista de solicitações HTTP em um arquivo JSON de solicitações. No arquivo YAML de configuração de teste de carga, você faz referência ao arquivo JSON na propriedade testPlan.

1. Crie um arquivo requests.json para armazenar as solicitações HTTP e cole o seguinte snippet de código no arquivo:

   {
       "version": "1.0",
       "scenarios": {
           "requestGroup1": {
               "requests": [
               ],
               "csvDataSetConfigList": []
           }
       },
       "testSetup": [
           {
               "virtualUsersPerEngine": 50,
               "durationInSeconds": 300,
               "loadType": "Linear",
               "scenario": "requestGroup1",
               "rampUpTimeInSeconds": 60
           }
       ]
   }
   

   Opcionalmente, defina as configurações de carga na propriedade testSetup. Saiba mais sobre como configurar parâmetros de carga para testes de carga baseados em URL.

2. Adicione os detalhes da solicitação HTTP na propriedade requests:

   O snippet de código a seguir mostra um exemplo de uma solicitação HTTP POST. Observe que requestType é URL.

   {
       "requestName": "add",
       "responseVariables": [],
       "queryParameters": [
           {
               "key": "param1",
               "value": "value1"
           }
       ],
       "requestType": "URL",
       "endpoint": "http://www.contoso.com/orders",
       "headers": {
           "api-token": "my-token"
       },
       "body": "{\r\n  \"customer\": \"Contoso\",\r\n  \"items\": {\r\n\t  \"product_id\": 321,\r\n\t  \"count\": 50,\r\n\t  \"amount\": 245.95\r\n  }\r\n}",
       "method": "POST",
       "requestBodyFormat": "JSON"
   },
   

3. Atualize o arquivo YAML de configuração de teste de carga e defina as configurações testType e testPlan:

   Defina a propriedade testType como URL para indicar que você está executando um teste de carga baseado em URL.

   A propriedade testPlan faz referência ao arquivo JSON de solicitações que você criou na etapa anterior.

   O seguinte snippet de código mostra um fragmento de um arquivo de configuração de teste de carga de exemplo:

   displayName: my-first-load-test
   testPlan: requests.json
   description: Web application front-end
   engineInstances: 1
   testId: my-first-load-test
   testType: URL
   splitAllCSVs: False
   failureCriteria: []
   autoStop:
     errorPercentage: 90
     timeWindow: 60
   

4. Salve os dois arquivos e confirme-os no repositório de controle do código-fonte.

Adicionar solicitações usando cURL

Em vez de fornecer os detalhes da solicitação HTTP, você também pode fornecer comandos cURL para as solicitações HTTP em seu teste de carga baseado em URL. O cURL é uma ferramenta de linha de comando e biblioteca para solicitações baseadas em URL.

Siga estas etapas para adicionar uma solicitação HTTP a um teste de carga usando um comando cURL.

Portal do Azure

1. Na lista de testes, selecione o teste de carga e, em seguida, selecione Editar.

   Selecione um teste de carga baseado em URL na lista e se você habilitou a opção Habilitar configurações avançadas na guia Básico.

2. Vá para a guia Plano de teste e selecione Adicionar solicitação.

3. Selecione Adicionar comando cURL para criar uma solicitação HTTP usando cURL.

4. Insira o comando cURL no campo de comando cURL e selecione Adicionar para adicionar a solicitação ao teste de carga.

   O seguinte exemplo usa cURL para executar uma solicitação HTTP GET, especificando um cabeçalho HTTP:

   curl --request GET 'http://www.contoso.com/customers?version=1' --header 'api-token: my-token'
   

   

5. Selecione Aplicar para salvar o teste de carga.

Azure Pipelines / GitHub Actions

Ao executar o teste de carga como parte de um fluxo de trabalho de CI/CD, como o GitHub Actions ou o Azure Pipelines, você fornece a lista de solicitações HTTP em um arquivo JSON de solicitações. No arquivo YAML de configuração de teste de carga, você faz referência ao arquivo JSON na propriedade testPlan.

1. Crie um arquivo JSON para armazenar as solicitações HTTP e colar o seguinte snippet de código no arquivo:

   {
       "version": "1.0",
       "scenarios": {
           "requestGroup1": {
               "requests": [
               ],
               "csvDataSetConfigList": []
           }
       },
       "testSetup": [
           {
               "virtualUsersPerEngine": 50,
               "durationInSeconds": 300,
               "loadType": "Linear",
               "scenario": "requestGroup1",
               "rampUpTimeInSeconds": 60
           }
       ]
   }
   

   Opcionalmente, defina as configurações de carga na propriedade testSetup. Saiba mais sobre como configurar parâmetros de carga para testes de carga baseados em URL.

2. Adicione um comando cURL na propriedade requests:

   O snippet de código a seguir mostra um exemplo de uma solicitação HTTP POST. Observe que requestType é CURL.

   {
       "requestName": "get-customers",
       "responseVariables": [],
       "requestType": "CURL",
       "curlCommand": "curl --request GET 'http://www.contoso.com/customers?version=1' --header 'api-token: my-token'"
   },
   

3. Defina as configurações testType e testPlan no arquivo YAML da configuração de teste de carga para fazer referência ao arquivo JSON de solicitações:

   Defina a propriedade testType como URL para indicar que você está executando um teste de carga baseado em URL.

   A propriedade testPlan faz referência ao arquivo JSON de solicitações que você criou na etapa anterior.

   O seguinte snippet de código mostra um fragmento de um arquivo de configuração de teste de carga de exemplo:

   displayName: my-first-load-test
   testPlan: requests.json
   description: Web application front-end
   engineInstances: 1
   testId: my-first-load-test
   testType: URL
   splitAllCSVs: False
   failureCriteria: []
   autoStop:
     errorPercentage: 90
     timeWindow: 60
   

4. Salve os dois arquivos e confirme-os no repositório de controle do código-fonte.

Usar variáveis em solicitações HTTP

Você pode usar variáveis em sua solicitação HTTP para tornar seus testes mais flexíveis ou evitar incluir segredos em seu plano de teste. Por exemplo, você pode usar uma variável de ambiente com o nome de domínio do ponto de extremidade e, em seguida, usar o nome da variável nas solicitações HTTP individuais. O uso de variáveis torna seu plano de teste mais flexível e fácil de manter.

Com testes de carga baseados em URL no Teste de Carga do Azure, você pode usar variáveis para se referir às seguintes informações:

• Variáveis de ambiente: você pode configurar variáveis de ambiente para o teste de carga
• Segredos: configurar segredos do Azure Key Vault em seu teste de carga
• Valores de um arquivo de entrada CSV: use variáveis para as colunas em um arquivo de entrada CSV e execute uma solicitação para cada linha no arquivo
• Variáveis de resposta: extrair valores de uma solicitação HTTP anterior

A sintaxe para fazer referência a uma variável em uma solicitação é: ${variable-name}.

A captura de tela a seguir mostra como fazer referência a uma variável token em um cabeçalho HTTP usando ${token}.

Observação

Se você especificar certificados, o Teste de Carga do Azure passará automaticamente os certificados em cada solicitação HTTP.

Usar variáveis de resposta para solicitações dependentes

Para criar solicitações HTTP que dependem de uma solicitação anterior, você pode usar variáveis de resposta. Por exemplo, na primeira solicitação, você pode recuperar uma lista de itens de uma API, extrair a ID do primeiro resultado e, em seguida, fazer uma subsequente e passar essa ID como um parâmetro de cadeia de caracteres de consulta.

O Teste de Carga do Azure dá suporte às seguintes opções para extrair valores de uma solicitação HTTP e armazená-los em uma variável:

• JSONPath
• XPath
• Expressão regular

Por exemplo, o exemplo a seguir mostra como usar um XPathExtractor para armazenar o corpo de uma solicitação na variável de resposta token. Em seguida, você pode usar ${token} em outras solicitações HTTP para se referir a esse valor.

"responseVariables": [
    {
        "extractorType": "XPathExtractor",
        "expression": "/note/body",
        "variableName": "token"
    }
]

Conteúdo relacionado

• Configurar um teste de carga com variáveis de ambiente e segredos
• Ler dados de um arquivo CSV de entrada
• Referência YAML da configuração do teste de carga