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.
- Instale o Java e confira com
java -version. - Baixe a distribuição binária no site oficial.
- Descompacte e acesse a pasta
bin. - Execute
jmeter.batno Windows ou./jmeterno 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 ReportA 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
5Configure 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.jtlExecutar e gerar relatório HTML
jmeter -n -t teste-performance.jmx -l resultados.jtl -e -o relatorioGerar 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
.jmxe 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.