Usar propriedades de usuário do JMeter com o Teste de Carga do Azure

Neste artigo, saiba como configurar e usar as propriedades do usuário do Apache JMeter com o Teste de Carga do Azure. Com as propriedades do usuário, você pode tornar seu teste configurável mantendo as configurações de teste fora do script de teste do JMeter. Os casos de uso para propriedades do usuário incluem:

• Você deseja usar o script de teste JMX em vários ambientes de implantação com pontos de extremidade de aplicativo diferentes.
• O script de teste precisa acomodar vários padrões de carga, como testes de fumaça, pico de carga ou testes de imersão.
• Você deseja substituir o comportamento padrão do JMeter definindo as configurações do JMeter, como o formato de arquivo de resultados.

O Teste de Carga do Azure dá suporte às propriedades padrão do Apache JMeter e permite que você carregue um arquivo de propriedades do usuário. Você pode configurar um arquivo de propriedades de usuário por teste de carga.

Como alternativa, você também pode usar variáveis de ambiente e segredos no Teste de Carga do Azure para tornar seus testes configuráveis.

Observação

O Teste de Carga do Azure substitui propriedades específicas do JMeter e ignora todos os valores especificados para essas propriedades. Saiba mais sobre a lista de propriedades do JMeter que o Azure Load Testing substitui.

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. Se precisar criar um recurso de Teste de Carga do Azure, consulte o início rápido Criar e executar um teste de carga.

Adicionar um arquivo de propriedades do usuário JMeter ao teste de carga

Você pode definir as propriedades do usuário para o script de teste do JMeter carregando um arquivo .properties no teste de carga. O Teste de Carga do Azure dá suporte a um único arquivo de propriedades JMeter por teste de carga. Arquivos de propriedade adicionais são ignorados.

O snippet de código a seguir mostra um arquivo de propriedades de usuário de exemplo que define três propriedades de usuário e define a jmeter.save.saveservice.thread_name configuração:

# peak-load.properties
# User properties for testing peak load
threadCount=250
rampUpSeconds=30
durationSeconds=600

# Override default JMeter properties
jmeter.save.saveservice.thread_name=false

Portal do Azure

Para adicionar um arquivo de propriedades de usuário ao teste de carga usando o portal do Azure, siga estas etapas:

1. No portal do Azure, acesse seu recurso de Teste de Carga do Azure.

2. No painel esquerdo, selecione Testes para visualizar a lista de testes.

3. Selecione o teste na lista selecionando a caixa de seleção e, em seguida, selecione Editar. Como alternativa, selecione Criar teste para criar um novo teste de carga.

4. Clique na guia Plano de teste.

5. Selecione o arquivo de propriedades em seu computador e selecione Carregar para carregar o arquivo no Azure.

   

6. Selecione as propriedades do usuário na lista suspensa Relevância do arquivo.

   

   Você pode selecionar apenas um arquivo como um arquivo de propriedades do usuário para um teste de carga.

7. Selecione Aplicar para modificar o teste ou Examinar + criar e, em seguida, Criar para criar o novo teste.

Azure Pipelines/GitHub Actions

Se você executar um teste de carga no fluxo de trabalho de CI/CD, adicione o arquivo de propriedades do usuário ao repositório de controle do código-fonte. Em seguida, especifique esse arquivo de propriedades no arquivo YAML de configuração de teste de carga.

Para obter mais informações sobre como executar um teste de carga em um fluxo de trabalho de CI/CD, consulte o início rápido do teste de regressão automatizado.

Para adicionar um arquivo de propriedades do usuário ao teste de carga, siga estas etapas:

1. Adicione o arquivo .properties ao repositório de controle do código-fonte.

2. Abra o arquivo de configuração de teste yaml no Visual Studio Code ou no editor de sua escolha.

3. Especifique o arquivo .properties na properties.userPropertyFile configuração.

   testName: MyTest
   testPlan: SampleApp.jmx
   description: Configure a load test with peak load properties.
   engineInstances: 1
   properties:
     userPropertyFile: peak-load.properties
   configurationFiles:
     - input-data.csv
   

   Observação

   Se você armazenar o arquivo de propriedades em uma pasta separada, especifique o arquivo com um nome de caminho relativo. Para obter mais informações, consulte a sintaxe do YAML de configuração de teste.

4. Salve o arquivo de configuração YAML e confirme-o no repositório do controle do código-fonte.

   Na próxima vez que o fluxo de trabalho de CI/CD for executado, ele usará a configuração atualizada.

Propriedades de referência no JMeter

O Teste de Carga do Azure dá suporte à funcionalidade interna do Apache JMeter para fazer referência às propriedades do usuário no JMX (script de teste do JMeter). Você pode usar as funções __property ou __P para recuperar os valores de propriedade do arquivo de propriedade que você carregou anteriormente.

O snippet de código a seguir mostra um exemplo de como referenciar propriedades em um arquivo JMX:

<ThreadGroup guiclass="ThreadGroupGui" testclass="ThreadGroup" testname="Test home page" enabled="true">
<stringProp name="ThreadGroup.on_sample_error">continue</stringProp>
<elementProp name="ThreadGroup.main_controller" elementType="LoopController" guiclass="LoopControlPanel" testclass="LoopController" testname="Loop Controller" enabled="true">
    <boolProp name="LoopController.continue_forever">false</boolProp>
    <intProp name="LoopController.loops">-1</intProp>
</elementProp>
<stringProp name="ThreadGroup.num_threads">${__P(threadCount,1)}</stringProp>
<stringProp name="ThreadGroup.ramp_time">${__P(rampUpSeconds,1)}</stringProp>
<boolProp name="ThreadGroup.scheduler">true</boolProp>
<stringProp name="ThreadGroup.duration">${__P(durationSeconds,30)}</stringProp>
<stringProp name="ThreadGroup.delay"></stringProp>
<boolProp name="ThreadGroup.same_user_on_next_iteration">true</boolProp>
</ThreadGroup>

Como alternativa, você também especifica propriedades na interface do usuário do JMeter. A imagem a seguir mostra como usar propriedades para configurar um grupo de threads JMeter:

Você pode baixar os logs de erros do JMeter para solucionar erros durante o teste de carga.

Próximas etapas

• Saiba mais sobre as propriedades do JMeter que o Teste de Carga do Azure substitui.
• Saiba mais sobre como parametrizar um teste de carga usando variáveis de ambiente e segredos.
• Saiba mais sobre como diagnosticar testes de carga com falha.