14. Gerando o Painel de Relatório ¶

14.1 Visão geral ¶

O gerador de painel é uma extensão modular do JMeter. Seu comportamento padrão é ler e processar amostras de arquivos CSV para gerar arquivos HTML contendo visualizações de gráficos. Pode gerar o relatório ao final de um teste de carga ou sob demanda.

Este relatório fornece as seguintes métricas:

• Tabela APDEX (Application Performance Index) que calcula para cada transação o APDEX com base em valores configuráveis ​​para limites tolerados e satisfeitos
• Um gráfico de resumo de solicitação mostrando a porcentagem de solicitações bem-sucedidas e com falha (os resultados da amostra do Transaction Controller não são levados em consideração):

  

• Uma tabela de estatísticas fornecendo em uma tabela um resumo de todas as métricas por transação, incluindo 3 percentis configuráveis:

  

• Uma tabela de erros que fornece um resumo de todos os erros e sua proporção no total de solicitações:

  

• Uma tabela dos 5 principais erros por amostrador fornecendo para cada amostrador (excluindo o controlador de transação por padrão) os 5 principais erros:

  

• Gráfico com zoom onde você pode marcar/desmarcar cada transação para mostrá-la/ocultá-la para:
  • Tempos de resposta ao longo do tempo (inclui resultados de amostra do controlador de transação):

    

  • Tempos de resposta Percentis ao longo do tempo (somente respostas bem-sucedidas):

    

  • Tópicos ativos ao longo do tempo:

    

  • Taxa de transferência de bytes ao longo do tempo (ignora resultados de amostra do controlador de transação):

    

  • Latências ao longo do tempo (inclui resultados de amostra do controlador de transação):

    

  • Conectar ao longo do tempo (inclui resultados de amostra do controlador de transação):

    

  • Hits por segundo (ignora resultados de amostra do Transaction Controller):

    

  • Códigos de resposta por segundo (ignora resultados de amostra do Transaction Controller):

    

  • Transações por segundo (inclui resultados de amostra do controlador de transações):

    

  • Tempo de resposta vs solicitação por segundo (ignora resultados da amostra do controlador de transação):

    

  • Latência x solicitação por segundo (ignora resultados de amostra do controlador de transação):

    

  • Visão geral do tempo de resposta (exclui resultados de amostra do controlador de transação):

    

  • Percentis de tempos de resposta (inclui resultados de amostra do controlador de transação):

    

  • Times vs Threads (inclui resultados de amostra do controlador de transação):

    

    No modo distribuído, este gráfico mostra em um eixo horizontal o número de threads para 1 servidor. É uma limitação atual
  • Distribuição do tempo de resposta (inclui resultados de amostra do controlador de transação):

    

14.2 Configurando a Geração do Painel ¶

A geração do painel usa as propriedades do JMeter para customizar o relatório. Algumas propriedades são usadas para configurações gerais e outras são usadas para uma configuração de gráfico específica ou configuração de exportador.

jmeter.reportgenerator.exporter.html.series_filter=^(Search|Order)(-success|-failure)?$

jmeter.save.saveservice.bytes = true
# Disponível apenas com HttpClient4
#jmeter.save.saveservice.sent_bytes=true
jmeter.save.saveservice.label = true
jmeter.save.saveservice.latency = true
jmeter.save.saveservice.response_code = true
jmeter.save.saveservice.response_message = true
jmeter.save.saveservice.successful = true
jmeter.save.saveservice.thread_counts = true
jmeter.save.saveservice.thread_name = true
jmeter.save.saveservice.time = true
jmeter.save.saveservice.connect_time = true
jmeter.save.saveservice.assertion_results_failure_message = true
# o formato de carimbo de data/hora deve incluir a hora e a data.
# Por exemplo, o padrão, que é milissegundos desde a época:
jmeter.save.saveservice.timestamp_format = ms
# Ou o seguinte também seria adequado
# jmeter.save.saveservice.timestamp_format = aaaa/MM/dd HH:mm:ss
                        

jmeter.reportgenerator.

jmeter.reportgenerator.apdex_per_transaction=sample(\\d+):1000|2000;\
    amostras12:3000|4000;\
    cenário01-12:5000|6000

jmeter.reportgenerator.

jmeter.reportgenerator.graph.

jmeter.reportgenerator.graph.<graph_id>.property

jmeter.reportgenerator.graph.<graph_id>.property.set_granularity=150

jmeter.reportgenerator.exporter

