Locust.io

note

Some of the metrics wont be available with Locust.io as it does not provide them, eg: latency, connection time and others.

You have two options here - generate CSV file and upload it to the application, or use jtl listener service and upload the results continuously while running your test.

note

Please note that the below-mentioned listeners currenty support only distributed mode.

Generating and uploading JTL file

Download jtl_listener.py into your locust project folder.

Register the listener in your locust test by placing event listener at the very end of the file:

from jtl_listener import JtlListener
...

@events.init.add_listener
def on_locust_init(environment, **_kwargs):
    JtlListener(env=environment,  project_name="project name",
                scenario_name="scenario name",
                environment="tested envitonment",
                backend_url="http://IP_ADDRESS")

Generate api token in the application and set it as JTL_API_TOKEN env variable.

After the test finishes you will find a jtl file in logs folder.

Continuous results uploading

Download jtl_listener_service.py into your locust project folder.

Register the listener in your locust test by placing event listener at the very end of the file:

from jtl_listener_service import JtlListener

...

@events.init.add_listener
def on_locust_init(environment, **_kwargs):
    JtlListener(env=environment,  project_name="project name",
                scenario_name="scenario name",
                hostname="hostname",
                backend_url="http://IP_ADDRESS")

Generate api token in the application and set it as JTL_API_TOKEN env variable.

Once you run your test, the plugin will start uploading results to jtl listener service.