Manual de Utilização Do Jmeter

Prefeitura de Belo Horizonte
PBH
Empresa de Informtica e Informao de Belo Horizonte
S/A
PRODABEL
Superintendncia de Arquitetura de Sistemas - SAS
Manual de Utilizao do Jmeter
Autor:
Nathan Robert Mariano
Regina Mrcia Rodrigues
Belo Horizonte, Janeiro 2015.
SUMRIO
1.
INTRODUO........................................................................................... 3
2.
Instalao................................................................................................ 3
3.
Utilizao do JMeter................................................................................. 5
3.1
Criando um Plano de Testes...............................................................6
3.1.1
Adicionando usurios..................................................................8
SUMRIO DE FIGURAS
Figura 1 Pgina para Download do JMeter...................................................4
Figura 2 Estrutura de diretrios do JMeter...................................................4
Figura 3 Tela inicial do JMeter......................................................................5
Figura 4 Principais componentes do Plano de Teste.....................................7
1. INTRODUO
Nos dias de hoje o desenvolvimento de aplicaes para internet tem tido um

papel fundamental para a disseminao de conhecimento e informaes diversas. O que
tem gerado uma grande mudana na vida das pessoas e das empresas. A possibilidade de
mltiplos usurios utilizando a aplicao, interfaces com outras aplicaes e acessos
remoto dos mais variados tipos tem dificultado a manuteno da infraestrutura.
Para verificar se a arquitetura desenvolvida capaz de atender a responder a
quantidade de usurios previstos, o tempo de resposta de uma determinada
funcionalidade, entre outras se faz necessrio utilizao de ferramentas que permitam
a simulao do uso e a devida documentao dos resultados obtidos.
Atualmente no contamos com muitos padres. O que temos so tecnologias
isoladas.
Diante deste cenrio uma das ferramentas que se destacam o Apache JMeter
como ferramenta open source para teste de desempenho, principalmente por sua
facilidade de uso e versatilidade.
O Apache JMeter uma ferramenta desktop para testes de desempenho,
desenvolvida utilizando a linguagem Java.
O proposito deste manual ser um recurso para os usurios compreenderem a
instalao e utilizao da ferramenta.
2. INSTALAO
Antes de iniciar a instalao do JMeter necessrio saber os pr-requisitos para
seu funcionamento.
JVM 6 (Java Virtual Machine) ou superior
Na data de publicao desse manual, a verso mais recente a 2.12, que pode
ser
baixada
gratuitamente
no
seguinte
http://jmeter.apache.org/download_jmeter.cgi, como mostra a Figura 1.
link
Figura 1 Pgina para Download do JMeter
O JMeter vem empacotado no formato zip ou tgz (tar). Optamos por fazer o
download no formato zip por ser o mais conhecido.
Descompactar o arquivo no diretrio de preferncia. A verso 2.12, segue a
seguinte estrutura de diretrios como mostra a Figura 2.
Figura 2 Estrutura de diretrios do JMeter
Para executar o JMeter, execute o arquivo JMeter.bat. Esse arquivo encontrado

no diretrio bin. Aps uma breve pausa, ser exibida a janela como mostra a Figura 3.
Figura 3 Tela inicial do JMeter
Os dois itens apresentados, por padro, na rvore so os principais e tem os

seguintes nomes:
Plano de Teste (Test Plan): agrupa itens que representam a simulao de

mltiplos usurios no plano de teste (samplers), alm de configuradores e
controladores de lgica de execuo dos testes;
rea de Trabalho
(Workbench):
utilizada
para armazenamento
temporrio de elementos. Os itens associados a este elemento no so

considerados como parte do Plano de teste.
3. UTILIZAO DO JMETER
3.1
Criando um Plano de Testes

O Plano de Testes o componente bsico para criao de qualquer script
utilizando o JMeter e descreve uma srie de passos que a ferramenta ir executar

quando executar os testes. no Plano de Testes que adicionado os demais
componentes pertinentes aos testes que sero executados. Os principais componentes

so (Figura 4):
Thread Groups (Grupo de Usurios): Representa um grupo de usurio

executando determinada(s) solicitao (es);
Samplers (Testador) Representa uma solicitao, que pode ser HTTP,

FTP, SOAP, JDBC, LDAP e Java;
Logic Controllers (Controlador Lgico): Representam elementos que

ajudam a controlar a execuo das requisies atravs de repetidores,
mdulos, randomizao entre outros;
Listerner (Ouvinte): elementos que visualizam resultados que podem ser

representados por grficos, tabelas, entre outros;
Configuration Elements (Elementos de configurao): Para configurao

