Etherium Healthcheck for HAProxy

Etherium healthcheck for HAProxy via Etherium HTTP JSON-RPC API.

Compiling

You will need go-lang version 1.14 or later to compile the source.

CLI Options

When starting the tcp server you can specify what address and port it should listen to:

eth-healthcheck <ip> <port>

by default it will listen to 127.0.0.1:1301

JSON-RPC API

The healthcheck server can check any Etherium client that supports the JSON-RPC API via HTTP. Here is the documentation for the popular geth client.

HAproxy configuration

You will need to tell haproxy to send a message to the tcp server with the HTTP url to a etherium client's JSON-RPC API that you would like to check.

This url should be passed to the agent-send parameter in HAproxy config like this:

check agent-check agent-addr 127.0.0.1 agent-port 1301 agent-send "http://127.0.0.1:8545\n"

Read the documentation for more information.

Author

Henrik Hautakoski - henrik@eossweden.org