Ingrid Lorrane← Laboratório de QA
Laboratório de QA · Testes de performance

Testes de Performance com Apache JMeter

Conceitos, execução e análise de resultados para avaliar o desempenho de aplicações.

Por Ingrid Lorrane · Artigo técnico

1. Introdução

Garantir que uma funcionalidade esteja de acordo com os requisitos não significa, necessariamente, garantir que ela apresente um desempenho adequado em condições reais de utilização.

Um sistema pode funcionar perfeitamente durante os testes funcionais e, ainda assim, apresentar problemas quando submetido a um volume elevado de requisições, acessos simultâneos ou processamento contínuo de informações.

Neste artigo, compartilho conceitos e práticas relacionados à utilização do Apache JMeter, desde o planejamento até a interpretação dos resultados. O objetivo é avaliar o comportamento de uma aplicação, identificar riscos e fornecer informações que auxiliem na tomada de decisões.

2. O que são testes de performance?

Os testes de performance, também conhecidos como testes de desempenho, avaliam o comportamento de um sistema sob determinadas condições de utilização. Permitem analisar tempo de resposta, capacidade de processamento, estabilidade, escalabilidade, consumo de recursos e recuperação após sobrecarga.

Uma funcionalidade pode retornar o resultado esperado e, mesmo assim, apresentar um problema de qualidade caso o tempo necessário para concluir a operação seja incompatível com as necessidades do negócio.

3. Tipos de testes de performance

Tipo Objetivo Exemplo
Carga (Load) Avaliar a carga esperada 200 usuários no horário de pico
Estresse (Stress) Identificar limites além da carga esperada Aumentar progressivamente a carga até ocorrer degradação
Pico (Spike) Avaliar aumentos repentinos Início de uma campanha promocional
Resistência (Soak) Identificar degradação ao longo do tempo Carga constante durante oito horas

A escolha depende do objetivo da avaliação e das características da aplicação.

4. Conhecendo o Apache JMeter

O Apache JMeter é uma ferramenta gratuita e de código aberto, desenvolvida em Java e mantida pela Apache Software Foundation. Permite testar aplicações web, APIs REST e SOAP, bancos de dados via JDBC, mensageria, FTP e TCP, além de validar respostas, gerar relatórios, executar testes distribuídos e integrar pipelines de CI/CD.

O JMeter não é um navegador. Ele atua no nível dos protocolos, não renderiza páginas nem executa o JavaScript da aplicação como um navegador convencional. Para avaliar a renderização do frontend, ferramentas como Lighthouse podem complementar a análise.

5. Comunicação entre cliente e servidor

Uma analogia que facilita o entendimento é imaginar um restaurante.

Conceito Analogia
Cliente Pessoa que realiza o pedido
Requisição (Request) Pedido ao garçom
Servidor Cozinha
Resposta (Response) Prato entregue
Tempo de resposta Tempo de espera pelo pedido
API Cardápio que define o que pode ser solicitado

Métodos HTTP

Método Finalidade
GET Consultar informações
POST Enviar informações ou solicitar processamento
PUT Substituir um recurso
PATCH Alterar parcialmente um recurso
DELETE Excluir um recurso

Códigos de resposta HTTP

Código Significado
200 Sucesso
201 Recurso criado
400 Requisição inválida
401 Autenticação ausente ou inválida
403 Acesso proibido
404 Recurso não encontrado
500 Erro interno do servidor
503 Serviço indisponível

Um código HTTP de sucesso não garante, isoladamente, que o conteúdo retornado esteja correto.

6. Planejamento de um teste de performance

Um dos pontos mais importantes acontece antes mesmo de abrir o JMeter: o planejamento. Executar milhares de requisições sem conhecer o objetivo pode gerar muitas informações, mas poucas conclusões relevantes.

Defina objetivo, funcionalidades, ambiente, usuários virtuais, volumetria, duração, crescimento da carga, massa de dados, critérios de aceite, monitoramento e condições de interrupção.

Exemplo de planejamento

Parâmetro Configuração ilustrativa
Objetivo Avaliar consulta de produtos
Tipo Carga
Usuários virtuais 100
Ramp-up 60 segundos
Duração 10 minutos
Critério de resposta P95 de até 2 segundos
Taxa de erro Inferior a 1%
Ambiente Homologação

Não existe um tempo de resposta ideal aplicável a todos os sistemas. Os critérios devem refletir os requisitos não funcionais e as necessidades do negócio.

7. Principais conceitos e métricas

Threads, ramp-up e loop count

Threads representam usuários virtuais. Cem threads não significam necessariamente cem requisições simultâneas. Ramp-up define o período de inicialização dos usuários. Loop Count determina quantas vezes cada usuário executará o fluxo.

