sltbench

C++ benchmark tool. Practical, stable and fast performance testing framework.

• practical - came up from daily production tasks. Usability matters
• stable - correctness and reproducibility is a goal
• fast - if results are stable, they should be produced as soon as possible

This tool is trained to gain about 5% measure stability (depends on function,
input and context). Of course, it cannot strongly guarantee 5% stability (some
functions are unstable itself, nothing helps), but it tends to.

Why sltbench

The closest and the most famous analogue is googlebench - microbenchmarking
library from Google engineers.

Key features of sltbench are:

• sltbench is about 4.7x times faster than googlebench (test execution time).
• sltbench produces results with less timing error, which matters for
  performance results reproducibility. About 5x times improvement for testing
  dataset.
• Supports correct mutable fixtures.
• Supports lazy arguments generation including reading from file,
  autogeneration etc.. (critical for large input datasets which does not fit
  into RAM all together)
• Output customization, separate tools for performance results comparison and
  more.

measure time

(Results below are obtained on 4 cores i7-2600 CPU @ 3.40GHz, 8Gb RAM
for sltbench dataset; see "Metrics" section for details; see
How to benchmark section for instructions)

4.7x times speedup might be useful for projects with big performance tests count. For the original project regression performance testing tooks about a week and testing time reduction matters.

Less relative error means:

• Less false speedups/slowdowns you get during testing. Economy of developer
  time.
• More precise performance changes may be obtained. If testing tool provides
  15% relative error than 10% speedup couldn't be measured.

compilation time

Sltbench contains improvements on compilation time of benchmarks (not library!)
for the most popular api since 2.4.0. Benchmarks for functions without arguments
and driver launch might be implemented in a more lightweight manner. See
Advanced user guide for explanation how to reuse
improvements.

(benchcompile metric results below are obtained on Intel(R) Core(TM) i5-8400 CPU
@ 2.80GHz, clang-6.0.0, dataset=simple for optimized cases only)

Motivating example

The following code registers my_function for timing. Just compile it (do not
forget about includes) and the executable file will test my_function for
performance.

void my_function()
{
	std::vector<size_t> v(100000, 0);
	std::sort(v.begin(), v.end());
}

SLTBENCH_FUNCTION(my_function);

SLTBENCH_MAIN();

Documentation

• Build instructions
• Examples
• How to benchmark - follow this
  instruction before you run any performance test
• How to analyse performance results
• How to compare performance results
• Advanced command line options
• Advanced user guide
• Critical metrics for sltbench project and evaluation tools

License

sltbench is released under the Apache 2.0 license