sbcd90 / kafka-gatling-extension

A Gatling extension for running load tests on Apache Kafka installations

kafka-gatling-extension

Gatling is an open-source load testing framework. The Kafka Gatling extension can be used for stress testing an existing Apache Kafka installation using Gatling.

Compatibility

The extension supports Apache Kafka 0.10 protocol & latest released version of Gatling 2.2.

Installation

Installation as a maven plugin

In pom.xml add,

<repository>
   <id>gatling-kafka-extension</id>
   <name>gatling-kafka-extension</name>
   <url>https://dl.bintray.com/sbcd90/io.gatling/</url>
</repository>

add the extension as a maven dependency,

<dependency>
   <groupId>io.gatling</groupId>
   <artifactId>kafka-gatling-extension</artifactId>
   <version>1.0</version>
</dependency>

Installation from source

mvn clean install -Ppackage-only

Getting started

• Look into the file BasicSimulation.scala. Point it to the right Kafka Broker coordinates & provide the correct Kafka topic name.
• Start the simulation using the command

mvn gatling:execute -Dgatling.simulationClass=io.gatling.simulation.BasicSimulation

• Start the Simple Kafka Consumer after pointing it to the right Kafka coordinates.

Features

• Custom avro schemas can be passed for generating records using them. Here is an example

• An in-built Random Data Generator is provided for getting started with Load tests quickly.

• Custom data generators can be added if necessary. Here is an example

• Gatling feeders are supported & a custom csv file can be passed for loading data. Here is an example

kafka-gatling-extension's Issues

Simulation example for sending a simple json file to Kafka

Hi. Can you provide a sample or instructions for a simulation that sends a simple json file to Kafka?

Authorization failed for mvn clean install -Ppackage-only

Hi
I want to use your Gatling plugin but when I tried to run "mvn clean install -Ppackage-only" I got an error as follows:

[ERROR] Failed to execute goal on project testing: Could not resolve dependencies for project com.learn.gatling:testing:jar:1.0-SNAPSHOT: Failed to collect dependencies at io.gatling:kafka-gatling-extension:jar:1.0: Failed to read a
rtifact descriptor for io.gatling:kafka-gatling-extension:jar:1.0: Could not transfer artifact io.gatling:kafka-gatling-extension:pom:1.0 from/to gatling-kafka-extension (https://dl.bintray.com/sbcd90/io.gatling/): Authorization fai
led for https://dl.bintray.com/sbcd90/io.gatling/io/gatling/kafka-gatling-extension/1.0/kafka-gatling-extension-1.0.pom 403 Forbidden -> [Help 1]

Can you assist with it?
BR,
Adi