478a12bcb7
We now check the specified benchmark filter expression against the JUnit class to make sure JMH does not spin up benchmark classes that are different than the actual JUnit class.
Benchmarks
Benchmarks are based on JMH.
Running Benchmarks
To run the benchmarks with default settings use:
mvn clean test
A basic report will be printed to the CLI.
# Run complete. Total time: 00:00:15
Benchmark Mode Cnt Score Error Units
MappingMongoConverterBenchmark.readObject thrpt 10 1920157,631 ± 64310,809 ops/s
MappingMongoConverterBenchmark.writeObject thrpt 10 782732,857 ± 53804,130 ops/s
Running all Benchmarks of a specific class
To run all Benchmarks of a specific class, just provide its simple class name via the benchmark command line argument.
mvn clean test -D benchmark=MappingMongoConverterBenchmark
Running a single Benchmark
To run a single Benchmark provide its containing class simple name followed by # and the method name via the benchmark command line argument.
mvn clean test -D benchmark=MappingMongoConverterBenchmark#readObjectWith2Properties
Saving Benchmark Results
A detailed benchmark report is stored in JSON format in the /target/reports/performance directory.
To store the report in a different location use the benchmarkReportDir command line argument.
MongoDB
Results can be directly piped to MongoDB by providing a valid Connection String via the publishTo command line argument.
mvn clean test -D publishTo=mongodb://127.0.0.1:27017
NOTE: If the uri does not explicitly define a database the default spring-data-mongodb-benchmarks is used.
HTTP Endpoint
The benchmark report can also be posted as application/json to an HTTP Endpoint by providing a valid URl via the publishTo command line argument.
mvn clean test -D publishTo=http://127.0.0.1:8080/capture-benchmarks
Customizing Benchmarks
Following options can be set via command line.
| Option | Default Value |
|---|---|
| warmupIterations | 10 |
| warmupTime | 1 (seconds) |
| measurementIterations | 10 |
| measurementTime | 1 (seconds) |
| forks | 1 |
| benchmarkReportDir | /target/reports/performance (always relative to project root dir) |
| benchmark | .* (single benchmark via classname#benchmark) |
| publishTo | [not set] (mongodb-uri or http-endpoint) |