https://github.com/anthonygauthier/jmeter-live-changes-config

JMeter Plugin exposing a REST API allowing users to manipulate thread values, variables, properties on-the-go.
https://github.com/anthonygauthier/jmeter-live-changes-config

jmeter jmeter-plugin jmeter-scripting jmeter-tests performance performance-testing rest-api

Last synced: 7 days ago
JSON representation

JMeter Plugin exposing a REST API allowing users to manipulate thread values, variables, properties on-the-go.

• Host: GitHub
• URL: https://github.com/anthonygauthier/jmeter-live-changes-config
• Owner: anthonygauthier
• License: mit
• Created: 2019-02-19T16:08:53.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-10-14T21:11:35.000Z (about 1 month ago)
• Last Synced: 2024-11-01T10:51:31.790Z (14 days ago)
• Topics: jmeter, jmeter-plugin, jmeter-scripting, jmeter-tests, performance, performance-testing, rest-api
• Language: Java
• Homepage:
• Size: 2.91 MB
• Stars: 20
• Watchers: 4
• Forks: 8
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# JMeter Live Changes Config

## Overview

This plugin allows users to manipulate (through a REST API) JMeter test plans *on-the-go*.

Here's a couple things that are modifiable:

* Throughput

* Number of active threads

* Variables

* Properties

Users can also:

* View a summary of the test results

* End the test remotely

* Retrieve a quick status of the test (time running, active threads, etc.)

## Why

There are some scenarios where this kind of tool becomes very handy. 

For example;

* Testing the impact of different load scenarios against a system

* Container sizing (on Kubernetes/OSE, for example)

* Correcting certain test parameters while the test is running

## Setup

**Java version 9+ is required**

1. Download the latest JAR from the release section

2. Move the file to your `$JMETER_HOME/lib/ext` folder

3. Start JMeter, load your test plan

4. Add the `Live Changes Config` element to the root of your test plan

5. Set the port you want to be able to communicate with (defaults to `7566`)

6. Start your test

7. By using any HTTP client (Postman, Insomnia, cURL, etc.) communicate with the REST API to change your test's values

## Documentation

An API documentation [is available here](https://anthonygauthier.github.io/jmeter-live-changes-config/), it is directly generated from the [swagger.yaml](docs/swagger.yaml).

---

## Contributing

This plugin is licensed under the MIT license. 

All contributions are welcomed and appreciated.