Ler dados de um arquivo CSV no JMeter com o Teste de Carga do Azure

Neste artigo, você aprenderá a ler dados de um arquivo CSV (valores separados por vírgula) no JMeter com o Teste de Carga do Azure. Use dados de um arquivo CSV externo para tornar seu script de teste JMeter configurável. Por exemplo, você pode iterar sobre todos os clientes em um arquivo CSV para passar os detalhes do cliente para a solicitação de API.

No JMeter, você pode usar o elemento CSV Data set Config em seu script de teste para ler dados de um arquivo CSV.

Para ler dados de um arquivo externo no Teste de Carga do Azure, você precisa carregar o arquivo externo junto com o script de teste JMeter em seu teste de carga. Se você dimensionar seu teste em várias instâncias paralelas do mecanismo de teste, poderá optar por dividir os dados de entrada uniformemente entre essas instâncias.

Comece clonando ou baixando o projeto de amostras do GitHub.

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.
• Um script de teste Apache JMeter (JMX).
• (Opcional) Apache JMeter GUI para criar seu script de teste. Para instalar o Apache JMeter, consulte Introdução ao Apache JMeter.

Atualize seu script JMeter para ler dados CSV

Nesta seção, você configura o script Apache JMeter para fazer referência ao arquivo CSV externo. Você usa um elemento CSV Data set Config para ler dados de um arquivo CSV.

Importante

O Teste de Carga do Azure carrega o arquivo JMX e todos os arquivos relacionados em uma única pasta. Quando você faz referência a um arquivo externo no script JMeter, verifique se você não tem referências de caminho de arquivo no script de teste.

Modifique o script JMeter usando a GUI do Apache JMeter:

1. Selecione o elemento CSV Data set Config no script de teste.

2. Atualize as informações do nome do arquivo e remova qualquer referência de caminho de arquivo .

3. Opcionalmente, insira os nomes de campo CSV em Nomes de variáveis, quando você dividir o arquivo CSV entre mecanismos de teste.

   O Teste de Carga do Azure não preserva a linha de cabeçalho ao dividir seu arquivo CSV. Forneça os nomes das variáveis no elemento CSV Data set Config em vez de usar uma linha de cabeçalho.

   

4. Repita as etapas anteriores para cada elemento CSV Data set Config no script.

5. Salve o script JMeter e carregue o script para seu teste de carga.

Carregue o arquivo CSV para o teste de carga

Quando você fizer referência a arquivos externos do seu script de teste, certifique-se de carregar todos esses arquivos junto com o script de teste JMeter. Quando o teste de carga é iniciado, o Teste de Carga do Azure copia todos os arquivos para uma única pasta em cada uma das instâncias dos mecanismos de teste.

Importante

O Teste de Carga do Azure não preserva a linha de cabeçalho ao dividir seu arquivo CSV. Antes de adicionar o arquivo CSV ao teste de carga, remova a linha de cabeçalho do arquivo.

Portal do Azure

Para adicionar um arquivo CSV ao seu teste de carga usando o portal do Azure:

1. No portal do Azure, vá para seu recurso de teste de carga do Azure.

2. No painel esquerdo, selecione Testes para exibir uma lista de testes.

3. Selecione seu teste na lista marcando a caixa de seleção e, em seguida, selecione Editar.

   

4. Na guia Plano de teste, selecione o arquivo CSV do seu computador e selecione Carregar para carregar o arquivo no Azure.

   Se você estiver usando um teste de carga baseado em URL, poderá inserir os nomes das variáveis como uma lista separada por vírgulas na coluna Variáveis .

   

   Se o tamanho do arquivo CSV for maior que 50 MB, compacte o arquivo. O tamanho do ficheiro zip deve ser inferior a 50 MB. O Teste de Carga do Azure descompacta automaticamente o arquivo durante a execução do teste. Apenas cinco artefatos zip são permitidos com um máximo de 1000 arquivos em cada zip e um tamanho total descompactado de 1 GB.

5. Selecione Aplicar para modificar o teste e usar a nova configuração quando executá-lo novamente.

Gorjeta

Se você estiver usando um teste de carga baseado em URL, poderá fazer referência aos valores do arquivo de dados de entrada CSV nas solicitações HTTP usando a $(variable) sintaxe.

Azure Pipelines / Ações do GitHub

Se você executar um teste de carga em seu fluxo de trabalho de CI/CD, poderá adicionar um arquivo CSV ao arquivo YAML de configuração de teste. Para obter mais informações sobre como executar um teste de carga em um fluxo de trabalho de CI/CD, consulte como adicionar teste de carga ao CI/CD.

