boomer

Links

• Locust Website: locust.io
• Locust Documentation: docs.locust.io

Description

Boomer is a better load generator for locust, written in golang. It can spawn thousands of goroutines to run your code concurrently.

It will listen and report to the locust master automatically, your test results will be displayed on the master's web UI.

Install

go get github.com/myzhan/boomer

With zeromq support

Install goczmq by following its installation guide, and build boomer with zeromq support. Once you build boomer with zeromq support, both zeromq socket and tcp socket are supported. We add an additional command line option "--rpc", which defaults to "zeromq". "--rpc=socket" will switch to tcp socket.

Without zeromq support

If you are new to boomer, and want to give it a try as fast as you can. You can build boomer without zeromq support.

Examples(main.go)

Below is a example of boomer's API. You can find more in "examples" directory.

package main


import "github.com/myzhan/boomer"
import "time"


func foo(){
    time.Sleep(100 * time.Millisecond)
    /*
    Report your test result as a success, if you write it in locust, it will looks like this
    events.request_success.fire(request_type="http", name="foo", response_time=100.0, response_length=10)
    */
    boomer.Events.Publish("request_success", "http", "foo", 100.0, int64(10))
}


func bar(){
    time.Sleep(100 * time.Millisecond)
    /*
    Report your test result as a failure, if you write it in locust, it will looks like this
    events.request_failure.fire(request_type="udp", name="bar", response_time=100.0, exception=Exception("udp error"))
    */
    boomer.Events.Publish("request_failure", "udp", "bar", 100.0, "udp error")
}


func main(){

    task1 := &boomer.Task{
        Name: "foo",
        Weight: 10,
        Fn: foo,
    }

    task2 := &boomer.Task{
        Name: "bar",
        Weight: 20,
        Fn: bar,
    }

    boomer.Run(task1, task2)

}

Usage

For debug purpose, you can run tasks without connecting to the master.

go build -o a.out main.go
./a.out --run-tasks foo,bar

If master is listening on zeromq socket.

locust -f dummy.py --master --master-bind-host=127.0.0.1 --master-bind-port=5557
# build boomer with zeromq support
go build -tags 'zeromq' -o a.out main.go 
./a.out --master-host=127.0.0.1 --master-port=5557 --rpc=zeromq

If master is listening on tcp socket.

locust -f dummy.py --master --master-bind-host=127.0.0.1 --master-bind-port=5557
go build -o a.out main.go
./a.out --master-host=127.0.0.1 --master-port=5557

So far, dummy.py is necessary when starting a master, because locust needs such a file.

Don't worry, dummy.py has nothing to do with your test.

License

Open source licensed under the MIT license (see LICENSE file for details).