Gatling Installation & Configuration


In this tutorial I will explain the installation & configuration Gatling Testing Tool.

  • Installation
  • Structure
  • Simulation
  • Configuration
  • Advantages
  • Results & Reports


  • Ubuntu
  • Java JDK



First of all, we need to install Gatling from command-line or from this link 


From the command line : apt-get install gatling


After running ./ command, you will see simulation number prompt text to select simulation number from shown list, and you can give a short description for this run.

File Structure


  • /results: contains the benchmark results in web format
  • /bin: contains the scripts for launching Gatling
  • /target: contains the files resulting from the compilation of our scenarios + cache
  • /conf: contains configuration files (log level -will be explained)
  • /user-files: contains the .scala scenario definition files
  • /lib: gatling jar

You can add your own simulations to the folder /user-files/simulations



A Simulation is a real Scala class containing 4 different parts:

  • The HTTP protocol configuration
  • The headers definition
  • The scenario definition
  • The simulation definition


To configure Gatling you edit the configuration file – # This file contains all the settings configurable for Gatling with their default values.

  • Directory show default locations:


  • For report customization, depends on projects needs, default values & explanations below:


  • Monitoring configuration:


To configure Gatling logging you can edit the logback.xml configuration file.

Gatling Advantages

  • Free
  • Efficient
  • Scripts are scala code
  • Defines a DSL designed for expressing load tests, easy to learn scripts just reading.
  • Meaningful charts
  • Graphite & Jenkins Integration
  • Supports input files CSV, TSV, SSV to access random data for Data-Driven tests.

Recording Scenarios

For recording, browser proxy:  and port: 8888


now just run ./ under bin directory.


below screen show up, we will use to create scenarios just click on the start button.


We can include or exclude requests ( e.g. images, CSS, JS etc. ) using whitelist & blacklist options, For example if you don’t want to record any CSS files you can use some regex.


We are ready to record scenario.


go to address:


Results & Reports

After running your scenario, you can find the results under your /results folder as the index.html file. Below chart shows how response times are distributed among standard ranges (can be configured )


Executions Success and Failures, can go into details on every request.


In next post, I will show some load testing scenarios using gatling & jenkins integration.


Database Operations in JavaFX

By Onur Baskirt / Apr 1, 2016 / 56 Comments
Before started this section, please check the first article and learn How to Start JAVAFX! At first, part of JavaFX tutorial series, we created a sample JavaFX project, designed the draft version of the UI and set up an...
rest assured

REST API Testing with Rest Assured

By Onur Baskirt / Mar 8, 2016 / 32 Comments
Outline In this post, I will explain what is API and API testing, what is the difference between SOAP and REST services, and how to test REST APIs with Rest Assured Library. What is API? API stands for Application Programming...

How to Write Effective CSS Locators

By Onur Baskirt / Oct 1, 2017 / 0 Comments
Hi all, in this tutorial, I will describe you how to write effective CSS locators to interrogate web elements for your automation projects. As a rule of thumb, your interrogation strategy should be in below order: First try to use...

Selenium-11: Execute JavaScript with JavascriptExecutor

By Onur Baskirt / Jan 27, 2016 / 15 Comments
Outline Sometimes we cannot handle some conditions or problems with Webdriver, web controls don't react well against selenium commands. In this kind of situations, we use Javascript. It is useful for custom synchronizations, hide or show the web elements, change...

Getting Started with JavaFX

By Onur Baskirt / Mar 25, 2016 / 0 Comments
When I started to work in my current position, one of my task is to do manual operations for campaign products  every week. After the second week, I thought that I have to automate this task using a GUI based...

How to Write Smart XPath Locators

By Onur Baskirt / Sep 24, 2017 / 4 Comments
Hi all, in this tutorial, I will describe you how to write smart and non-brittle XPath locators. When we write our test scripts, we generally prefer to use id, name, class, etc. these kinds of locators. However, sometimes we could not...

Selenium-1: Quick Start to Automation with Selenium WebDriver & JAVA & JUnit & Maven & IntelliJ

By Onur Baskirt / Sep 8, 2015 / 26 Comments
Outline Selenium Webdriver is the most popular open source web test automation framework across wide range of browsers and platforms. In this tutorial you will learn how to do web test automation with Selenium Webdriver and the related tools. Audience...
page object model

Page Object Model with C#

By Ege Aksoz / Jun 18, 2017 / 8 Comments
In the previous tutorial, we’ve taken the initial steps and entered the world of automated testing. We also wrote our first automated test. From this point on, since we are not just going to write one test, we need to...

How to Select a Date From DatePicker Using Selenium

By Onur Baskirt / Aug 13, 2016 / 6 Comments
When you need to automate a airway, hotel, or similar websites you need to deal with Datepickers and some times it is a little bit cumbersome to select a specific date on the Datepicker or calendar.  In this post, I...

Selenium Webdriver Performance testing with Jmeter and Selenium Grid

By Ozgur Kaya / Aug 9, 2016 / 2 Comments
In this post, we will complete Selenium Webdriver Performance testing scenario using Jmeter and Selenium Grid. 1- Install Java 7 or later If necessary 2- Download latest Jmeter version 3.0 or higher. 3- Download Jmeter PluginsManager JAR file and...
By | 2017-01-13T21:33:46+00:00 December 29th, 2015|Gatling, Performance Testing|2 Comments

About the Author:

Onur Yazir
Onur YAZIR is a Senior Software Testing & Deployment Engineer 7+ years of experience. He has worked at Huawei, Ericsson, Teknosa as Software Test Engineer. After that, he worked as DevOps Engineer at London-based fintech company EFT Software. Now, he is a DevOps Engineer at Gulf News Dubai Office. You can find detailed information about him on his linked-in page.


  1. 明辉 February 9, 2016 at 10:45 am - Reply

    Very explanatory introduction, thanks a lot 🙂

  2. Priyo April 5, 2017 at 3:23 pm - Reply

    How to filter the time in seconds? If I want to use other load generator how it possible to do that?
    Thanks in advance.

Leave A Comment