According to blockchain-performance-metrics, Probe is a web GUI application for Hyperledger Fabric mantianer, user, research. Recently, aims at providing a way to control both SUT and LGC to find the best block config logic for specific chaincode for specific fabric network. Meanwhile has a better understanding of how block config impacts performance.
- Probe provides loop test control for given block parameter arrays.
- Probe provides TPS result review via GUI.
- Probe provides sample chaincode for some test cases.
Long term goal for Probe is a coordinator between Test Harness or LGC, SUT.
- Probe will allow you design shell scripts to schedule SUT and Test Harness.
- Probe will allow you investigate performance matrix with GUI in customer way.
You can use Probe to ...HowToConfigFabricParameters
Sample run of Probe
- Install this project
npm install - Install fabric-sample environment
curl -vsS https://raw.githubusercontent.com/hyperledger/fabric/master/scripts/bootstrap.sh | bashNote If the above curl command fails, it may be that the old version of curl cannot handle redirection or cannot be redirected due to network reasons in
some countries and regions. At this time, users can download the bootstrap.sh script then run it.
- Get tape
docker pull ghcr.io/hyperledger-twgc/tape - Apply the bridge file to adjust block parameters for test network
cp sample/prepareConfig.sh fabric-samples/test-network npm start
- Access localhost:3000, click
- Click
- Access
localhost:3000/result/BatchTimeoutto see TPS relationship with BatchTimeout - Access
localhost:3000/result/MaxMessageCountto see TPS relationship with MaxMessageCount
If you want to try with docker usage, welcome to use
docker run -d --rm --name Probe -p 3000:3000 -v /var/run/docker.sock:/var/run/docker.sock -v $(pwd):/home/probe \ 19902439/probe:latest
it is based on alphine, and which means, you may need to make sure your minifab/fabric sample works instead, as install for configtxgen or able to use docker in docker.
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -s) - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
If your want to contribute Probe with new feature, bug fixing please create a new issue, of course with PR is best.
Also welcome for documentatoin, learning course, etc.
For development, please complete Quick start above.
For Frontend, please use npm run build.
For backend, please develop --DryRun as mock for unit test and adding real cases in CI
Hyperledger Project source code files are made available under the Apache License, Version 2.0 (Apache-2.0), located in the LICENSE file.
As discussed with TWGC performance work group, we found out that different block parameters, networks, chaincode language and chaincode logic having influence final TPS.
To answer, the best parameter for specific fabric network and fabric chaincode, this project been created.
- Real time time monitor, for real time tps monitor, pls use Prometheus. (But Probe has demo for it with test network here)
- Auto test framework for Fabric performance, as in probe, we will invoke as byfn or minifab for your network up/down/cleanup.
- Performance test tool for Fabric, for this we using tape.
- GUI for tape, tape focus on once off time performance testing.