3 min read statoshi

Announcing Statoshi: Realtime Bitcoin Node Statistics

Bringing DevOps dashboards to Bitcoin node operators.
Announcing Statoshi: Realtime Bitcoin Node Statistics

I’ve been on a quest for the past several months since I first asked the question: how many Bitcoin nodes is enough? In order to better understand what is actually occurring on the Bitcoin network, I came to the conclusion that we need more insight into the internal operations of the Bitcoin nodes. As a result, it is my pleasure to announce the Statoshi project, an open source fork of Bitcoin Core that logs metrics to StatsD. If you run a Bitcoin full node, you may be interested in switching it out with the Statoshi fork so that you can monitor how it is interacting with its peers.

Here are some of the metrics that you’ll see logged:

/stats/message/received/<messageType> /stats/message/sent/<messageType>

“addr” messages sent and received per second
“inv” messages sent and received per second

/stats/message/received/inv_<invType>

block announcement “inv” messages received per second

/stats/message/sent/reject_<messageType>_<rejectReason>

Rejected transactions by reason per second. We can see that duplicate transaction attempts are the most common rejections.

Timers are the milliseconds of wall time that it takes to execute a given function. Graphite will give you quite a few different breakdowns of timer metrics.

/stats/timers/<FunctionName>_<TimeUnit> — Time Units are “ms” (milliseconds) and “us” (microseconds)

Milliseconds to execute the “CheckInputs” function, separated into lower, median, and upper bounds.

/stats/peers/connect
/stats/peers/disconnect

Peer connections and disconnections per second.

/stats/gauges/peers/totalConnections

Total peer connections. You can see when the node was restarted. Note: I modified my node to support more connections than the default 125.

/stats/bandwidth/bytesReceived
/stats/bandwidth/bytesSent

Bytes received per second and bytes sent per second. We can see the downstream bandwidth usage is fairly constant while upstream is spiky.

/stats/gauges/bandwidth/totalBytesReceived
/stats/gauges/bandwidth/totalBytesSent

Total bytes sent and bytes received since node was started. You can see the loss of Internet connection between 15:00 and 16:00

If you want to install and run a Statoshi node yourself, you can find the instructions here!

You might also like...

Apr
20
The Untold Story of ditto-b

The Untold Story of ditto-b

The story of an anonymous developer who fixed a critical flaw in Bitcoin's code.
5 min read
Feb
04
When do Bitcoin Node Operators Upgrade?

When do Bitcoin Node Operators Upgrade?

An analysis of historical Bitcoin Core node versions to examine the updating behavior of node operators over the years.
6 min read
Jan
06
Bitcoin 2023 Annual Review

Bitcoin 2023 Annual Review

Comprehensive coverage of metrics across a number of different verticals in the Bitcoin ecosystem to gauge performance in 2023.
20 min read
Dec
24
2023 Bitcoin Node Performance Tests

2023 Bitcoin Node Performance Tests

Testing full validation sync performance of 7 Bitcoin node implementations.
8 min read
Dec
16
Economically Unspendable Bitcoin UTXOs

Economically Unspendable Bitcoin UTXOs

UTXO management guidance for avoiding footguns that can cause problems during times of high transaction fees.
3 min read