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 :

• TestPlan > Add > Thread (Users) > Thread Group
• Thread Group > Add > Sampler > GRPC Client Sampler
• Config host, port, package, service... (see more)
• Save your test plan with name <your_test_script>.jmx

Example: hello.jmx

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

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