jmeter-grpc-request - GitLite

KO | EN

gitlite — search

#python #react #llm #golang #android #deep-learning #nodejs #awesome-list #vue #security #pytorch #mcp #ios #open-source

jmeter-grpc-request

(★ 189)

JMeter gRPC Request load test plugin for gRPC

File Explorer

Download Latest Version (.zip)

Showing a partial file list — download the zip above to see everything.

- - action-test-build.yml
  - action.yml
  - stale-issues.yaml
- dependabot.yml
- - benchmark-testscript-grpc.jpg
  - distributed-model.png
  - jmeter-and-grpc.png
  - jmeter-grpc-create-testscript.gif
  - report-120-1800s.jpg
  - report-120-3600s.jpg
  - report-1k-300s.jpg
  - report-500-300s.jpg
  - report-500-900s.jpg
- - BookService_2.jmx
  - BookService_element_gui.jmx
  - README.md
  - SegmentService_checkSeg.jmx
  - SegmentService_checkSeg_metadata.jmx
.gitignore
.pre-commit-config.yaml
codecov.yml
CONTRIBUTING.md
LICENSE
README.md
README.zh-CN.md
RELEASE-NOTES.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# JMeter gRPC Request

<p align="center"><img src="./dist/asset/jmeter-and-grpc.png" width="600px" alt="Apache JMeter and gRPC logo" /></p>

<h4 align="center">This sampler JMeter lets you send an gRPC request to a server. </br> It's as simple as a HTTP Request.</h4>
<br>

[![Javadocs](https://www.javadoc.io/badge/org.apache.jmeter/ApacheJMeter_core.svg)](https://www.javadoc.io/doc/org.apache.jmeter/ApacheJMeter_core)
[![Stack Overflow](https://img.shields.io/:stack%20overflow-jmeter-brightgreen.svg)](https://stackoverflow.com/questions/tagged/jmeter)

[简体中文](./README.zh-CN.md) | English

## What is it

This is a simpler of JMeter used to test for any gRPC server, it is not necessary to generate gRPC classes or to compile the protos binary for the service. Just a very simple for input:

- Host and port of gRPC service.
- Method of service needs testing.
- Folder path of proto files.
- Data request in JSON format.

Same as JMeter HTTP Request but for gRPC. Copy only once file jar to lib/ext of JMeter, select your protobuf folder and start making requests! No extra steps.

*The JMeter gRPC Request is available at JMeter Plugins Manager, we can find here https://jmeter-plugins.org/?search=jmeter-grpc-request*

## Features

- Supports Blocking Unary Calls.
- Parses proto files at runtime.
- Supports plain text and TLS connections.
- Supports authentication via metadata (JWT/Token).
- Request data with JSON format.
- Runs on Mac, Linux and build project by Maven.

*Todo:*

- [x] *Supports TLS connections.*
- [x] *Supports authentication via metadata.*
- [x] *Auto list full methods.*
- [x] *Count the failed request in the report.*
- [x] *Auto generate request data base on proto file.*
- [ ] *Supports grpc-web protocol (HTTP1.1).*

## Usage

<p align="center"><img src="./dist/asset/jmeter-grpc-create-testscript.gif" width="820px" alt="jmeter-create-testscript-grpc" /></p>

### Requirements

All you need copy *jmeter-grpc-request* file jar to directory `lib/ext` of JMeter and restart JMeter GUI (copy once, use forever). Binary are available from the [Releases Page](https://github.com/zalopay-oss/jmeter-grpc-request/releases).

### Making a gRPC request with JMeter

Create test script:

- Add Thread Group: right-click on the Sample Test (our Test Plan) → Add → Threads (Users) → Thread Group.
- Add GRPC Request: right-click on the newly created Thread Group  → Add → Sampler → GRPC Request.
- Fill info request: host, port, method, data request, proto folder.
- Save test script.

Run test:

- Via JMeter GUI: in top bar click Run → Start.
- Via command line: `bin/jmeter -n -t <test JMX file>.jmx -l <test JMX result>.csv -j <test log file>.log -e -o <Path to output folder>`.

### Configurations

| No. 	| Fields                             	| Description                                                         	|
|-----	|-----------------------------------	|---------------------------------------------------------------------	|
| 1   	| Server Name or IP                 	| Domain/IP for gRPC server                                         	|
| 2   	| Port Number                       	| Port for gRPC server (80/ 443)                                      	|
| 3   	| SSL/TLS                           	| SSL/TLS to authenticate the server                                  	|
| 4     | Disable SSL/TLS Cert Verification     | Disable SSL/TLS certificate verification (enable this function when using self-signed certificates)                                      |
| 5   	| Proto Root Directory              	| Root directory contains proto files                                 	|
| 6   	| Library Directory (Optional)      	| Using a different underlying library (googleapis)                   	|
| 7   	| Full Method                       	| Full Method to test                                                 	|
| 8   	| Metadata                          	| Metadata can be use for Store token, authentication method, etc. <br/>Two Ways to use metadata, <br/><br/> &nbsp;<b>1. Comma separated Key:Value : </b><br/>&nbsp; - key1:value1,key2:value2<br/>&nbsp; - Value should url encode with utf-8 <br/><br/>&nbsp;2.<b> Json String : </b><br/>&nbsp;&nbsp; - {"key1":"Value1", "key2":"value2"} <br/><br/> <b>Note: <i>In gRPC Metadata value is (Key, value) both in format of (String, String), in case of nested Json Objects values, will go to request as a JsonString. </i></b>                              	|
| 9   	| Deadline                          	| How long gRPC clients are willing to wait for an RPC to complete  	|
| 10   	| Send JSON Format With the Request 	| Data request with JSON format                                       	|

## Running the examples

Example invocations can be found in the [example](./dist/example) directory.

## Benchmark

Purpose verify that *jmeter-grpc-request* is really stable when performing load testing for the gRPC system. Read more [Benchmark: jmter-grpc-request](./dist/benchmark)

- CCU: 120 user
- Duration: 30 min

<img src= "./dist/asset/report-120-1800s.jpg" />

## Build instructions

### Build requirements

In order to build JMeter GRPC Request from source, you will need:

- [Java 8](https://www.oracle.com/downloads/index.html)
- [Apache Maven 3](https://maven.apache.org/)

### Build from source

Build a (fat) jar output in target directory, run:

```
mvn clean install package
```

## Inspiration...

- Thanks: [grpc-ecosystem/polyglot](https://github.com/grpc-ecosystem/polyglot)
- More: https://stackoverflow.com/q/61133529/9488752
- If you like working with the request message builder at here [zalopay-oss/jmeter-grpc-plugin](https://github.com/zalopay-oss/jmeter-grpc-plugin)