padro de dados. Com ele conseguimos, por exemplo, configurar o
mesmo servidor HTTP para uma determinada solicitao;
Assertions (Asseres): elementos que possibilitam adicionar pontos de

afirmao para verificao se determinada resposta est de acordo com
alguma afirmao colocada no elemento Sampler;
Pre-processors (Pr-processadores): elementos que podem produzir

dados para enviar como parte de uma solicitao. Por exemplo, em teste
de uma rotina de incluso de dados no sistema, devemos alternar alguns
dados que so exclusivos por definio. Temos pr-processadores que
so capazes de gerar nome_1, nome_2, nome_3, etc.
Post Processors (Ps-processadores): processadores de resultados de

requisies programadas. Pode extrair uma determinada parte da resposta
do servidor utilizando expresses regulares.
Timer (Temporizador): elementos que permitem um controle avanado

no intervalo de execuo das requisies.
Figura 4 Principais componentes do Plano de Teste
Os componentes apresentados acima devem obedecer a uma determinada

hierarquia no seu plano de teste. Na tabela abaixo so especificados quais componentes
podem ser adicionados em quais componentes:
Componente
Componente que podem ser

adicionados
Plano de Teste
rea
de
Trabalho,
Ouvinte,
Elementos
de
Configurao, Asseres, Pr-processadores, Psprocessadores, Timer.

rea de Trabalho
Controlador Lgico, Testador, Elementos de

Configurao, Elementos que no so de teste.
Grupo de Usurios
Controlador Lgico, Ouvinte, Testador, Timer,

Elementos de Configurao, Pr-processadores,
Ps-processadores.
Testador
Elementos de Configurao, Asseres, Timer,

Pr-processadores, Ps-processadores.
Controlador Lgico
Controlador Lgico, Ouvinte, Testador, Timer,

Elementos de Configurao, Pr-processadores,
Ps-processadores.
Ouvinte
Nenhum
Elementos de Configurao
Nenhum
Asseres
Nenhum
Pr-processadores
Nenhum
Ps-processadores
Nenhum
Timer
Nenhum
3.1.1
Adicionando Grupo de Usurios (Thread Groups)
Para simular as aes dos usurios o JMeter permite a adio de um componente

chamado Thread Groups (Grupo de Usurios). Este componente agrega todos os
demais componentes necessrios para os nossos testes, controlando as aes de usurios
fictcios no sistema. Por esse motivo um dos componentes mais importantes no seu
plano de teste e deve ser configurado com bastante cuidado para que seja criado um
plano de teste que simule de fato a realidade.
Para adicionar um Grupo de Usurios ao Plano de Teste clique em
Editar/Adicionar/Threads (Users)/Grupo de Usurios, como mostra a Figura 5.
Figura 5 Adicionado Grupo de Usurios
Ser exibida a janela Grupo de Usurios, como mostra a Figura 6.
Figura 6 Grupo de Usurios
Preencher os seguintes campos com os dados referentes ao teste:
Nmero de usurios Virtuais (threads): Quantidade de usurios

simultneos
Tempo de Inicializao (Ramp-u Period) (segundos): Intervalo entre os

lanamentos de requisies. O valor informado ser dividido pelo
nmero de requisies, e o resultado ser o intervalo entre cada
requisio. Por exemplo, se informar 10 usurios e o tempo de
inicializao igual a 10 (10 / 10 = 1), teremos um disparo de atividade a
cada segundo.
Contador de Iterao (Loop Count): quantidade de vezes que as threads

sero executadas. Este nmero multiplicado pela quantidade de usurios
o que resulta no total de requisies que sero enviadas;
Infinito (Forever): Se selecionado, ignora o valor configurado no

Contador de Iterao e executa as tarefas at que seja cancelado a
execuo no Plano de Teste;
Agendador (Schedule): Permite que seja feito o agendamento do disparo

do Grupo de Usurios em um determinado dia e horrio.
Voc pode adicionar um ou mais Grupo de Usurios em um Plano de Testes. O

JMeter por padro dispara os Grupos de Usurios em paralelo, ou seja,
simultaneamente. Para alterar este comportamento, v ao Plano de Teste e selecione a
opo Executar Grupos de Usurios consecutivamente.
3.1.2
Adicionando Testadores (Samplers)
Testadores (Samplers) so componentes que faro a requisio fsica para um

determinado servidor. No JMeter existem vrios tipos de testadores para os mais
variados tipos de servios, sendo que, os mais comuns so:
HTTP Request: Utilizado para simular requisies HTTP, fazendo com

