mirror of
https://github.com/fluencelabs/tendermint
synced 2025-04-25 06:42:16 +00:00
8b7ca8fd99
* Update to using go mod from dep * Remove references to make get_vendor_deps * Specify go version * Set GO111MODULE=on and add -mod=readonly * Fix exported env * switch to using go1.12 everywhere * Fix test scripts * Typo: * Prepend GO111MODULE=on * remove dep cache * Revert "remove dep cache" This reverts commit 45117bda Signed-off-by: Ismail Khoffi <Ismail.Khoffi@gmail.com> * bring back the dependency cache and change it to cache modules instead of vendored deps; also: - bump version for dependency cache - bump version on pkg-cache (includes modules directory) Signed-off-by: Ismail Khoffi <Ismail.Khoffi@gmail.com> * remove some more traces of dep: - remove Gopkg.(toml | lock) - update contributing guidlines - set global default in circleci (GO111MODULE=on) Signed-off-by: Ismail Khoffi <Ismail.Khoffi@gmail.com> * global var failed for `test_cover` with `go: unknown environment setting GO111MODULE=true` although the var was `GO111MODULE: on` Signed-off-by: Ismail Khoffi <Ismail.Khoffi@gmail.com> * Changelog pending entry Signed-off-by: Ismail Khoffi <Ismail.Khoffi@gmail.com> * Add bbolt dependency to go.mod Signed-off-by: Ismail Khoffi <Ismail.Khoffi@gmail.com> * move -mod=readonly to build flags
80 lines
2.0 KiB
Markdown
80 lines
2.0 KiB
Markdown
# tm-bench
|
|
|
|
Tendermint blockchain benchmarking tool:
|
|
|
|
- [https://github.com/tendermint/tendermint/tree/master/tools/tm-bench](https://github.com/tendermint/tendermint/tree/master/tools/tm-bench)
|
|
|
|
For example, the following:
|
|
|
|
```
|
|
tm-bench -T 10 -r 1000 localhost:26657
|
|
```
|
|
|
|
will output:
|
|
|
|
```
|
|
Stats Avg StdDev Max Total
|
|
Txs/sec 818 532 1549 9000
|
|
Blocks/sec 0.818 0.386 1 9
|
|
```
|
|
|
|
## Quick Start
|
|
|
|
[Install Tendermint](../introduction/install.md)
|
|
This currently is setup to work on tendermint's develop branch. Please ensure
|
|
you are on that. (If not, update `tendermint` and `tmlibs` in gopkg.toml to use
|
|
the master branch.)
|
|
|
|
then run:
|
|
|
|
```
|
|
tendermint init
|
|
tendermint node --proxy_app=kvstore
|
|
```
|
|
|
|
```
|
|
tm-bench localhost:26657
|
|
```
|
|
|
|
with the last command being in a seperate window.
|
|
|
|
## Usage
|
|
|
|
```
|
|
tm-bench [-c 1] [-T 10] [-r 1000] [-s 250] [endpoints]
|
|
|
|
Examples:
|
|
tm-bench localhost:26657
|
|
Flags:
|
|
-T int
|
|
Exit after the specified amount of time in seconds (default 10)
|
|
-c int
|
|
Connections to keep open per endpoint (default 1)
|
|
-r int
|
|
Txs per second to send in a connection (default 1000)
|
|
-s int
|
|
Size per tx in bytes
|
|
-v Verbose output
|
|
```
|
|
|
|
## How stats are collected
|
|
|
|
These stats are derived by having each connection send transactions at the
|
|
specified rate (or as close as it can get) for the specified time. After the
|
|
specified time, it iterates over all of the blocks that were created in that
|
|
time. The average and stddev per second are computed based off of that, by
|
|
grouping the data by second.
|
|
|
|
To send transactions at the specified rate in each connection, we loop
|
|
through the number of transactions. If its too slow, the loop stops at one second.
|
|
If its too fast, we wait until the one second mark ends. The transactions per
|
|
second stat is computed based off of what ends up in the block.
|
|
|
|
Each of the connections is handled via two separate goroutines.
|
|
|
|
## Development
|
|
|
|
```
|
|
make test
|
|
```
|