In this article we are going to see how we can get good reports in jmeter after tests. This is continuation post of this original article.

Jmeter Reports

In Jmeter, we can have different type of test results.

CSV test results (default selection by plugins)
JTL logs
HTML Results (modern report)
Jmeter Listener Graphs : Images/reports created by Jmeter Listeners

Enabling HTML report

To enable, html report, we can use this in configuration.

<generateReports>true</generateReports>

html

Result File Formatting

To enable CSV results

 <resultsFileFormat>csv</resultsFileFormat>

To enable JTL results

 <resultsFileFormat>xml</resultsFileFormat>

jtl

But, if you have enabled <generateReports> true, this will be always CSV in spite of XML settings.

html-csv

To disable timestamp from file name

<testResultsTimestamp>false</testResultsTimestamp>

Add timestamp at the end of the results filename

<appendResultsTimestamp>true</appendResultsTimestamp>

Specify date time format in result file

<resultsFileNameDateFormat>MMM, yyyy</resultsFileNameDateFormat>

Result file folder location

<resultsDirectory>/results/jmeter</resultsDirectory>

As maven build fails when detecting errors & it stops builds. To prevents this, we can ignore failure of results

<ignoreResultFailures>true</ignoreResultFailures>

To prevent maven build error, its better to have some threshold values to test case where a certain number of errors can be accepted. I prefer 2% error is tailorable. To apply this, use

<errorRateThresholdInPercent>2</errorRateThresholdInPercent>

Stop Jmeter from printing console output

 <suppressJMeterOutput>true</suppressJMeterOutput>

To skip whole test

 <skipTests>true</skipTests>

To specify Log Level

 <overrideRootLogLevel>debug</overrideRootLogLevel>

Finally report POM.XML

html-reporting-Project-source

I have added following 3 html report properties for example which are optional

<jmeter.reportgenerator.report_title>Shantonu Example</jmeter.reportgenerator.report_title>
<jmeter.reportgenerator.overall_granularity>500</jmeter.reportgenerator.overall_granularity>
<jmeter.reportgenerator.exporter.html.series_filter>^(-success|-failure)?$</jmeter.reportgenerator.exporter.html.series_filter> 

HTML Report UI

dashboard

over-time

Creating Traditional Graphs

As we can always create graphs with JTL by CMD runner, another jmeter graph maven plugins available to generate this.

To use that plugins, we need to exclude html reporting and keep default XML (jtl) reporting format.

Adding Graph Plugins

<plugin>
    <groupId>de.codecentric</groupId>
    <artifactId>jmeter-graph-maven-plugin</artifactId>
    <version>0.1.0</version>
</plugin>

We need to add a configuration section and add type of graph one by one.

<configuration>
    <inputFile>${project.build.directory}/jmeter/results/*.jtl</inputFile>
    <graphs>
        <graph>
            <pluginType>ThreadsStateOverTime</pluginType>
            <width>1024</width>
            <height>768</height>
            <outputFile>${project.build.directory}/jmeter/results/graphs/ThreadsStateOverTime.png</outputFile>
        </graph>
    <graphs>
</configuration>

This plugins supports following Graphs(PNG):