This is a wrapper around the Gatling load testing framework, with preconfigured injection steps, protocols and assertions.

Adding to your performance test

Compatible versions

Library Version Scala Version gatling-version gatling-sbt plugin
5.6.0 2.13 3.6.1 4.1.5

Gatling version refers to the version of the below Gatling dependencies:

  • gatling-test-framework
  • gatling-charts-highcharts

Add the below dependencies:

""          %% "performance-test-runner"   % "x.x.x" % Test,
"io.gatling"            % "gatling-test-framework"    % "x.x.x" % Test,
"io.gatling.highcharts" % "gatling-charts-highcharts" % "x.x.x" % Test

Add the below plugin:

addSbtPlugin("io.gatling" % "gatling-sbt" % "x.x.x")

Getting started

Refer to the getting-started guide for implementing your first simulation.



This repository uses Scalafmt, a code formatter for Scala. The formatting rules configured for this repository are defined within .scalafmt.conf.

To apply formatting to this repository using the configured rules in .scalafmt.conf execute:

sbt scalafmtAll scalafmtSbt

To check files have been formatted as expected execute:

sbt scalafmtCheckAll scalafmtSbtCheck

Visit the official Scalafmt documentation to view a complete list of tasks which can be run.


This code is open source software licensed under the Apache 2.0 License.