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 ambos os 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, cabeçalhos, 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 o ID do cliente para recuperar os detalhes do pedido do cliente.

Se você usar um teste de carga baseado em URL em seu 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 JMeter. Por exemplo, quando você tem mais de cinco solicitações, se você usa protocolos não-HTTP, ou se você precisa usar plug-ins JMeter.

Pré-requisitos

• Uma conta do Azure com uma subscrição ativa. Se não tiver uma subscrição 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 tabela a seguir 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 suporta GET, POST, PUT, DELETE, PATCH, HEAD e OPTIONS.
Parâmetros de consultas	(Opcional) Insira os parâmetros da cadeia de caracteres de consulta para anexar à URL.
Cabeçalhos de HTTP	(Opcional) Insira cabeçalhos HTTP para incluir na solicitação HTTP. Você pode adicionar até 20 cabeçalhos para uma solicitação.
Corpo do pedido	(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, vá para seu recurso de teste de carga.

2. No painel de navegação esquerdo, selecione Testes para visualizar todos os testes.

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

   Certifique-se de selecionar um teste de carga baseado em URL na lista e de ter ativado Ativar configurações avançadas na guia Noções básicas .

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 do pedido	Selecione Adicionar entrada na interface do usuário para configurar os detalhes da solicitação por meio de campos no portal do Azure.
   Request name (Nome do pedido)	Insira um nome exclusivo para a solicitação. Você pode fazer referência a esse nome de solicitação ao definir critérios de reprovação 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 suporta GET, POST, PUT, DELETE, PATCH, HEAD e OPTIONS.
   Parâmetros de consultas	(Opcional) Insira os parâmetros da cadeia de caracteres de consulta para anexar à 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 / Ações do GitHub

Ao executar o teste de carga como parte de um fluxo de trabalho de CI/CD, como Ações do GitHub ou Pipelines do Azure, 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 testPlan propriedade.

1. Crie um requests.json arquivo para armazenar as solicitações HTTP e cole o seguinte trecho 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 testSetup carregamento na propriedade. 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 requests propriedade:

   O trecho de código a seguir mostra um exemplo de uma solicitação HTTP POST. Observe que o 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 testType configurações e testPlan :

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

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

   O trecho de código a seguir 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 ambos os arquivos e confirme-os em seu 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. 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.

   Certifique-se de selecionar um teste de carga baseado em URL na lista e de ter ativado Ativar configurações avançadas na guia Noções básicas .

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. Digite o comando cURL no campo de comando cURL e selecione Adicionar para adicionar a solicitação ao seu teste de carga.

   O exemplo a seguir 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 / Ações do GitHub

Ao executar o teste de carga como parte de um fluxo de trabalho de CI/CD, como Ações do GitHub ou Pipelines do Azure, 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 testPlan propriedade.

1. Crie um arquivo JSON para armazenar as solicitações HTTP e cole o seguinte trecho 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 testSetup carregamento na propriedade. Saiba mais sobre como configurar parâmetros de carga para testes de carga baseados em URL.

2. Adicione um comando cURL na requests propriedade:

   O trecho de código a seguir mostra um exemplo de uma solicitação HTTP POST. Observe que o 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 testType configurações e testPlan no arquivo YAML de configuração de teste de carga para fazer referência ao arquivo JSON de solicitações:

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

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

   O trecho de código a seguir 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 ambos os arquivos e confirme-os em seu 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 para evitar a inclusão de segredos em seu plano de teste. Por exemplo, você pode usar uma variável de ambiente com o nome de domínio do seu 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 sustentável.

Com testes de carga baseados em URL no Teste de Carga do Azure, você pode usar variáveis para fazer referência à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 no 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 se referir a uma variável em uma solicitação é: ${variable-name}.

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

Nota

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 depent em 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
• Regular expression

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

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

Conteúdos relacionados

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