Locust

Locust is a simple Python-based load test tool. It can run with and without web UI, also it supports standalone and master/slave modes. User can write tests with a small set of APIs provided by Locust, and then run the tests in Locust by specifying number of tests to run, the speed of test etc. The test result can be viewed on web UI or from an output file. See the tool's wiki page at https://docs.locust.io for more details. Also an informative blog comparing JMeter with Locust is on https://www.blazemeter.com/blog/jmeter-vs-locust-which-one-should-you-choose.

Installation

The following steps is to install Locust in a container running on ONAP Robot VM

ubuntu@onap-robot:~/locust$ sudo docker run --name locustio -d -p 8089:8089 ubuntu:16.04
ubuntu@onap-robot:~/locust$ sudo docker exec -it locustio bash
root@26a6a1c758b4:/# apt-get update && apt-get -y upgrade
root@26a6a1c758b4:/# apt-get install python-pip
root@26a6a1c758b4:/# pip install locustio

Write Test

Write a test in a file called locustfile.py. The following example uses Locust APIs to send an E2E service instantiation request to SO:

root@26a6a1c758b4:/# cat locustfile.py
import random
import string
from locust import HttpLocust, TaskSet, task

class UserBehavior(TaskSet):
    def on_start(self):
        """ on_start is called when a Locust start before any task is scheduled """
        self.init()

    def init(self):
		pass

    @task(1)
    def DCI(self):
        method = "POST"
		url = "/ecomp/mso/infra/e2eServiceInstances/v3"
		headers = {"Accept":"application/json","Content-Type":"application/json","Authorization":"Basic SW5mcmFQb3J0YWxDbGllbnQ6cGFzc3dvcmQxJA=="}
		service_instance_name = ''.join(random.choice(string.ascii_uppercase + string.digits) for _ in range(10))
		data = "{\"service\": {\"name\": \"E2E_volte_%s\", \"description\": \"E2E_volte_ONAP_deploy\", \"serviceDefId\": \"a16eb184-4a81-4c8c-89df-c287d390315a\", \"templateId\": \"012c3446-51db-4a2a-9e64-a936f10a5e3c\", \"parameters\": { \"globalSubscriberId\": \"Demonstration\", \"subscriberName\": \"Demonstration\", \"serviceType\": \"vIMS\", \"templateName\": \"VoLTE e2e Service:null\", \"resources\": [ { \"resourceName\": \"VL OVERLAYTUNNEL\", \"resourceDefId\": \"671d4757-b018-47ab-9df3-351c3bda0a98\", \"resourceId\": \"e859b0fd-d928-4cc8-969e-0fee7795d623\", \"nsParameters\": { \"locationConstraints\": [], \"additionalParamForNs\": { \"site2_vni\": \"5010\", \"site1_localNetworkAll\": \"false\", \"site1_vni\": \"5010\", \"site1_exportRT1\": \"11:1\", \"description\": \"overlay\", \"site2_localNetworkAll\": \"false\", \"site1_routerId\": \"9.9.9.9\", \"site1_fireWallEnable\": \"false\", \"site1_networkName\": \"network1\", \"site2_description\": \"overlay\", \"site1_importRT1\": \"11:1\", \"site1_description\": \"overlay\", \"site2_networkName\": \"network3\", \"name\": \"overlay\", \"site2_fireWallEnable\": \"false\", \"site2_id\": \"ZTE-DCI-Controller\", \"site2_routerId\": \"9.9.9.9\", \"site2_importRT1\": \"11:1\", \"site2_exportRT1\": \"11:1\", \"site2_fireWallId\": \"false\", \"site1_id\": \"DCI-Controller-1\", \"tunnelType\": \"L3-DCI\" } } } ] } } }" % service_instance_name
		print(data)
        response = self.client.request(method, url, headers=headers, data=data)
		print(response.json())

class WebsiteUser(HttpLocust):
    task_set = UserBehavior
    min_wait = 5000
    max_wait = 9000

Run the Test

First start Locust with web UI

root@26a6a1c758b4:/# locust -f ./locustfile.py --host=http://10.0.5.1:8080

Then you can specify the number of the concurrent users and the rate to spawn up those users on UI, and start the test

After you stop the test, you can view the results on UI or download results in CSV format

You can also run the test without web UI by specifying parameters including result output filename

There's also an ability to insert the host into the locust file, Use the same file and edit the section with the below:

class WebsiteUser(HttpLocust):
task_set = UserBehavior
host = "http://10.0.5.1:8080"