Prometheus and Grafana¶

Prometheus is an open-source monitoring system with efficient time series database and modern alerting approach. Together with Grafana it's the recommended way to make sure that your node and validator(s) are performing correctly.

Prometheus¶

To start, download Prometheus from https://prometheus.io/download/. Unzip the downloaded .zip file and run Prometheus from it's installed location with the lodestar prometheus.yml passed in as the config file

./prometheus --config.file=$rootDir/prometheus.yml

Then run the Lodestar beacon node with

lodestar --metrics.enabled=true --metrics.serverPort=8008

Navigate to http://localhost:9090/ in your browser to verify that Prometheus is monitoring Lodestar

Grafana¶

Download and install Grafana from it's official repository https://grafana.com/docs/grafana/latest/installation/debian/

Add Prometheus as a data source to Grafana https://prometheus.io/docs/visualization/grafana/#installing

An example of relevant metrics of interest to monitor are:

• nodejs_heap_space_size_used_bytes
• nodejs_eventloop_lag_seconds
• beaconchain_peers
• beaconchain_current_slot
• beaconchain_current_finalized_epoch