org.apache.hadoop.hive.metastore.tools

Class MicroBenchmark

java.lang.Object

org.apache.hadoop.hive.metastore.tools.MicroBenchmark

public class MicroBenchmark
extends Object

Micro-benchmark some piece of code.

Every benchmark has three parts:

• Optional pre-test
• Mandatory test
• Optional post-test

Measurement consists of the warm-up phase and measurement phase. Consumer can specify number of times the warmup and measurement is repeated.

All time is measured in nanoseconds.

Constructor Summary

Constructors

Constructor and Description
MicroBenchmark() Create default micro benchmark measurer
MicroBenchmark(int warmup, int iterations) Create micro benchmark measurer.

Method Summary

Modifier and Type	Method and Description
org.apache.commons.math3.stat.descriptive.DescriptiveStatistics	measure(@NotNull Runnable test) Run the benchmark and measure run-time statistics in nanoseconds.
org.apache.commons.math3.stat.descriptive.DescriptiveStatistics	measure(@Nullable Runnable pre, @NotNull Runnable test, @Nullable Runnable post) Run the benchmark and measure run-time statistics in nanoseconds.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MicroBenchmark

public MicroBenchmark()

Create default micro benchmark measurer

MicroBenchmark

public MicroBenchmark(int warmup,
                      int iterations)

Create micro benchmark measurer.

Parameters:

warmup - number of test calls for warmup

iterations - number of test calls for measurement

Method Detail

measure

public org.apache.commons.math3.stat.descriptive.DescriptiveStatistics measure(@Nullable
                                                                               @Nullable Runnable pre,
                                                                               @NotNull
                                                                               @NotNull Runnable test,
                                                                               @Nullable
                                                                               @Nullable Runnable post)

Run the benchmark and measure run-time statistics in nanoseconds.

Before the run the warm-up phase is executed.

Parameters:

pre - Optional pre-test setup

test - Mandatory test

post - Optional post-test cleanup

Returns:

Statistics describing the results. All times are in nanoseconds.

measure

public org.apache.commons.math3.stat.descriptive.DescriptiveStatistics measure(@NotNull
                                                                               @NotNull Runnable test)

Run the benchmark and measure run-time statistics in nanoseconds.

Before the run the warm-up phase is executed. No pre or post operations are executed.

Parameters:

test - test to measure

Returns:

Statistics describing the results. All times are in nanoseconds.