Skip to content

Commit 05fdb97

Browse files
author
Antoine Riard
committed
[doc] Update and extend benchmarking.md
1 parent be0e8b4 commit 05fdb97

File tree

1 file changed

+22
-29
lines changed

1 file changed

+22
-29
lines changed

doc/benchmarking.md

Lines changed: 22 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -2,54 +2,47 @@ Benchmarking
22
============
33

44
Bitcoin Core has an internal benchmarking framework, with benchmarks
5-
for cryptographic algorithms (e.g. SHA1, SHA256, SHA512, RIPEMD160), as well as the rolling bloom filter.
5+
for cryptographic algorithms (e.g. SHA1, SHA256, SHA512, RIPEMD160, Poly1305, ChaCha20), rolling bloom filter, coins selection,
6+
thread queue, wallet balance.
67

78
Running
89
---------------------
10+
11+
For benchmarks purposes you only need to compile `bitcoin_bench`. Beware of configuring without `--enable-debug` as this would impact
12+
benchmarking by unlatching log printers and lock analysis.
13+
14+
make -C src bench_bitcoin
15+
916
After compiling bitcoin-core, the benchmarks can be run with:
1017

1118
src/bench/bench_bitcoin
1219

1320
The output will look similar to:
1421
```
1522
# Benchmark, evals, iterations, total, min, max, median
16-
Base58CheckEncode, 5, 320000, 120.772, 7.49351e-05, 7.59374e-05, 7.54759e-05
17-
Base58Decode, 5, 800000, 122.833, 3.0467e-05, 3.11732e-05, 3.06304e-05
18-
Base58Encode, 5, 470000, 137.094, 5.81061e-05, 5.85109e-05, 5.84462e-05
19-
BenchLockedPool, 5, 530, 34.2023, 0.0128247, 0.0129613, 0.0129026
20-
CCheckQueueSpeedPrevectorJob, 5, 1400, 26.1762, 0.00365048, 0.00388629, 0.00367108
21-
CCoinsCaching, 5, 170000, 48.1074, 5.60229e-05, 5.72316e-05, 5.66214e-05
22-
CoinSelection, 5, 650, 34.6426, 0.0105801, 0.0107699, 0.010664
23-
DeserializeAndCheckBlockTest, 5, 160, 39.2084, 0.0483662, 0.0494199, 0.0490138
24-
DeserializeBlockTest, 5, 130, 23.8129, 0.0357731, 0.0373763, 0.0365858
25-
FastRandom_1bit, 5, 440000000, 38.1609, 1.72974e-08, 1.73882e-08, 1.73478e-08
26-
FastRandom_32bit, 5, 110000000, 72.8237, 1.29992e-07, 1.37014e-07, 1.30115e-07
27-
MempoolEviction, 5, 41000, 89.8883, 0.000432748, 0.000446857, 0.000438483
28-
PrevectorClear, 5, 5600, 47.9229, 0.00169952, 0.0017455, 0.00170315
29-
PrevectorDestructor, 5, 5700, 44.5498, 0.0015561, 0.00156977, 0.00156469
30-
RIPEMD160, 5, 440, 135.988, 0.0615496, 0.062268, 0.0617779
31-
RollingBloom, 5, 1500000, 36.5109, 4.80961e-06, 4.97463e-06, 4.85811e-06
32-
SHA1, 5, 570, 51.808, 0.018065, 0.0182623, 0.0181865
33-
SHA256, 5, 340, 8.31841, 0.00483231, 0.00499803, 0.00485486
34-
SHA256_32b, 5, 4700000, 10.469, 4.43441e-07, 4.47611e-07, 4.45223e-07
35-
SHA512, 5, 330, 33.3408, 0.02017, 0.0202554, 0.0201921
36-
SipHash_32b, 5, 40000000, 38.7088, 1.91103e-07, 1.96998e-07, 1.93792e-07
37-
Sleep100ms, 5, 10, 5.01062, 0.100131, 0.100368, 0.100147
38-
Trig, 5, 12000000, 5.95494, 9.78115e-08, 1.04354e-07, 9.80682e-08
39-
VerifyScriptBench, 5, 6300, 9.02493, 0.000285566, 0.000288433, 0.000286175
23+
AssembleBlock, 5, 700, 1.79954, 0.000510913, 0.000517018, 0.000514497
24+
...
4025
```
4126

4227
Help
4328
---------------------
44-
`-?` will print a list of options and exit:
4529

46-
src/bench/bench_bitcoin -?
30+
src/bench/bench_bitcoin --help
31+
32+
To print options like scaling factor or per-benchmark filter.
4733

4834
Notes
4935
---------------------
5036
More benchmarks are needed for, in no particular order:
5137
- Script Validation
52-
- CCoinDBView caching
5338
- Coins database
5439
- Memory pool
55-
- Wallet coin selection
40+
- Cuckoo Cache
41+
- P2P throughput
42+
43+
Going Further
44+
--------------------
45+
46+
To monitor Bitcoin Core performance more in depth (like reindex or IBD): https://github.com/chaincodelabs/bitcoinperf
47+
48+
To generate Flame Graphs for Bitcoin Core: https://github.com/eklitzke/bitcoin/blob/flamegraphs/doc/flamegraphs.md

0 commit comments

Comments
 (0)