que o JMeter atue como um browser;
SOAP/XML-RPC Request: Utilizado para requisies simples via

SOAP. Configurando uma URL e um XML para enviar para o servidor;
FTP Request: Utilizado para efetuar downloads via FTP;
JDBC Request: Utilizado para testes de carga em banco de dados via

JDBC. Pode ser utilizado tambm para tarefas simples como criar
tabelas, excluir dados antes de iniciar os testes.
LDAP Request: Utilizado para testes em servidores LDAP
Java Request: Utilizado para execuo de testes em classes

customizadas. um ponto de extenso do framework JMeter
Para adicionar um Testador (Samplers) clique em Editar/Adicionar/Testador

(Samplers), como mostra a Figura 7.
Figura 7 Adicionando Testador (Samplers)
Utilizaremos como exemplo o uso do Testador o HTTP Request pelo fato de ser
o mais utilizado (Figura 8).
Figura 8 HTTP Request
3.1.3
Adicionando Ouvinte (Listern)
So elementos que capturam os resultados gerados pelo Plano de Teste e permite

visualiz-lo na forma de tabelas, grficos, rvores ou texto simples em alguns arquivos
de log. Eles fornecem acesso virtual aos dados obtidos pelo JMeter quando um caso de
teste executado.
Para adicionar um Ouvinte (Listern) ao Grupo de Usurios clique em
Editar/Adicionar/Ouvinte, como mostra a Figura 9.
Figura 9 Adicionando um Ouvinte
O Jmeter traz os seguintes Ouvintes (Listerns) por padro:
Assertion Results: Quando utilizamos assertions (verificaes nas

respostas dos samplers), este listener apresenta se determinada amostra
est de acordo com a Assertion ou no.
Graph Full Results: No funciona corretamente na verso 1.9 do JMeter,

teoricamente deveria apresentar um grfico de linha completo, com todas
as respostas dos Samplers.
Graph Results: Apresenta um grfico simples e til. Com mdia,

mediano, desvio padro, mnimo e mximo do tempo de resposta das
requisies.
Mailer Visualizer: No disponvel
Simple Data Driver: Listener que tem a capacidade de armazenar os

dados de resposta em um arquivo XML.
Spline Visualizer: Grfico que apresenta uma linha continua com todos
os resultados de tempo de resposta em milisegundos dos testes efetuados.
Composto por 10 pontos, cada ponto contm a mdia 10% das amostras.
Bastante til para analisar impacto de performance e estabilidade.
Aggregate Report: Mostra totalizaes diversas do resultado.
View Results in Table: Resultado individual de cada amostra, indicando

seu tempo de resposta e seu obteve sucesso ou no.
View Results Tree: Apresenta cada requisio e resposta retornada pelo

servidor. Excelente ferramenta para testes de caixa preta.
Cada Ouvinte (Listern) exibe o mesmo resultado de forma diferente. Por

exemplo, a ordem para visualizar o formulrio grfico de dados estatsticos do tempo de
resposta, voc pode querer usar o Report Aggregate. Da mesma forma, para visualizar o
relatrio estatstico dos mesmos dados
em forma de tabela utilizando o Summary
Report ou Aggregate Report. Voc pode tambm escolher a forma em que gostaria de
visualizar as requisies selecionando qualquer um destes ouvintes, mas eles escrevem
os mesmos dados brutos em um arquivo com extenso.jtl.
3.1.4
Adicionando Temporizador (Timer)
Timer um componente opcional na construo do Plano de Teste. Ele faz com

que o Jmeter faa uma pausa por um determinado perodo de tempo entre dois pedidos
sucessivos. Como o Jmeter, por padro, envia um pedido imediatamente aps o outro, o
que pode sobrecarregar o servidor, adicionando um timer ir reduzir o risco de quebrar o
desempenho do servidor. Podemos, por exemplo, estabelecer um intervalo de tempo
padro entre todas as threads do plano de testes, delays aleatrios entre threads e
tambm controle de frequncia de vazo.
Um timer extremamente til se voc estiver testando o software no aspecto
funcional.
Para adicionar um Temporizador (Timer) ao Grupo de Usurios clique em
Editar/Adicionar/Temporizador (Timer), como mostra a Figura 10.
Figura 10 Adicionando Temporizador (Timer)
A seguir lista contendo todos os Timer disponveis no Jmeter:
Constant Timer: Permite que voc estabelea um intervalo em

milissegundos padro entre as threads;
Gaussian Random Timer: Permite intervalos aleatrios entre threads;
Uniform Random Timer: Permite intervalos aleatrios entre threads;
Constant Throughput Timer: Mantm a frequncia de acesso de um