jmeter.reportgenerator.exporter.<exporter_id>.property

jmeter.reportgenerator.exporter.<exporter_id>.graph_options.<graph_id>

# Configure esta propriedade para alterar o título do relatório
#jmeter.reportgenerator.report_title=Painel do Apache JMeter

# Altere este parâmetro se desejar alterar a granularidade dos gráficos ao longo do tempo.
# A granularidade deve ser maior que 1000 (1 segundo), caso contrário, os gráficos de taxa de transferência estarão incorretos
# veja o Bug 60149
#jmeter.reportgenerator.overall_granularity=60000

 Altere este parâmetro se desejar alterar a granularidade da distribuição do tempo de resposta
# Configurado para 100 ms por padrão
#jmeter.reportgenerator.graph.responseTimeDistribution.property.set_granularity=100

# Altere este parâmetro se desejar substituir o limite de satisfação do APDEX.
jmeter.reportgenerator.apdex_satisfied_threshold=1500

# Altere este parâmetro se desejar substituir o limite de tolerância APDEX.
jmeter.reportgenerator.apdex_tolerated_threshold=3000

# Define o diretório de destino para as páginas html geradas, é melhor alterá-lo a cada geração
# Isso substituirá o valor definido através da opção de linha de comando -o
# jmeter.reportgenerator.exporter.html.property.output_dir=/tmp/test-report

# Indica quais séries de gráficos são filtradas (expressão regular)
# No exemplo abaixo, filtramos as amostras de pesquisa e pedido
# Observe que o final do padrão deve sempre incluir (-success|-failure)?$
# Transações por segundo sufixos Transações com "-success" ou "-failure" dependendo
# no resultado
#jmeter.reportgenerator.exporter.html.series_filter=^(Search|Order)(-success|-failure)?$

# Indica se o filtro de série se aplica apenas em séries de amostra
jmeter.reportgenerator.exporter.html.filters_only_sample_series=true
                    

14.3 Gerando relatórios ¶

A geração do relatório pode ser feita como um processo autônomo a partir de um arquivo de log de amostra ou automaticamente após a execução do teste de carga.

jmeter -g <arquivo de log> -o <Caminho para a pasta de saída>

jmeter -n -t <arquivo JMX de teste> -l <arquivo de log de teste> -e -o <Caminho para a pasta de saída>

14.3.3 Geração usando o menu Ferramentas GUI ¶

Você pode gerar o relatório HTML usando o item de menu Ferramentas → Gerar relatório HTML :

Para cada parâmetro veja a tabela a seguir:

Se nenhum diretório de saída for definido, o controlador usará ${JMETER_HOME}/bin/report-output .

Você só precisa clicar no botão Gerar relatório e esperar que uma caixa de diálogo de informações apareça

14.4 Gráficos padrão ¶

Todos os gráficos fornecidos por este mecanismo de relatório estão localizados no pacote org.apache.jmeter.report.processor.graph.impl

O gerador de painel fornece as seguintes classes de gráfico:

14.5 Geração de gráficos alfandegários ao longo do tempo ¶

Você pode representar graficamente qualquer sample_variable em CSV ao longo do tempo, você pode personalizar seus gráficos configurando suas propriedades no arquivo user.properties.
Eles devem usar o prefixo de id custom_ :

jmeter.reportgenerator.graph.custom_<your_graph_name_id>.property.<your_option_name>

jmeter.reportgenerator.graph.custom_<your_graph_name_id>.classname=org.apache.jmeter.report.processor.graph.impl.CustomGraphConsumer

Aqui está um exemplo de uma configuração de gráfico personalizada que representa graficamente a variável ts-hit :

jmeter.reportgenerator.graph.custom_testGraph.classname=org.apache.jmeter.report.processor.graph.impl.CustomGraphConsumer
jmeter.reportgenerator.graph.custom_testGraph.title=Chunk Hit
jmeter.reportgenerator.graph.custom_testGraph.property.set_Y_Axis=Número de Ocorrências
jmeter.reportgenerator.graph.custom_testGraph.set_X_Axis=Ao longo do tempo
jmeter.reportgenerator.graph.custom_testGraph.property.set_granularity=60000
jmeter.reportgenerator.graph.custom_testGraph.property.set_Sample_Variable_Name=ts-hit
jmeter.reportgenerator.graph.custom_testGraph.property.set_Content_Message=Número de Ocorrências:
                        

14.6 Quer melhorar o Painel de Relatórios? ¶