Gatling scripts

This topic provides an overview of how to upload and run Gatling scripts from LoadRunner Enterprise.

Note: This feature is currently available as tech preview.

In this topic:

Gatling scripts overview

Gatling is an open source load and performance testing tool (gatling.io/open-source). Gatling is used for analyzing and measuring the performance of web servers and web applications. Gatling uses Scala programming language to create test scripts.

LoadRunner Enterprise supports integration of Gatling (.scala) test scripts in your scenarios. You can run one or more Gatling scripts alongside any other LoadRunner Enterprise tests.

Gatling scripts have two significant features:

  • Every Gatling script file contains all the necessary run settings within the script code.

  • Gatling scripts contain a series of HTTP requests and pauses. Each request is reported as a transaction.

Measurements can be viewed online and offline (via LoadRunner Enterprise and Analysis), using the data points from Gatling tests.

Back to top

General requirements

  • For supported versions of Gatling, see the System and protocol requirements.

  • LoadRunner Enterprise supports Gatling scripts that use HTTP requests.

  • Upload a Gatling script to LoadRunner Enterprise in .zip format.

Back to top

Set up and run a Gatling test

This task describes how to upload Gatling scripts to LoadRunner Enterprise and configure runtime settings.

  1. Prerequisites:

    • Create scripts in Gatling and save the scripts locally. The scripts must be saved in .zip format and must include your .scala files and all other dependencies in the root folder of the .zip file.

    • We recommend that you delete any old or unnecessary files from the scripts folder to avoid them being uploaded to LoadRunner Enterprise.

    Note: The file path inside a script folder must not exceed 260 characters.

  2. Upload Gatling scripts to LoadRunner Enterprise

    For details, see Upload a script.

    After uploading the Gatling script to LoadRunner Enterprise, the script is added to the test management tree (identified by the icon).

  3. Create a LoadRunner Enterprise test, and assign the Gatling script to it.

    For details, see Design a test.

  4. Edit the script parameters - optional

    After you have uploaded a Gatling script to LoadRunner Enterprise, you can edit the script parameters. For details, see Edit script parameters.

  5. Run the test.

    Data points from Gatling tests are displayed in the LoadRunner Enterprise graphs. For details, see View Gatling test results.

Back to top

View Gatling test results

Every HTTP request in the Gatling script is reported as a transaction.

Gatling scripts produce results that are displayed in the following standard graphs:

  • Running Vusers

  • Transaction Response Time

  • Hits per Second

  • Total Trans/Sec (Passed)

  • Trans/Sec (Passed)

  • HTTP Response per Second

  • Throughput

For details, see Web resource monitors

Customized graphs cannot be generated from Gatling script results.

Back to top

See also: