Gatling Test
A guide for creating Gatling test on Loadium
Gatling is an open source performance testing framework, which uses Scala, Akka and Netty as a technology stack and as its backbone.

Setting Up Gatling Test

You should choose the Gatling Test option from the “New Test” page.
There are two steps to create a Gatling Test.

Step 1: Basic Settings

Test Name:  is a mandatory field. Tests will shown by the name that you define in the “Tests” page.
Project: is an optional field that allows you to assign your tests to a specific project in order to group them.
Upload File:  You should upload a scala file from the upload file area. Whenever any test is saved, newly added files will be uploaded to our servers. In case there’s an update, Loadium will automatically update the files by matching them with their file name.
Note: At least one scala file is mandatory to save a Gatling test.
Split CSV File: Select this option to split your CSV data into engines uniquely. You can find more detailed information about Split CSV here.
Note: The name of the CSV that you have upload and the name of the CSV in your scala file must be the same.
Gatling Version: Choose the Gatling version according to your test script implementation.
Recommended version of Gatling is 3.5.1
Sandbox Test: Enable this option if you just want to make sure that your system is ready for testing or your script is properly working. Enabling Sandbox Test will limit the test configuration to the minimum and will run a test without decrease test count.

Step 2: Setting Up Performance Test Parameters

Engine Count: This parameter lets you to create engines on Loadium’s servers.
Thread Per Engine Count: The number of virtual users per engine.
Duration(min): Total time for Loadium to execute Gatling scenarios.
Note: Test run times can not exceed the duration you set but if your Gatling scenario ends the test will be automatically finished.
Geolocation: According to the geolocation you choose engines will be generated in that particular region and all requests will come from there. You can find more detailed information about Geolocation here.
Dedicated IP: If the system that is going to be tested has access limitations such as a firewall or DDoS protection, you can rent static IP’s and whitelist them to allow Loadium to perform load test on the system. Enabling this option will run the test with the rented dedicated IP’s. To rent dedicated IP’s, please contact our support. You can find more detailed information about Dedicated IP’s here.
Network Type: Loadium lets you choose different network types to simulate network behavior by imitating the bandwidth and network delays. They all have different bandwidth and network delay values. In case nothing is selected, by default Wifi is set to all engines. You can find more detailed information about Network Types here.
Note: You can write a note for your test which you can access later.
Send Email: In case you would like to be notified by e-mail after the test ends, you can enable this feature. You can find detailed information about this feature, here.

Displaying Gatling Test Report

Gatling test report includes test status and graphics that belongs to them on Overview page.
Also you can examine Summary Report, Timeline Report, Response Codes, Engine Health, Logs and Errors pages.
New Relic and App Dynamics metrics will be only shown if you have included these features into your test. You can find more detailed information about New Relic and App Dynamics here.
Enjoy Gatling Tests!
If you don't see the answer to your question here, please reach out to us to let us know! We're always improving our documentation.