ETHexporter

A lightweight Prometheus exporter and Grafana Dashboard that will output Ethereum wallet balances from a list of addresses you specify. ETHexporter attaches to a geth server to fetch ethereum wallet balances for your Grafana dashboards. Many of you probably want to chart your ERC20 token balances, feel free to use TOKENexporter. If you also want a Bitcoin prometheus exporter, you can use BTCexporter which uses blockchain.info API.

Watch Addresses

The addresses.txt file holds all the addresses to fetch balances for. Use the format name:address:host on each new line.

etherdelta:0x8d12A197cB00D4747a1fe03395095ce2A5CC6819:host1
bittrex:0xFBb1b73C4f0BDa4f67dcA266ce6Ef42f520fBB98:host2

Running the Exporter

You can easily run this Ethereum balance prometheus exporter with the docker command:

docker run -it -d -p 9015:9015 \
  -e "GETH=https://mainnet.infura.io/****KEYHERE" \ 
  -v /myfolder/addresses.txt:/app/addresses.txt \ 
  hunterlong/ethexporter

Grafana Dashboard

ETHexporter includes a Grafana Dashboard so you visualize Ethereum wallet balances with ease. Import Grafana Dashboard ID: 6970 once you've started your Docker container.

Build Docker Image

Clone this repo and then follow the simple steps below!

Build Docker Image

docker build -t hunterlong/ethexporter:latest .

Run ethexporter

You'll need access to an ethereum Geth server to fetch balances. You can use Infura.io to quickly get an API key for a geth server. docker run -d -p 9015:9015 -e "GETH=https://mainnet.infura.io/****KEYHERE" hunterlong/ethexporter:latest

Pull from Dockerhub

Create a addresses.txt file with the correct format mentioned above.

docker run -d -v ~/ethexporter:/app \
 -p 9015:9015 \
 -e GETH=https://mainnet.infura.io/****KEYHERE \
 hunterlong/ethexporter:latest

The Docker image should be running with the default addresses.

Prometheus Response

eth_balance{name="etherdelta",address="0x8d12A197cB00D4747a1fe03395095ce2A5CC6819"} 24919.37437
eth_balance{name="bittrex",address="0xFBb1b73C4f0BDa4f67dcA266ce6Ef42f520fBB98"} 687509.5097
eth_balance{name="poloniex",address="0x32Be343B94f860124dC4fEe278FDCBD38C102D88"} 72284.47401
eth_balance{name="kraken",address="0x267be1c1d684f78cb4f6a176c4911b741e4ffdc0"} 159592.0022
eth_balance_total 944305.360280000022612512
eth_load_seconds 1.15
eth_loaded_addresses 4
eth_total_addresses 4