Statoshi: Bitcoin Core + statistics logging

What is Statoshi?

Statoshi's objective is to protect Bitcoin by bringing transparency to the activity occurring on the node network. By making this data available, Bitcoin developers can learn more about node performance, gain operational insight about the network, and the community can be informed about attacks and aberrant behavior in a timely fashion.

There is a live Grafana dashboard at statoshi.info

License

Statoshi is released under the terms of the MIT license. See COPYING for more information or see http://opensource.org/licenses/MIT.

Development Process

Statoshi's changeset to Bitcoin Core is applied in the master branch and is built and tested after each merge from upstream or from a pull request. However, it not guaranteed to be completely stable. We do not recommend using Statoshi as a Bitcoin wallet.

A guide for Statoshi developers is available here

Other Notes

A system metrics daemon is available here

Statoshi also supports running multiple nodes that emit metrics to a single graphite instance. In order to facilitate this, you can add a line to bitcoin.conf that will partition each metric by the name of the host: statshostname=yourNodeName

---

stats.bitcoincore.dev 407c26d55

$ make

[ARGUMENTS]	
  args:
    - HOME=/Users/git
    - PWD=/Users/git/stats.bitcoincore.dev
    - UMBREL=false
    - THIS_FILE=GNUmakefile
    - TIME=1624773426
    - HOST_USER=git
    - HOST_UID=501
    - PUBLIC_PORT=80
    - NODE_PORT=8333
    - SERVICE_TARGET=shell
    - ALPINE_VERSION=3.11.6
    - WHISPER_VERSION=1.1.7
    - CARBON_VERSION=1.1.7
    - GRAPHITE_VERSION=1.1.7
    - STATSD_VERSION=0.8.6
    - GRAFANA_VERSION=7.0.0
    - DJANGO_VERSION=2.2.24
    - PROJECT_NAME=stats.bitcoincore.dev
    - DOCKER_BUILD_TYPE=all
    - SLIM=false
    - DOCKERFILE=stats.bitcoincore.dev
    - DOCKERFILE_BODY=docker/statoshi.all
    - GIT_USER_NAME=randymcmillan
    - GIT_USER_EMAIL=randy.lee.mcmillan@gmail.com
    - GIT_SERVER=https://github.com
    - GIT_PROFILE=bitcoincore-dev
    - GIT_BRANCH=master
    - GIT_HASH=407c26d55
    - GIT_PREVIOUS_HASH=33d2d5108
    - GIT_REPO_ORIGIN=git@github.com:bitcoincore-dev/stats.bitcoincore.dev.git
    - GIT_REPO_NAME=stats.bitcoincore.dev
    - GIT_REPO_PATH=/Users/git/stats.bitcoincore.dev
    - DOCKERFILE=stats.bitcoincore.dev
    - DOCKERFILE_PATH=/Users/git/stats.bitcoincore.dev/stats.bitcoincore.dev
    - BITCOIN_CONF=/Users/git/stats.bitcoincore.dev/conf/bitcoin.conf
    - BITCOIN_DATA_DIR=/Users/git/.bitcoin
    - STATOSHI_DATA_DIR=/Users/git/.statoshi
    - NOCACHE=
    - VERBOSE=
    - PUBLIC_PORT=80
    - NODE_PORT=8333
    - PASSWORD=changeme
    - CMD_ARGUMENTS=

[USAGE]:	make [BUILD] run [EXTRA_ARGUMENTS]	

	make init header build run user=root uid=0 nocache=false verbose=true

[DEV ENVIRONMENT]:	

	make header user=root
	make shell  user=root
	make shell  user=git

[EXTRA_ARGUMENTS]:	set build variables	

	nocache=true
	            	add --no-cache to docker command and apk add 
	port=integer
	            	set PUBLIC_PORT default 80

	nodeport=integer
	            	set NODE_PORT default 8333

	            	TODO

[DOCKER COMMANDS]:	push a command to the container	

	cmd=command 	
	cmd="command"	
	             	send CMD_ARGUMENTS to the [TARGET]

[EXAMPLE]:

	make all run user=root uid=0 no-cache=true verbose=true
	make report all run user=root uid=0 no-cache=true verbose=true cmd="top"
	make a r port=80 no-cache=true verbose=true cmd="ls"

[COMMAND_LINE]:

stats-console              # container command line
stats-bitcoind             # start container bitcoind -daemon
stats-debug                # container debug.log output
stats-whatami              # container OS profile

stats-cli -getmininginfo   # report mining info
stats-cli -gettxoutsetinfo # report txo info

#### WARNING: (effects host datadir) ####

stats-prune                # default in bitcoin.conf is prune=1 - start pruning node