Skip to content

Checks via RPC API whether Ethereum full node is alive, up to date and responsive

Notifications You must be signed in to change notification settings

Snawoot/ethcheck

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ethcheck

Checks Ethereum full node RPC API to determine whether it is available, up to date and responsive within certain time constraints.

Installation

Binaries

Pre-built binaries are available here.

Build from source

Alternatively, you may install application from source. Run the following within the source directory:

make install

Usage

Program is intended to work as an external health check command for load balancers and reverse proxies. It returns zero exit code if remote destination is healthy and non-zero exit code otherwise.

Synopsis

$ ethcheck -h
Usage of ethcheck:
  -address-override string
    	force remote host address
  -block-tolerance int
    	request metainfo for latest_block - block_tolerance or -1 for symbolic name "latest" (default -1)
  -lag duration
    	allowed lag treshold (default 1m0s)
  -port-override string
    	force remote host port
  -req-timeout duration
    	timeout for single request (default 5s)
  -total-timeout duration
    	whole operation timeout (default 20s)
  -url string
    	RPC endpoint URL
  -version
    	show program version and exit

About

Checks via RPC API whether Ethereum full node is alive, up to date and responsive

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 63.9%
  • Makefile 32.9%
  • Dockerfile 2.7%
  • Shell 0.5%