The open source, pluggable, nosql benchmarking suite.
Go to file
Jonathan Shook 3586c3ae99
Merge pull request #1773 from nosqlbench/snyk-upgrade-8bf908fcba73a5b4b98f8913dae7c67b
[Snyk] Upgrade com.amazonaws:aws-java-sdk-dynamodb from 1.12.610 to 1.12.622
2024-01-16 19:33:34 -06:00
.github testing workflow fixes 2024-01-02 12:36:03 -06:00
.idea/scopes update TODO scopes 2023-10-23 08:42:19 -05:00
.run stability detection in progress 2023-11-01 11:09:16 -05:00
adapter-amqp add docs to metrics construction 2023-12-20 17:16:40 -06:00
adapter-cqld4 Merge pull request #1760 from cognitree/warn-scb-not-found 2024-01-11 15:16:10 -06:00
adapter-diag move simrate to its own package 2024-01-02 11:34:05 -06:00
adapter-dynamodb fix: adapter-dynamodb/pom.xml to reduce vulnerabilities 2024-01-12 17:23:03 +00:00
adapter-http fix: upgrade io.swagger.core.v3:swagger-core from 2.2.19 to 2.2.20 2024-01-12 17:22:56 +00:00
adapter-jdbc package factoring 2023-12-09 17:16:44 -06:00
adapter-kafka Merge pull request #1741 from nosqlbench/snyk-upgrade-84f5b180df8fc1feb870572a5e5f13b9 2024-01-02 11:36:36 -06:00
adapter-mongodb Merge branch 'main' into jshook/talk-improvements 2023-12-15 11:12:02 -08:00
adapter-pinecone package factoring 2023-12-09 17:16:44 -06:00
adapter-pulsar fix: upgrade org.apache.pulsar:pulsar-client-admin from 3.1.1 to 3.1.2 2024-01-10 15:04:47 +00:00
adapter-s4j typo fixes 2023-12-22 13:36:54 -06:00
adapter-stdout package factoring 2023-12-09 17:16:44 -06:00
adapter-tcp package factoring 2023-12-09 17:16:44 -06:00
adapters-api make labels and tags for nb5.21 canonical 2024-01-16 18:42:26 -06:00
devdocs remove deprecated CommandTemplate 2023-12-08 19:37:06 -06:00
docsys Merge pull request #1769 from nosqlbench/snyk-upgrade-25476a2fa3b7f0c55819df5671f0ae31 2024-01-16 19:32:45 -06:00
engine-cli allow atfiles to relativize for ${DIR} patterns 2024-01-11 16:48:47 -06:00
engine-clients provide better diagnostics for interrupted annotation post 2023-12-15 23:10:48 -06:00
engine-core fail fast on command errors in session 2024-01-12 01:02:54 -06:00
engine-extensions package factoring 2023-12-09 17:16:44 -06:00
mvn-defaults Merge pull request #1767 from nosqlbench/snyk-upgrade-ef0d9c9c53f4a1fe50d9d9d70087b81b 2024-01-16 19:32:52 -06:00
nb5 remove venice adapter unless or until it is resumed, parked under a separate branch 2023-09-28 14:46:09 -05:00
nb5-proof cleanups and minor docs 2023-10-23 08:42:19 -05:00
nb-annotations checkpoint 2023-10-23 08:42:19 -05:00
nb-api misc improvements 2024-01-11 12:54:04 -06:00
nb-spectest fix: upgrade com.vladsch.flexmark:flexmark-html2md-converter from 0.64.6 to 0.64.8 (#1339) 2023-06-16 15:06:23 -05:00
nbr additional NaN safety 2024-01-12 01:03:12 -06:00
nbr-examples Single entry point for NBCLI parser 2024-01-10 14:41:15 -06:00
scripts add release trigger 2023-02-15 18:23:52 -06:00
sort_docs doc: old docs to be sorted 2021-09-13 09:56:47 -05:00
virtdata-api remainder of changes for scenario rework that need to be itemized 2023-12-06 14:26:53 -06:00
virtdata-lang change all references of context to container 2023-12-07 09:40:40 -06:00
virtdata-lib-basics misc improvements 2024-01-11 12:54:04 -06:00
virtdata-lib-curves4 remainder of changes for scenario rework that need to be itemized 2023-12-06 14:26:53 -06:00
virtdata-lib-hdf5 fix package paths after merge 2023-12-06 14:56:47 -06:00
virtdata-lib-random remainder of changes for scenario rework that need to be itemized 2023-12-06 14:26:53 -06:00
virtdata-lib-realer data path correction 2023-02-07 19:16:02 -06:00
virtdata-realdata centralize jacoco template for reconfiguration 2023-01-26 23:32:15 -06:00
virtdata-userlibs make virtdata microbench easier to read 2023-12-10 22:07:11 -06:00
.all-contributorsrc docs: update .all-contributorsrc [skip ci] 2023-12-06 23:34:21 +00:00
.editorconfig [issue-65] add EditorConfig configuration file 2020-03-16 13:51:41 +01:00
.gitignore added .run shared folder 2023-10-26 20:33:35 -05:00
BUILDING.md Minor fix to BUILDING.md as Java baseline is 17, not 12 (as per mvn-defaults/pom.xml) 2022-05-13 09:10:23 -07:00
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md 2020-03-16 15:34:50 +00:00
CONTRIBUTING.md docs: update CONTRIBUTING.md [skip ci] 2023-12-06 23:34:20 +00:00
deploy.xml added deploy.xml 2020-03-10 02:56:24 -05:00
Dockerfile update java base runtime for Docker 2023-10-23 08:42:19 -05:00
DOWNLOADS.md Update DOWNLOADS.md 2023-01-24 15:00:49 -06:00
LICENSE.txt core project files 2020-03-16 08:41:22 -05:00
MODULES.md rename activitytype modules to driver modules 2020-05-05 11:29:30 -05:00
nb_521.md remainder of changes for scenario rework that need to be itemized 2023-12-06 14:26:53 -06:00
pom.xml remainder of changes for scenario rework that need to be itemized 2023-12-06 14:26:53 -06:00
PREVIEW_NOTES.md updated preview notes, updated notes path 2023-01-25 22:10:17 -06:00
README.md add sibling labels restriction and some docs 2023-10-23 16:45:10 -05:00
RELEASE_NOTES.md docs and scripts 2023-01-23 20:04:45 -06:00
release.xml fix missing release file 2020-06-17 17:48:09 -05:00

Maven Central Star on Github Chat on Discord

NoSQLBench 5

The Open Source, Pluggable, NoSQL Benchmarking Suite

👉 The current version of NoSQLBench in development is 5.21, which is based on Java 21 LTS. All new language features in Java 21, and some preview features may be used. There are significant improvements in this branch which will be documented before a main release is published. If you are presently using NoSQLBench for testing, and are not actively developing against the code base, it is recommended that you stay on the latest 5.17 release until an official 5.21 release is available. What's in store for 5.21.

Get it Here

Contribute to NoSQLBench

Read the Docs

What is NoSQLBench?

NoSQLBench is a serious performance testing tool for the NoSQL ecosystem. It brings together features and capabilities that are not found in any other tool.

  • You can run common testing workloads directly from the command line. You can start doing this within 5 minutes of reading this.
  • You can generate virtual data sets of arbitrary size, with deterministic data and statistically shaped values.
  • You can design custom workloads that emulate your application, contained in a single file, based on statement templates - no IDE or coding required.
  • When needed, you can open the access panels and rewire the runtime behavior of NoSQLBench to do advanced testing, including a full scripting environment with Javascript.

The core machinery of NoSQLBench has been built with attention to detail. It has been battle tested within DataStax and in the NoSQL ecosystem as a way to help users validate their data models, baseline system performance, and qualify system designs for scale.

In short, NoSQLBench wishes to be a programmable power tool for performance testing. However, it is somewhat generic. The core runtime of NoSQLBench doesn't know directly about a particular type of system, or protocol. It simply provides a suitable machine harness in which to put your drivers and testing logic. If you know how to build a client for a particular kind of system, it will let you load it like a plugin and control it dynamically. However, several protocols are supported out of the box as bundled drivers.

Origins

The code in this project comes from multiple sources. The procedural data generation capability was known before as 'Virtual Data Set' OSS project. The core runtime and scripting harness was from the 'EngineBlock' OSS project. The CQL driver module was previously used within DataStax. In March of 2020, DataStax and the project maintainers for these projects decided to put everything into one OSS project in order to make contributions and sharing easier for everyone. Thus, the new project name and structure was launched as nosqlbench.io. NoSQLBench is an independent project that is sponsored by DataStax.

We offer NoSQLBench as a new way of thinking about testing systems. It is not limited to testing only one type of system. It is our wish to build a community of users and practice around this project so that everyone in the NoSQL ecosystem can benefit from common concepts and understanding and reliable patterns of use.

Getting Support

In general, our goals with NoSQLBench are to make the help systems and examples wrap around the users like a suit of armor, so that they feel capable of doing most things autonomously. Please keep this in mind when looking for personal support form our community, and help us find those places where the docs are lacking. Maybe you can help us by adding some missing docs!

NoSQLBench Discord Server

We have a discord server. This is where users and developers can discuss anything about NoSQLBench and support each other. Please join us there if you are a new user of NoSQLBench!

Contributing

We are actively looking for contributors to help make NoSQLBench better. This is an ambitious project that is just finding its stride. If you want to be part of the next chapter in NoSQLBench development please look at CONTRIBUTING for ideas, and jump in where you feel comfortable.

All contributors are expected to abide by the CODE_OF_CONDUCT.

License

All of the code in this repository is licensed under the APL version 2. If you contribute to this project, then you must agree to license all of your contributions under this license.

System Compatibility

This is a Linux targeted tool, as most cloud/nosql testing is done on Linux instances. Some support for other systems is available, but more work is needed to support them fully. Here is what is supported for each:

  1. on Linux, all features are supported, for both nb5.jar as well as the appimage binary nb
  2. on Mac, all features are supported, with nb5.jar.
  3. on Windows, all features are supported, with nb5.jar.

Thanks

DataStax This project is sponsored by DataStax -- The Open, Multi-Cloud Stack for Modern Data Apps built on Apache Cassandra™, Kubernetes *Based*, Developer *Ready* & Cloud *Delivered* and designed from the ground up to run anywhere, on any cloud, in any datacenter, and in every possible combination. DataStax delivers the ultimate hybrid and multi-cloud database.
YourKit Logo This project uses tools provided by YourKit, LLC. YourKit supports open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.

Contributors

Checkout all our wonderful contributors here.