https://github.com/sngular/kloadgen

KLoadGen is kafka load generator plugin for jmeter designed to work with AVRO, JSON and PROTOL-BUFFERS schema Registries.
https://github.com/sngular/kloadgen

avro-schema java jmeter-plugin json-schema kafka load-testing protobuf protocol-buffers

Last synced: 15 days ago
JSON representation

KLoadGen is kafka load generator plugin for jmeter designed to work with AVRO, JSON and PROTOL-BUFFERS schema Registries.

• Host: GitHub
• URL: https://github.com/sngular/kloadgen
• Owner: sngular
• License: mpl-2.0
• Created: 2019-11-18T12:15:08.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2024-05-03T09:29:42.000Z (9 months ago)
• Last Synced: 2024-05-18T22:21:54.589Z (9 months ago)
• Topics: avro-schema, java, jmeter-plugin, json-schema, kafka, load-testing, protobuf, protocol-buffers
• Language: Java
• Homepage: http://sngular.com
• Size: 13 MB
• Stars: 200
• Watchers: 28
• Forks: 42
• Open Issues: 20
• Metadata Files:
  • Readme: README.md
  • Contributing: docs/contributing.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-kafka - KLoadGen - load generator plugin for jmeter

README

        
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/85c9817742944668b5cc75e3fa1cdb23)](https://app.codacy.com/gh/sngular/kloadgen?utm_source=github.com&utm_medium=referral&utm_content=sngular/kloadgen&utm_campaign=Badge_Grade_Dashboard)

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.sngular/kloadgen/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.sngular/kloadgen)



Summary · 

Getting started · 

Usage · 

Technical design · 

Support · 

Special thanks 

 


## 📜 Summary

KLoadGen is a Kafka load generator plugin for JMeter designed to work with AVRO, JSON Schema, and PROTOBUF structures for sending Kafka messages. It connects to the Schema Registry server, retrieves the subject to send, and generates a random message every time.

Check our [wiki](https://github.com/sngular/kloadgen/wiki) for more details on KLoadGen. 

## 🚀 Getting Started

Take a look at the [prerequisites](https://github.com/sngular/kloadgen/wiki/getting-started#prerequisites) for KLoadGen. 

If you want to start right away with your load tests, follow the [quickstart](https://github.com/sngular/kloadgen/wiki/getting-started#quickstart) and see [how to run a test plan](https://github.com/sngular/kloadgen/wiki/how-to-run#how-to-run-a-test-plan).

### Installation

Check how to install KLoadGen as a JMeter library, how to download a prebuilt version from Maven, and how to install the plugin as a dependency in the [Installation](https://github.com/sngular/kloadgen/wiki/installation) page.

## 🧑🏻‍💻 Usage

### Configuration

See the [Producer configuration](https://github.com/sngular/kloadgen/wiki/producer-configuration) and [Consumer configuration](https://github.com/sngular/kloadgen/wiki/consumer-configuration) pages on our wiki for details on how to set up both ends of the message, producer and consumer, for this plugin.

### Schemas

KLoadGen supports schemas with both primitive and complex data types, including arrays, maps or a combination of both.

It also allows creating custom sequences of values and supports null values.

You can find more details in [Schemas](https://github.com/sngular/kloadgen/wiki/schemas).

## 📊 Technical design

See the architecture and project structure of KLoadGen in the [Architecture](https://github.com/sngular/kloadgen/wiki/architecture) page.

## 🧰 Support

We’ll be glad to talk and discuss how KLoadGen can help you 😊

Reach us through [GitHub issues](https://github.com/sngular/kloadgen/issues), [GitHub discussions](https://github.com/sngular/kloadgen/discussions), [email](mailto:[email protected]) or [Twitter](https://twitter.com/sngular).

## 💜 Special thanks

We would like to give special thanks to [pepper-box](https://github.com/GSLabDev/pepper-box) for giving us the base to create this plugin and the main ideas on how to face it.