There are many C++ RESTful frameworks available. This document aims to provide a multidimensional comparison of the most popular ones. The chosen frameworks are:
- C++ REST SDK (https://github.com/microsoft/cpprestsdk) v2.10.15
- Crow (https://github.com/ipkn/crow) v0.1
- HttpLib (https://github.com/yhirose/cpp-httplib) v0.5.8
- Pistache (http://pistache.io/) - v0.0.002
- Restbed (https://github.com/Corvusoft/restbed) v4.6
- Restinio (https://stiffstream.com/en/products/restinio.html) v0.6.2
Each framework has been used to create a basic REST services. All services are equivalent and contain 3 endpoints:
/test
- handles POST message (JSON) and sends it back with additional text and status code 200./test/status
- handles GET message and prints "OK"./test/labels/<string>
- handles GET message with parameter.
The /test
endpoint was used for testing performance. There were 5 testing parameters used to test various aspects:
- A number of producer threads P. They represented unique clients attempting to send message to the service. For all tescases P=10.
- A number of consumer threads C. This was the number of threads used by the service. Two values were tested:
- C=28 (corresponding to the value of
hardware_concurrency()
on the machine used to run tests. - C=4 - arbitrarily chosen value smaller than P, to test service queueing.
- C=28 (corresponding to the value of
- A number of messages N sent by a producer. Values: 200 and 1000.
- Processing time t necessary to handle the request. Values: 0ms and 200ms.
- Environment. Two values were used:
- "Local" - clients and the service were located on the same machine
- "VPN" - clients and the service were located on different machines connected by a VPN.
A testcase is any combination of above parameters. There could be in total 16 testcases, but testcases for N=200 and t=0ms. were intentionally excluded as not providing any new information.
Services were deployed on the following system:
- Processor: 28x Intel Xeon CPU E5-2660 v4 @ 2.0 GHz
- Memory: 64 GB
- OS: Ubuntu 16.04.3 LTS
All services logged the reception of message and response with millisecond precision. The tables contain time (min:sec.ms) from the reception of the first request to the last reply. The best times are marked in green, the worst in red. Let's number the tests:
- from 1 to 4 in the top-right table,
- from 5 to 8 in the bottom-left table
- from 9 to 12 in the bottom-right table.
Red x
means that the service run into deadlock and test could not be finished.
- Cpp-REST-SDK apparently has problems to handle situations when C < P.
- In the sprint testcases (Local environment, 0ms delay - top right table) the best performance was achieved by Restinio which was over 3 times faster than the worst Cpp-REST-SDK followed by Httplib. It is worth to notice that for some frameworks the best results were achieved using the limited threadpool. It can be explained that if requests require very little processing time, handling of threads themselves becomes noticable compared to other tasks.
- In the Local environment, when request require some processing (bottom tables, white areas), performance of all frameworks is similar. There is no clear winner, but two frameworks slightly fall behind: Restbed, when services run at full power (C=28), and Pistache, when the threads are limited.
- Situation changes in the VPN environment, which introduces some time overhead. For most services, at full power, this overhead is linear and about 105 sec. per 1000 requests, as can be seen comparing tests 1 with 3, 5 with 7 and 9 with 11, with exception of Httplib, whose VPN overhead is twice as high (210 sec. per 1000 requests).
- For no delay cases (top-right table), limiting the number of threads does not degrade the performance of most frameworks, actually it can even slightly improve it, as marked in point 2. Only Httplib stands out, having the biggest degradation of performance between testcases 2 and 4. Changing environment from Local to VPN at C=4 introduced about 367 sec. overhead, visible also between testcases 10 and 12. Limiting the number of requests to 20% (testcases 6 and 8) reduces the VPN overhead of Httplib to 73.5 sec., which indicates that for C=4 this overhead is still linear at rate 367 per 1000 requests.
- For most of other frameworks the VPN overhead seems to be shadowed by the 200ms request processing time t. Only Pistache is still affected by such overhead (at rate 110 sec per 1000 requests), but only for C=4.
Below table summarizes other features of analyses frameworks that can be interesting for a professional development.
Only Restbed's AGPL license may be problematic for some companies, which would like to use this framework for its products and tools.
"Ease of including" is a subjective measure describing how easy for me was to get the framework, build it, manage its dependecies and integrate it with existing package management systems, that companies may use. The highest scores got Crow and Httplib for header only libraries ensuring the easiest integration. Restinio got the lowest score, since I was not able to overcome a problem with its dependencies using just apt tool on Ubuntu Xenial (Stiffstream/restinio#86).
"Ease of using" is another subjective measure describing how easy for me was to build the basic service. Again Crow and Httplib got highest scores, together with Pistache. These libraries provide us with many useful primitives to build a service, helpful examples and the amount of boilerplate code is reduced to minimum. The lowest score goes to Cpp-REST-SDK, which seems to be overcomplicated and the simplest tasks require diving deep into the documentation and writing lots of own code. Restinio was in the middle. It may be a little overcomplicated too, but provides many useful examples and after a while you can get the idea.
This repository contains 6 basic services used for this test. Anyone is enouraged to use them for verification of above results or running own tests. Each service is a Cmake project, which can be built separately.
Before building the benchmark projects, its dependencies need to be installed. You may install them in the system or locally - in that case use -DCMAKE_PREFIX_PATH=<>
can be used to indicate the location of libraries in the next step. All projects use https://github.com/log4cplus/log4cplus to provide consistent logging with millisecond precision. Also:
- basic-cpprestsdk requires installed CPP-REST-SDK, Boost and OpenSSL
- basic-crow requires Boost only, as the project already contains
crow_all.h
header file. - basic-httplib requires nothing, as the project already contains the header file.
- basic-pistache requires built and installed static version of Pistache.
- basic-restbed requires installed Restbed.
- basic-restinio requires Conan and adding its conan repository in the way described here: https://stiffstream.com/en/docs/restinio/0.6/obtaining.html#id2.
cd basic-xxx
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make
After building, place the logger-config.ini
in the folder containing the binaries.
To run a service use:
$ ./basic-xxx [t (ms.)] [C]
t is the simulated time of handling a request, C is the number of threads in the threadpool. Parameters are positional and optional. Default value for C is hardware_concurrency()
and for t is 0. basic-httplib accepts only single parameter t, as the number of threads is chosen at compilation time (see basic-httplib/main.cpp
).
To simulate clients, a python script postInLoop.py
was used. Run:
$ python3 postInLoop.py -h
for usage.