Usuários Ramp-up Taxa média de início
10 10 s 1 usuário/s
100 50 s 2 usuários/s
100 100 s 1 usuário/s
500 100 s 5 usuários/s

Com 10 usuários, cinco repetições e uma requisição por repetição, serão realizadas 50 requisições se a execução terminar conforme planejado.

Tempo de resposta e latência

O tempo de resposta vai do início da requisição até o recebimento completo da resposta. A latência, no JMeter, mede até o recebimento inicial da resposta.

Milissegundos Segundos
100 0,1
500 0,5
1.000 1
2.000 2
10.000 10

Throughput, taxa de erro e think time

Throughput é a quantidade de amostras por unidade de tempo. Mil requisições em 20 segundos correspondem a 50 requisições/s. A taxa de erro é o percentual de amostras malsucedidas: 20 falhas em 1.000 amostras representam 2%. Think time é a pausa entre ações, representada por timers.

Percentis

Métrica Interpretação
P50 50% das amostras em tempo igual ou inferior ao valor
P90 90% das amostras em tempo igual ou inferior ao valor
P95 95% das amostras em tempo igual ou inferior ao valor
P99 99% das amostras em tempo igual ou inferior ao valor

A média pode ocultar lentidão enfrentada por uma parcela dos usuários.

APDEX

O Application Performance Index classifica amostras como satisfeitas, toleráveis ou frustrantes conforme limites configurados. Varia de 0 a 1 e não representa uma pesquisa direta de satisfação.

8. Instalação e configuração

Os exemplos utilizam JMeter 5.6.3 e Java 17.

  1. Instale o Java e confira com java -version.
  2. Baixe a distribuição binária no site oficial.
  3. Descompacte e acesse a pasta bin.
  4. Execute jmeter.bat no Windows ou ./jmeter no Linux/macOS.

Caso o Java não seja reconhecido, confira JAVA_HOME e PATH.

Configuração de memória

Exemplo para Windows (CMD):

set "HEAP=-Xms1g -Xmx1g -XX:MaxMetaspaceSize=256m"
jmeter.bat

-Xms define o heap inicial, -Xmx o máximo e MaxMetaspaceSize limita o Metaspace. Ajuste conforme os recursos disponíveis. Aumentar a memória do JMeter não melhora diretamente o desempenho da aplicação testada.

9. Estrutura de um plano de teste

Os planos são armazenados em arquivos .jmx e organizados hierarquicamente.

Componente Responsabilidade
Test Plan Estrutura principal
Thread Group Usuários e execução
Sampler Requisições
Config Element Parâmetros e dados
Timer Intervalos
Assertion Validação
Pre-Processor Preparação antes da requisição
Post-Processor Extração ou processamento posterior
Logic Controller Fluxo
Listener Visualização ou armazenamento
Test Plan
└── Thread Group
    ├── HTTP Request Defaults
    ├── HTTP Header Manager
    ├── Constant Timer
    ├── HTTP Request
    │   ├── Response Assertion
    │   └── JSON Extractor
    └── Summary Report

A posição dos componentes influencia seu escopo. Uma asserção diretamente abaixo de uma requisição aplica-se àquela requisição.

10. Implementação de um teste na prática

Considere uma API fictícia de consulta de produtos em http://localhost:8080/api/produtos/1. É necessário ter uma API local em execução nesse endereço; o artigo não fornece o servidor.

Thread Group

Campo Valor
Number of Threads 5
Ramp-up Period 5 segundos
Loop Count 10

HTTP Request

Campo Valor
Name Consultar produto
Protocol http
Server Name localhost
Port Number 8080
Method GET
Path /api/produtos/1

Adicione uma Response Assertion para validar o código 200 e, quando possível, o conteúdo esperado. Configure um Constant Timer de 1.000 ms. Utilize View Results Tree, Summary Report ou Aggregate Report durante a validação inicial. São esperadas 50 amostras da requisição principal se o fluxo for concluído.

Desabilite o View Results Tree durante testes de carga significativos para reduzir o consumo de recursos.

11. Parametrização e correlação

O CSV Data Set Config permite utilizar dados diferentes durante a execução. Crie um arquivo produtos.csv com os identificadores:

1
2
3
4
5

Configure a variável id, sem cabeçalho, e utilize /api/produtos/${id} no caminho da requisição. Ajuste o compartilhamento e a reutilização dos dados conforme o cenário.

O JSON Extractor permite extrair tokens, identificadores e outros valores da resposta para utilização em requisições posteriores. Essa reutilização dinâmica é conhecida como correlação.

12. Execução via linha de comando

A interface gráfica é útil para construir e validar planos. Para gerar carga, prefira o modo não gráfico.

Executar e salvar resultados

jmeter -n -t teste-performance.jmx -l resultados.jtl

