go-web-framework-benchmark

This benchmark suite aims to compare the performance of Go web frameworks. It is inspired by Go HTTP Router Benchmark but this benchmark suite is different with that. Go HTTP Router Benchmark suit aims to compare the performance of routers but this Benchmark suit aims to compare whole HTTP request processing.

Last Test Updated: 2020-05

test environment

CPU: QEMU Virtual CPU version(1.8GHZ, 8 cores)
Memory: 16G
Go: go1.16.3 linux/amd64
OS: CentOS Linux release 7.5.1804 (Core)

Tested web frameworks (in alphabetical order)

Only test those webframeworks which are stable

ace
atreugo
baa
beego
bone
chi
clevergo
default http
denco
echo
fasthttp-routing
fasthttp/router
fasthttp
fasthttprouter
fastRouter
fiber
flygo
gear
gearbox
gem
gin
goframe
go-json-rest
go-ozzo
go-restful
go-tigertonic
goji
goji
golf
gongular
gorilla
gorouter
goyave
~~gramework~~:its init function pollutes the test so it has been removed from test.
httprouter
httptreemux
lars
lion
macaron
martini
muxie
negroni
neo
pat
pure
r2router
siris
tango
tinyrouter
traffic
treemux
violetear
vulcan
webgo

Motivation

When I investigated performance of Go web frameworks, I found Go HTTP Router Benchmark, created by Julien Schmidt. He also developed a high performance http router: httprouter. I had thought I got the performance result until I created a piece of codes to mock the real business logics:

api.Get("/rest/hello", func(c *XXXXX.Context) {
	sleepTime := strconv.Atoi(os.Args[1]) //10ms
	if sleepTime > 0 {
		time.Sleep(time.Duration(sleepTime) * time.Millisecond)
	}

	c.Text("Hello world")
})

When I use the above codes to test those web frameworks, the token time of route selection is not so important in the whole http request processing, although performance of route selection of web frameworks are very different.

So I create this project to compare performance of web frameworks including connection, route selection, handler processing. It mocks business logics and can set a special processing time.

The you can get some interesting results if you use it to test.

Implementation

When you test a web framework, this test suit will starts a simple http server implemented by this web framework. It is a real http server and only contains GET url: "/hello".

When this server processes this url, it will sleep n milliseconds in this handler. It mocks the business logics such as:

read data from sockets
write data to disk
access databases
access cache servers
invoke other microservices
……

It contains a test.sh that can do those tests automatically.

It uses wrk to test.

Basic Test

The first test case is to mock 0 ms, 10 ms, 100 ms, 500 ms processing time in handlers.

the concurrency clients are 5000.

Latency is the time of real processing time by web servers. The smaller is the better.

Allocs is the heap allocations by web servers when test is running. The unit is MB. The smaller is the better.

If we enable http pipelining, test result as below:

Concurrency Test

In 30 ms processing time, the test result for 100, 1000, 5000 clients is:

If we enable http pipelining, test result as below:

cpu-bound case Test

Usage

You should install this package first if you want to run this test.

go get github.com/smallnest/go-web-framework-benchmark

It takes a while to install a large number of dependencies that need to be downloaded. Once that command completes, you can run:

cd $GOPATH/src/github.com/smallnest/go-web-framework-benchmark
go build -o  gowebbenchmark *.go
./test.sh

It will generate test results in processtime.csv and concurrency.csv. You can modify test.sh to execute your customized test cases.

If you also want to generate latency data and allocation data, you can run the script:

./test-latency.sh

If you don't want use keepalive, you can run:

./test-latency-nonkeepalive.sh

If you want to test http pipelining, you can run:

./test-pipelining.sh

If you want to test some of web frameworks, you can modify the test script and only keep your selected web frameworks:

……
web_frameworks=( "default" "ace" "beego" "bone" "denco" "echov1" "echov2standard" "echov2fasthttp" "fasthttp-raw" "fasthttprouter" "fasthttp-routing" "gin" "gocraftWeb" "goji" "gojiv2" "gojsonrest" "gorestful" "gorilla" "httprouter" "httptreemux" "lars" "lion" "macaron" "martini" "pat" "r2router" "tango" "tiger" "traffic" "violetear" "vulcan")
……

If you want to test all cases, you can run:

./test-all.sh

Plot

you can run the shell script plot.sh in testresults directory and it can generate all images in its parent directory.

Add new web framework

Welcome to add new Go web frameworks. You can follow the below steps and send me a pull request.

add your web framework link in README
add a hello implementation in server.go
add your webframework in libs.sh

Please add your web framework alphabetically.

admpub/go-web-framework-benchmark