https://github.com/ldclakmal/ballerina-http-test-suite

Ballerina HTTP test-suite, which is used to execute performance tests for Ballerina programming language.
https://github.com/ldclakmal/ballerina-http-test-suite

ballerina ballerina-lang docker http jmeter netty performance

Last synced: about 2 months ago
JSON representation

Ballerina HTTP test-suite, which is used to execute performance tests for Ballerina programming language.

• Host: GitHub
• URL: https://github.com/ldclakmal/ballerina-http-test-suite
• Owner: ldclakmal
• Created: 2019-07-09T05:49:11.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2021-10-18T02:29:21.000Z (almost 4 years ago)
• Last Synced: 2025-03-01T19:25:03.159Z (7 months ago)
• Topics: ballerina, ballerina-lang, docker, http, jmeter, netty, performance
• Language: Shell
• Homepage:
• Size: 7.64 MB
• Stars: 0
• Watchers: 0
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Ballerina HTTP Test Suite

This is an HTTP test suite which contains guide and all resources to execute performance tests for Ballerina in a local machine or VM.

### Resources

- [JMeter](https://jmeter.apache.org/) scrips

- [Netty](https://netty.io/) backend

- Sample JSON payloads

## Setup

First you have to create 3 instances (VMs/Physical Machines) for JMeter, Ballerina and Netty. Alternatively, you can run all in single instance.

### JMeter

- Download and install [Apache JMeter](https://jmeter.apache.org/).

- Start JMeter of GUI Mode. Refer [Getting Started](https://jmeter.apache.org/usermanual/get-started.html) for more information.

- Import and use the [JMX](./jmeter/) files for HTTP1.1 or HTTP2.0 as required.

### Ballerina

- Download and install [Ballerina](https://ballerina.io/).

- Run the particular [gateway](https://github.com/ballerina-platform/ballerina-performance/tree/master/distribution/scripts/ballerina/bal) *.bal* files by executing following command.

    `$ bal run `

### Netty

- Download and install [Docker](https://www.docker.com/).

- Run the Docker image of Netty Echo Backend as required.

    - h1c - `$ docker run -d -p 8688:8688 ldclakmal/netty-echo-backend`

    - h1 - `$ docker run -d -p 8688:8688 -e "SSL=true" ldclakmal/netty-echo-backend`

    - h2c - `$ docker run -d -p 8688:8688 -e "HTTP2=true" ldclakmal/netty-echo-backend`

    - h2 - `$ docker run -d -p 8688:8688 -e "HTTP2=true" -e "SSL=true" ldclakmal/netty-echo-backend`

- Refer the [Docker Hub Image](https://hub.docker.com/repository/docker/ldclakmal/netty-echo-backend) for more information.

## Let's Start

Now, you can start the JMeter with a single request to check whether the request-response path is properly configured.

![JMeter Single Request](./jmeter/img/single-request.png)

If not, check the URLs and ports of JMeter, Ballerina Service and Netty Backend and figure out the issue.

If the response is received successfully, start the performance test with the required number of threads, ramp-up period and time.