TSPERF Time Series Database Benchmark Suite. Framework for evaluating and comparing the performance of time series databases, in the spirit of TimescaleDB's TSBS.
APACHE-2.0 License
TSPERF is a tool for evaluating and comparing the performance of time series databases, in the spirit of TimescaleDB's Time Series Benchmark Suite (TSBS).
» Documentation | Changelog | PyPI | Issues | Source code | License
The tsperf
program includes both a database workload generator, and a query
timer. That effectively spans two domains, one for writing data, and another
one for reading.
tsperf write --help
to explore its options.tsperf read --help
to explore its options.For the purpose of capacity testing, both domains try to simulate the generation and querying of time-series data. As the program is easy to use, it provides instant reward without the need to set up a whole data ingestion chain.
pip install --user tsperf
alias tsperf="docker run -it --rm --network=host ghcr.io/crate/tsperf:latest tsperf"
tsperf --help
Please refer to the usage documentation.
mkjson
combined with cr8 insert-json
makes it easy to generate random entries into a table.
See generate data sets using mkjson for an example how to use cr8
together with mkjson
.
The Time Series Benchmark Suite (TSBS) is a collection of Go programs that are used to generate datasets and then benchmark read and write performance of various databases.
We are always happy to receive code contributions, ideas, suggestions and problem reports from the community.
So, if you’d like to contribute you’re most welcome. Spend some time taking a look around, locate a bug, design issue or spelling mistake and then send us a pull request or open an issue on GitHub.
Thanks in advance for your efforts, we really appreciate any help or feedback.
Thanks to all the contributors who helped to co-create and conceive tsperf
in one way or another and kudos to all authors of the foundational libraries.
This project is licensed under the terms of the Apache 2.0 license.