Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Development environment

BluePyth edited this page · 14 revisions

As we chose to push Gatling on Github, it is likely that other people will want to see how we did it, and hopefully help us; the aim of this page is to ease the "get-into-developing-gatling" process. To know how you can contribute to Gatling, visit Contributing.

Software Requirements

Importing Project into Eclipse

Once every software is installed, you can import Gatling project into Eclipse. Doing so is really easy:

  1. Open Eclipse
  2. Click on File > Import... > Maven > Existing Maven Project
  3. Select gatling folder
  4. Finish the import
  5. Repeat the process for gatling-highcharts
  6. All Done !

Getting Gatling to run in Eclipse

Gatling is made to run as a standalone program, thus most users will want to download a tarball containing all the binaries required to execute Gatling.

As a developer, you'll want to run Gatling from Eclipse, sparing the long process of tarball creation. These are the steps required:

Note: GATLING_HOME is, from a developer point of view, the folder in which you'll find the folders: assets, bin, results, etc. It could be defined as follows: GATLING_HOME=${where-you-cloned-gatling}/gatling/gatling-bundle/src/main/assembly/assembly-structure

  1. Create a new running configuration in the Scala Application category
  2. Choose a name, Gatling is a good one
  3. Select the gatling-app project and the class as the main class
  4. Add these arguments in the VM options:

    -XX:+UseThreadPriorities -XX:ThreadPriorityPolicy=42 -Xms512M -Xmx512M -Xmn100M -Xss512k -XX:+HeapDumpOnOutOfMemoryError -XX:+AggressiveOpts -XX:+OptimizeStringConcat -XX:+UseFastAccessorMethods -XX:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -XX:SurvivorRatio=8 -XX:MaxTenuringThreshold=1 -XX:CMSInitiatingOccupancyFraction=75 -XX:+UseCMSInitiatingOccupancyOnly

  5. Set GATLING_HOME in the environment tab
  6. Add the folder $GATLING_HOME/conf to the classpath before gatling-app
  7. Add the project gatling-charts-highcharts to the classpath before gatling-app
  8. Ready to launch !

Going further

Another set of tools can be appreciated if you want to test things and, for example, package Gatling as an archive.

  • Scala. Installing Scala on your computer will allow you to use the REPL. This is the Scala interpreter, you can use it to test pieces of code and so on.
  • Maven. Having the maven integration plugin in Eclipse is enough to import the project and manage dependencies; but if you want to package Gatling or test that the mvn clean install process actually works, you'll need it installed on your computer as well.
  • Git tools. To help you working with Git, you can use different software. EGit is an integration of Git in Eclipse, it is included in Eclipse Indigo's Update Site.
Something went wrong with that request. Please try again.