Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

...

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

Code Block
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

Run First start Locust with web UI

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


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

...

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

Code Block
root@26a6a1c758b4:/# locust -f ./locustfile.py --host=http://10.0.5.1:8080 --csv=foobar --no-web -c 2 -r 1 -n 5

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"