Teamcity Plugin

Integrate your simulations to your TeamCity CI.

Purpose of this plugin

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

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


To download the plugin, you need to get the zip file located at:

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

Upload plugin


The plugin needs some global configuration. Go Administration, then FrontLine.

The Address is the address of your FrontLine, for example:

The API Token will allow TeamCity to authenticate to Gatling FrontLine, without the need of a username or password. To fetch it, refer to the section Managing API Tokens in the FrontLine User Guide.

Plan set-up

Add a new build step called FrontLine 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 your FrontLine to do this step.


JUnit reporting

You can display the results of the Gatling FrontLine 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 FrontLine simulation will be started every time the job is run. Check the Console Log to check the advancement of the simulation. If the simulation ran successfully, it will looks like the following:

Console Log

If the Gatling FrontLine deployment fails (ie because of a shortage of available hosts), the plugin will retry 3 times to redeploy the simulation.

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

Display results

Edit this page on GitHub