Home

Awesome

JMeter gRPC Plugin

A JMeter plugin supports load test grpc service.

Installation

$ mvn clean install

$ cp target/jmeter-grpc-client-sampler.jar path/to/jmeter/lib/ext

Usage

Note: Please read example first if you want to skip the step by step below

Step 1. Create a *.jar which contains java code generated from *.proto file and copy to jmeter/lib/ext.

Example:

$ cp hello.proto grpc-lib/src/main/proto/

$ cd grpc-lib && mvn package

$ cp target/grpc-lib-0.0.1.jar ../apache-jmeter-5.2/lib/ext/

Step 2. Create test plan :

Example: hello.jmx

<div align="center"> <img src="docs/images/create-grpc-sampler.png" width="95%"/> </div>

Run

# view all command in jmeter
$ jmeter/bin/jmeter -h

# run load test
$ jmeter/bin/jmeter -n -t <your_test_script>.jmx -l <result_file>.csv

# generate report
$ jmeter/bin/jmeter -g <result_file>.csv -o <report>

Report

<div align="center"> <img src="docs/images/report-results.png" width="90%"/> </div>

Acknowledgements

Thanks to @A1Darkwing (Thanh Tran), @anhldbk (Anh Le), @VoxT (Thieu Vo) who dedicated to help me review and refactor the source code of project.

If you would like to work with the simple request by json, see jmeter-grpc-request