Prometheus Listener for Jmeter

Features

A listener for Jmeter to expose the results of your test through a Prometheus Api.

• Exposes Sampler latency and Assertion counts as metric values
• Can use sample_variables for additional labels.

# HELP jmeter_assertions_total Counter for assertions
# TYPE jmeter_assertions_total summary
jmeter_assertions_total_count{sampler_name="local-metrics",failure="false",assertion_name="Response Assertion",} 9.0
jmeter_assertions_total_sum{sampler_name="local-metrics",failure="false",assertion_name="Response Assertion",} 132.0
# HELP jmeter_samples_latency Summary for Sample Latency
# TYPE jmeter_samples_latency summary
jmeter_samples_latency{sampler_name="local-metrics",code="200",success="true",quantile="0.5",} 5.0
jmeter_samples_latency{sampler_name="local-metrics",code="200",success="true",quantile="0.99",} 11.0
jmeter_samples_latency_count{sampler_name="local-metrics",code="200",success="true",} 9.0
jmeter_samples_latency_sum{sampler_name="local-metrics",code="200",success="true",} 132.0
# HELP jmeter_samples_ttfb_seconds Summary for sample latency(TTFB) in seconds
# TYPE jmeter_samples_ttfb_seconds summary
jmeter_samples_ttfb_seconds{sampler_name="local-metrics",code="200",success="true",quantile="0.5",} 4.0
jmeter_samples_ttfb_seconds{sampler_name="local-metrics",code="200",success="true",quantile="0.99",} 5.0
jmeter_samples_ttfb_seconds_count{sampler_name="local-metrics",code="200",success="true",} 18.0
jmeter_samples_ttfb_seconds_sum{sampler_name="local-metrics",code="200",success="true",} 73.0
# HELP jmeter_samples_duration_seconds Summary for sample duration in seconds
# TYPE jmeter_samples_duration_seconds summary
jmeter_samples_duration_seconds{sampler_name="local-metrics",code="200",success="true",quantile="0.5",} 4.0
jmeter_samples_duration_seconds{sampler_name="local-metrics",code="200",success="true",quantile="0.99",} 5.0
jmeter_samples_duration_seconds_count{sampler_name="local-metrics",code="200",success="true",} 18.0
jmeter_samples_duration_seconds_sum{sampler_name="local-metrics",code="200",success="true",} 74.0
# HELP jmeter_samples_idle_time_seconds Summary for sample idle time in seconds
# TYPE jmeter_samples_idle_time_seconds summary
jmeter_samples_idle_time_seconds{sampler_name="local-metrics",code="200",success="true",quantile="0.5",} 0.0
jmeter_samples_idle_time_seconds{sampler_name="local-metrics",code="200",success="true",quantile="0.99",} 0.0
jmeter_samples_idle_time_seconds_count{sampler_name="local-metrics",code="200",success="true",} 18.0
jmeter_samples_idle_time_seconds_sum{sampler_name="local-metrics",code="200",success="true",} 0.0
# HELP jmeter_samples_connect_time_seconds Summary for sample connect time in seconds
# TYPE jmeter_samples_connect_time_seconds summary
jmeter_samples_connect_time_seconds{sampler_name="local-metrics",code="200",success="true",quantile="0.5",} 0.0
jmeter_samples_connect_time_seconds{sampler_name="local-metrics",code="200",success="true",quantile="0.99",} 0.0
jmeter_samples_connect_time_seconds_count{sampler_name="local-metrics",code="200",success="true",} 18.0
jmeter_samples_connect_time_seconds_sum{sampler_name="local-metrics",code="200",success="true",} 0.0

Examples in Grafana

A grafana dashboard example to inspect jmeter exporter metrics. You can find more examples here

Usage

To use this plugin you'll have to clone this repo, build the shaded jar and move it to your JMeter's lib/ext directory.

To build, simply maven package:

mvn clean package

This creates 2 jars, a shaded jar that has all the dependencies within it (this is the one you want) and the original jar. Both are in the target directory. Simply move the jar to your $JMETER_HOME/lib/ext directory as with any JMeter plugin and you're ready to go!

Feedback

Feel free to open issues against this project. It's not super active, mind you, but I'm trying to rectify that.