Executar e gerar relatório HTML

jmeter -n -t teste-performance.jmx -l resultados.jtl -e -o relatorio

Gerar relatório de resultados existentes

jmeter -g resultados.jtl -o relatorio
Parâmetro Finalidade
-n Modo não gráfico
-t Plano de teste
-l Arquivo de resultados
-e Geração de relatório após execução
-o Diretório de saída
-g Relatório de resultados existentes
-j Log do JMeter
-J Propriedades da execução

O diretório do relatório deve estar vazio ou não existir. Use arquivos de resultados distintos para cada execução. No Windows, utilize jmeter.bat se necessário.

13. Análise e interpretação dos resultados

O relatório HTML apresenta estatísticas, percentis, throughput, taxa de erro, APDEX, usuários ativos e gráficos de distribuição dos tempos de resposta.

Comparação de cenários

Indicador Cenário A Cenário B
Usuários 50 200
Média 250 ms 1.200 ms
P95 450 ms 3.500 ms
P99 800 ms 7.000 ms
Throughput 40 req/s 90 req/s
Erro 0% 4%

Dados fictícios, exclusivamente ilustrativos.

No cenário B, apesar do aumento de throughput, os tempos de resposta e a taxa de erro pioraram. Considerando P95 de até 2 segundos e erro inferior a 1%, o cenário B não atende aos critérios. A causa exige investigação complementar.

Por que não analisar apenas a média?

Imagine 95 requisições concluídas em 100 ms e cinco em 4.000 ms. A média será de 295 ms, embora uma parcela das requisições tenha levado quatro segundos. Os percentis superiores ajudam a revelar esse comportamento.

14. Identificação de gargalos

Investigue consultas de banco de dados, CPU, memória, pools de conexão, serviços externos, infraestrutura, rede, threads, bloqueios e a própria máquina geradora de carga.

O JMeter identifica sintomas, mas não determina sozinho a causa da degradação. Monitore a aplicação, a infraestrutura e o gerador de carga. Grafana e InfluxDB podem complementar a análise.

15. Outros cenários de utilização

Disponibilidade

Configure requisições periódicas, por exemplo, a cada 30 segundos durante dez minutos, com Loop Controller, HTTP Request e Flow Control Action. Isso permite observar falhas e variações durante o período, mas não substitui monitoramento contínuo.

Banco de dados

Para PostgreSQL, obtenha o driver JDBC compatível, copie-o para lib, reinicie o JMeter, configure JDBC Connection Configuration e adicione JDBC Request.

SELECT id, nome FROM produtos WHERE id = 1;

O teste direto no banco não representa necessariamente o desempenho de todas as camadas da aplicação.

Envio de arquivos

Uma API de upload de documentos pode ser avaliada considerando quantidade de usuários, tamanho e formato dos arquivos, processamento, armazenamento, recursos e erros. Utilize massa sintética, sem informações pessoais ou confidenciais.

16. Boas práticas

  • Defina critérios de aceite antes da execução.
  • Utilize ambientes autorizados e valide o plano com poucos usuários.
  • Execute carga em modo não gráfico e desabilite listeners pesados.
  • Valide respostas com asserções e represente o comportamento real com timers e dados parametrizados.
  • Monitore a aplicação e o gerador de carga.
  • Registre configurações, versione arquivos .jmx e proteja credenciais.
  • Prefira Groovy para scripts JSR223.
  • Repita testes quando necessário e não conclua apenas pela média.

Nunca execute testes de carga ou estresse em aplicações de terceiros sem autorização expressa.

17. Documentação dos resultados

A documentação permite comparar execuções, acompanhar a evolução do desempenho e identificar regressões.

Título:
Objetivo:
Ambiente:
Versão da aplicação:
Versão do JMeter:
Tipo de teste:
Funcionalidade avaliada:
Quantidade de usuários virtuais:
Ramp-up:
Duração:
Total de requisições:
Tempo médio de resposta:
Tempo mínimo:
Tempo máximo:
Percentil 90:
Percentil 95:
Percentil 99:
Throughput:
Taxa de erro:
Critérios de aceite:
Resultado obtido:
Análise dos resultados:
Evidências:
Conclusão:

18. Considerações finais

Conhecer a ferramenta não é suficiente. É necessário compreender o comportamento esperado da aplicação, definir estratégias, estabelecer critérios de aceite e interpretar os resultados considerando o contexto do sistema.

Na minha visão, o valor de um teste de performance não está na quantidade de requisições executadas, mas na capacidade de transformar os resultados em informações relevantes para a equipe.

Identificar uma lentidão é importante. Compreender seu impacto, investigar suas possíveis causas e contribuir para a melhoria da aplicação é o que torna essa atividade relevante para a qualidade de software.

Referências

← Voltar ao laboratório