determinado Sampler.
3.1.5
Adicionando Assertions (Afirmao)
Assertions permitem que voc inclua afirmaes no Plano de Teste para verificar
se determinada resposta est de acordo com alguma afirmao colocada no Sampler.
Para adicionar um Temporizador (Timer) ao Grupo de Usurios clique em
Editar/Adicionar/Assero (Assertions), como mostra a Figura 11.
Figura 11 Adicionando Assertions (Assero afirmao)
O Jmeter permite que voc especifique suas afirmaes utilizando Expresses

regulares
3.1.6
Adicionando Pr-processador (Pre Processors)
3.1.7
Adicionando Ps-processador (Post Processors)

Manual de Utilização Do Jmeter

Enviado por

Direitos autorais:

Formatos disponíveis

Manual de Utilização Do Jmeter

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual de Utilização Do Jmeter

Enviado por

Direitos autorais:

Formatos disponíveis

Prefeitura de Belo Horizonte

Manual de Utilizao do Jmeter

Belo Horizonte, Janeiro 2015.

Criando um Plano de Testes...............................................................6

Nos dias de hoje o desenvolvimento de aplicaes para internet tem tido um

JVM 6 (Java Virtual Machine) ou superior

http://jmeter.apache.org/download_jmeter.cgi, como mostra a Figura 1.

Figura 1 Pgina para Download do JMeter

Figura 2 Estrutura de diretrios do JMeter

Para executar o JMeter, execute o arquivo JMeter.bat. Esse arquivo encontrado

Figura 3 Tela inicial do JMeter

Os dois itens apresentados, por padro, na rvore so os principais e tem os

Plano de Teste (Test Plan): agrupa itens que representam a simulao de

temporrio de elementos. Os itens associados a este elemento no so

Criando um Plano de Testes

utilizando o JMeter e descreve uma srie de passos que a ferramenta ir executar

componentes pertinentes aos testes que sero executados. Os principais componentes

Thread Groups (Grupo de Usurios): Representa um grupo de usurio

Samplers (Testador) Representa uma solicitao, que pode ser HTTP,

Logic Controllers (Controlador Lgico): Representam elementos que

Listerner (Ouvinte): elementos que visualizam resultados que podem ser

Configuration Elements (Elementos de configurao): Para configurao

Assertions (Asseres): elementos que possibilitam adicionar pontos de

Pre-processors (Pr-processadores): elementos que podem produzir

Post Processors (Ps-processadores): processadores de resultados de

Timer (Temporizador): elementos que permitem um controle avanado

Figura 4 Principais componentes do Plano de Teste

Os componentes apresentados acima devem obedecer a uma determinada

Componente que podem ser

Configurao, Asseres, Pr-processadores, Psprocessadores, Timer.

Controlador Lgico, Testador, Elementos de

Controlador Lgico, Ouvinte, Testador, Timer,

Elementos de Configurao, Asseres, Timer,

Controlador Lgico, Ouvinte, Testador, Timer,

Adicionando Grupo de Usurios (Thread Groups)

Para simular as aes dos usurios o JMeter permite a adio de um componente

Figura 5 Adicionado Grupo de Usurios

Ser exibida a janela Grupo de Usurios, como mostra a Figura 6.

Figura 6 Grupo de Usurios

Preencher os seguintes campos com os dados referentes ao teste:

Nmero de usurios Virtuais (threads): Quantidade de usurios

Tempo de Inicializao (Ramp-u Period) (segundos): Intervalo entre os

Contador de Iterao (Loop Count): quantidade de vezes que as threads

Infinito (Forever): Se selecionado, ignora o valor configurado no

Agendador (Schedule): Permite que seja feito o agendamento do disparo

Voc pode adicionar um ou mais Grupo de Usurios em um Plano de Testes. O

Adicionando Testadores (Samplers)

Testadores (Samplers) so componentes que faro a requisio fsica para um

HTTP Request: Utilizado para simular requisies HTTP, fazendo com

SOAP/XML-RPC Request: Utilizado para requisies simples via

FTP Request: Utilizado para efetuar downloads via FTP;

JDBC Request: Utilizado para testes de carga em banco de dados via

LDAP Request: Utilizado para testes em servidores LDAP

Java Request: Utilizado para execuo de testes em classes

Para adicionar um Testador (Samplers) clique em Editar/Adicionar/Testador

Figura 7 Adicionando Testador (Samplers)

Figura 8 HTTP Request

Adicionando Ouvinte (Listern)

So elementos que capturam os resultados gerados pelo Plano de Teste e permite