TeamCity Plugin

Run your Gatling Enterprise simulations from your TeamCity CI.

Purpose of this plugin

This plugin allows you to start a Gatling Enterprise simulation directly from your TeamCity platform. This plugin links a TeamCity plan with one and only one Gatling Enterprise simulation.

This plugin doesn’t create a new Gatling Enterprise simulation, you have to create it manually before.


To download the plugin, you need to get the ZIP file by clicking on the following button:

Download Teamcity Plugin

You need to be connected as an administrator of your TeamCity application to install it. Navigate to Administration, Plugins, Upload plugin zip, and choose the downloaded zip file.

Upload plugin

Once the plugin is uploaded, you need to enable it.


The plugin needs a global configuration. Go to Administration, then frontline-teamcity-plugin:

  • the Gatling Enterprise Address is the address of Gatling Enterprise (use for Gatling Enterprise Cloud).
  • the Gatling Enterprise API Token is needed to authenticate to Gatling Enterprise:
    • for Gatling Enterprise Cloud, the API token needs the Start permission.
    • for Gatling Enterprise Self-Hosted, the API token needs the All role.

Plan set-up

Add a new build step called Gatling Enterprise Launcher. Choose in the Simulation list the simulation you want to monitor. You need to configure the global properties of the plugin, and create at least a simulation on Gatling Enterprise to do this step.


This step regularly prints a summary of the run’s current status to the build logs. By default, the summary is printed every 5 seconds the first 12 times (i.e. for the first 60 seconds), and then every 60 seconds. You can configure this behavior (or disable it completely) in the step configuration.

JUnit reporting

You can display the results of the Gatling Enterprise assertions as a JUnit Test.

Add a new build feature called XML report processing. Choose Ant JUnit as report type, and enter in the Monitoring rules input the following line:




A new Gatling Enterprise simulation will be started every time the job is run. Check the Console Log to see the advancement of the simulation. If the simulation ran successfully, it will look like the following:

Console Log

When the job run is finished, you will be able to see on the Gatling Enterprise Results tab, the summary of the Gatling Enterprise simulation.

Display results

Edit this page on GitHub