Para adicionar um arquivo CSV ao seu teste de carga:

1. Confirme o arquivo CSV no repositório de controle do código-fonte que contém o arquivo JMX e o arquivo de configuração de teste YAML. Se o tamanho do arquivo CSV for maior que 50 MB, compacte o arquivo. O tamanho do ficheiro zip deve ser inferior a 50 MB. O Teste de Carga do Azure descompacta automaticamente o arquivo durante a execução do teste. Apenas cinco artefatos zip são permitidos com um máximo de 1000 arquivos em cada zip e um tamanho total descompactado de 1 GB.

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

3. Adicione o arquivo CSV à configurationFiles configuração. Você pode usar curingas ou especificar vários arquivos individuais.

   testName: MyTest
   testPlan: SampleApp.jmx
   description: Run a load test for my sample web app
   engineInstances: 1
   configurationFiles:
   - search-params.csv
   

   Nota

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

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

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

Dividir dados de entrada CSV entre mecanismos de teste

Por padrão, o Teste de Carga do Azure copia e processa seus arquivos de entrada sem modificações em todas as instâncias do mecanismo de teste. Por padrão, cada mecanismo de teste processa todo o arquivo CSV. Como alternativa, o Teste de Carga do Azure permite dividir os dados de entrada CSV uniformemente em todas as instâncias do mecanismo. Se você tiver vários arquivos CSV, cada arquivo será dividido uniformemente.

Por exemplo, se você tiver um arquivo de entrada CSV de cliente grande e o teste de carga for executado em 10 mecanismos de teste paralelos, cada instância processará 1/10 dos clientes.

Importante

O Teste de Carga do Azure não preserva a linha de cabeçalho ao dividir seu arquivo CSV.

1. Configure seu script JMeter para usar nomes de variáveis ao ler o arquivo CSV.
2. Remova a linha de cabeçalho do arquivo CSV antes de adicioná-la ao teste de carga.

Para configurar seu teste de carga para dividir arquivos CSV de entrada:

Portal do Azure

1. Vá para a guia Plano de teste para seu teste de carga.

2. Selecione Dividir CSV uniformemente entre os mecanismos de teste.

   

3. Selecione Aplicar para confirmar as alterações de configuração.

   Na próxima vez que você executar o teste, o Teste de Carga do Azure dividirá e processará o arquivo CSV uniformemente entre os mecanismos de teste.

Azure Pipelines / Ações do GitHub

1. Abra seu arquivo de configuração de teste YAML no Visual Studio Code ou no editor de sua escolha.

2. Adicione a splitAllCSVs configuração e defina seu valor como True.

   testName: MyTest
   testPlan: SampleApp.jmx
   description: Run a load test for my sample web app
   engineInstances: 1
   configurationFiles:
     - customers.csv
   splitAllCSVs: True
   

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

   Na próxima vez que você executar o teste, o Teste de Carga do Azure dividirá e processará o arquivo CSV uniformemente entre os mecanismos de teste.

Resolução de problemas

O status do teste falhou e o log de teste File {my-filename} must exist and be readable

Quando o teste de carga for concluído com o status Falha, você poderá baixar os logs de teste.

Quando você recebe uma mensagem File {my-filename} must exist and be readable de erro no log de teste, o arquivo CSV de entrada não pôde ser encontrado ao executar o script JMeter.

O Teste de Carga do Azure armazena todos os arquivos de entrada junto com o script JMeter. Ao fazer referência ao arquivo CSV de entrada no script JMeter, certifique-se de não incluir o caminho do arquivo, mas use apenas o nome do arquivo.

O trecho de código a seguir mostra uma extração de um arquivo JMeter que usa um CSVDataSet elemento para ler o arquivo de entrada. Observe que o não inclui o filename caminho do arquivo.

<CSVDataSet guiclass="TestBeanGUI" testclass="CSVDataSet" testname="Websites CSV" enabled="true">
    <stringProp name="filename">websites.csv</stringProp>
    <stringProp name="fileEncoding">UTF-8</stringProp>
    <stringProp name="variableNames">CustomerId,CustomerName,Url</stringProp>
    <boolProp name="ignoreFirstLine">true</boolProp>
    <stringProp name="delimiter">,</stringProp>
    <boolProp name="quotedData">false</boolProp>
    <boolProp name="recycle">false</boolProp>
    <boolProp name="stopThread">true</boolProp>
    <stringProp name="shareMode">shareMode.all</stringProp>
    <stringProp name="TestPlan.comments">Read all records from the CSV file -  stop thread at end of file</stringProp>
</CSVDataSet>

Conteúdos relacionados

• Configure um teste de carga com variáveis de ambiente e segredos.