Skip to content
  • ZipCode Api
  • Blog
  • About RedLine13
RedLine13
RedLine13
Primary Navigation Menu
Menu
  • Start Testing
  • Demo
  • Pricing
  • JMeter
  • Partners
  • Docs
    • Documentation Home
    • AWS Set Up for load testing
    • AWS Approval for Large Tests
    • PHP, NodeJS, Python Load Tests
    • Scalability
    • Jenkins Plugin Setup
    • Premium Features
    • Knowledge Base

Executing Gatling Tests with The SBT + Java RedLine13 Plugin

By: RedLine13

We have created a plugin for RedLine13 users to execute Gatling tests using SBT + Java.

Gatling Older SBT-Plugin

If you are using the older Gatling SBT-Plugin, you can package your JAR to be complete with everything required to run the test.  

sbt "it:assembly"

After the package is created, you can test locally

java -jar target/scala-2.11/gatling-tests-as-jar-1.0.jar -s example.SomeGatlingSimulation

A community member provided an example project that can be used to model here. After we have used SBT to package our JAR, we can take the generated JAR file and scale this on RedLine13.com. Executing Gatling Tests via SBT + Java supports the same features as running Gatling tests via Simulations. You can aggregate the results and generate a full Gatling report + RedLine13 reports.

Gatling New SBT-Plugin

The newer Gatling-SBT Plugin has a different mechanism for packaging your test, which only includes the test scenarios and required resources.

sbt Gatling/enterprisePackage

The output jar file will be located in the directory target/gatling/<artifactId>-gatling-enterprise-<version>.jar.
This JAR file will be the one to use when executing your test on RedLine13. We have tested this using the gatling-sbt-demo project. Executing Gatling Tests via SBT + Java supports the same features as running Gatling tests via Simulations. You can aggregate the results and generate a full Gatling report + RedLine13 reports.

Getting Started With The Plugin

To begin using the plugin, log into your RedLine13 account, locate the “Account” tab, and navigate to “Your Plugins”

Start Test Screen

Next, install the SBT + Java Plugin by clicking the “+”. You can verify the instillation by navigating to the “Installed” tab:

Install Plugin
Verify Install

Once the plugin is successfully installed, navigate back to your dashboard home, click “Start Test”, and then begin to create a new Gatling test. Upload the simulation that you generated in SBT, and be sure to click the “Save the response output from individual tests and calculate percentiles” (important: this will enable aggregated Gatling reports):

Starting a Load Test

You will then want to scroll down and locate the “Advanced Gatling Test Options” tab. Here we will activate the plugin by checking the box next to “SBT with Java”. You will also want to inject the appropriate simulation class and any other parameters. Once this has been completed, you can then run your test.

Important: If using the newer Gatling-SBT with the command */enterprisePackage make sure to select the checkbox.

Once your test has been completed, you can view the results inside RedLine13. To access the generated Gatling report, navigate to the “Output Files” tab. Here you will find your generated Gatling report that you can download.

Test Completed
Download Gatling Report

The Gatling report will be downloaded as a .TAR. Extract the files, navigate to the extracted “Report-Files” folder, and find your generated Gatling report (it will be a .HTML). Now you can simply drag the .HTML into your browser of choice and can view your Gatling report:

Generated Gatling Report

With this plugin, we now have three ways to execute Gatling Tests:

  • Upload Simulation file
  • Create and execute via Maven project
  • Create Assembly via SBT and execute via the java command

Additional Resources:

RedLine13 GitHub Documentation

Gatling.io Documentation on the plugin

Scala SBT

2022-12-12
Previous Post: Selenium Load Testing: When and How
Next Post: Guest Post: Load Testing with Locust and JMeter on RedLine13

Recent Posts

  • JMeter XML Format Post Processor
  • Order of Elements in JMeter
  • The JMeter Synthesis Report
  • Using the JMeter Plugins Manager
  • JMeter Rotating JTL Listener

Related

  • JMeter XML Format Post Processor
  • Order of Elements in JMeter
  • The JMeter Synthesis Report
  • Using the JMeter Plugins Manager
  • JMeter Rotating JTL Listener
  • Using Test Fragments in JMeter Tests
  • Step-by-Step Guide to Testing with JMeter
  • Functional Testing vs Performance Testing
  • A Gentle Introduction to Load Testing
  • Using the JMeter Counter Element

© RedLine13, LLC | Privacy Policy | Contract
Contact Us: info@redline13.com

Designed using Responsive Brix. Powered by WordPress.