go-ethereum/content/docs/monitoring/dashboards.md

---
title: Monitoring Geth with InfluxDB and Grafana
---

There are several ways to monitor the performance of a Geth node. Insights into a node's 
performance are useful for debugging, tuning and understanding what is really happening when
Geth is running. 

## Prerequisites {#prerequisites}

To follow along with the instructions on this page it will be useful to have:

- a running Geth instance.
- basic working knowlegde of bash/terminal.

[This video](https://www.youtube.com/watch?v=cOBab8IJMYI) provides an excellent introduction 
to Geth monitoring.

## Monitoring stack {#monitoring-stack}

An Ethereum client collects lots of data which can be read in the form of a chronological 
database. To make monitoring easier, this data can be fed into data visualisation software. 
There are many options available:

- [Prometheus](https://prometheus.io/) (pull model)
- [InfluxDB](https://www.influxdata.com/get-influxdb/) (push model)
- [Telegraf](https://www.influxdata.com/get-influxdb/)
- [Grafana](https://www.grafana.com/)
- [Datadog](https://www.datadoghq.com/)
- [Chronograf](https://www.influxdata.com/time-series-platform/chronograf/)

There's also [Geth Prometheus Exporter](https://github.com/hunterlong/gethexporter), an option 
preconfigured with InfluxDB and Grafana. You can set it up easily using docker and 
[Ethbian OS](https://ethbian.org/index.html) for RPi 4.

On this page, a Geth client will be configured to push data into a InfluxDB database and 
Grafana will be used to visualize the data.

## Setting up InfluxDB {#setting-up-influxdb}

InfluxDB can be downloaded from the [Influxdata release page](https://portal.influxdata.com/downloads/). 
It can also be installed from a [repository](https://repos.influxdata.com/). 
For example for a Debian based Linux operating system:

```sh
curl -tlsv1.3 --proto =https -sL https://repos.influxdata.com/influxdb.key | sudo apt-key add
source /etc/lsb-release
echo "deb https://repos.influxdata.com/${DISTRIB_ID,,} ${DISTRIB_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
sudo apt update
sudo apt install influxdb -y
sudo systemctl enable influxdb
sudo systemctl start influxdb
sudo apt install influxdb-client
```

By default,InfluxDB it is reachable at `localhost:8086`. Before using the `influx` client, a new user with admin privileges
needs to be created. This user will serve for high level management, creating databases and users.

```sh
curl -XPOST "http://localhost:8086/query" --data-urlencode "q=CREATE USER username WITH PASSWORD 'password' WITH ALL PRIVILEGES"
```

Now the influx client can be used to enter [InfluxDB shell](https://docs.influxdata.com/influxdb/v1.8/tools/shell/) with the new user.

```sh
influx -username 'username' -password 'password'
```

A database and user for geth metrics can be created by communicatign with it directly via its shell.

```sh
create database geth
create user geth with password choosepassword
```

Verify created entries with:

```
show databases
show users
```

Leave InfluxDB shell.

```sh
exit
```

InfluxDB is running and configured to store metrics from Geth.

## Preparing Geth {#preparing-geth}

After setting up database, metrics need to be enabled in Geth. Various options are available, 
as documented in the `METRICS AND STATS OPTIONS` in `geth --help` and in our [metrics page](). 
In this case Geth will be configured to push data into InfluxDB. Basic setup specifies the endpoint 
where InfluxDB is reachable and authenticates the database.

```sh
geth --metrics --metrics.influxdb --metrics.influxdb.endpoint "http://0.0.0.0:8086" --metrics.influxdb.username "geth" --metrics.influxdb.password "chosenpassword"
```

These flags can be provided when Geth is started or saved to the configuration file.

Listing the metrics in the database verifies that Geth is pushing data correctly. In InfluxDB shell:

```sh
use geth
show measurements
```

## Setting up Grafana {#setting-up-grafana}

With the InfluxDB database setup and successfully receiving data from Geth, the next step is to 
install Grafana so that the data can be visualized. Instructions for specific operating systems
are available on the Grafana [downloads page](https://grafana.com/grafana/download?pg=get&plcmt=selfmanaged-box1-cta1).

Alternatively, the following code snippet shows how to download, install and run Grafana on a Debian 
based Linux system:

```sh
curl -tlsv1.3 --proto =https -sL https://packages.grafana.com/gpg.key | sudo apt-key add -
echo "deb https://packages.grafana.com/oss/deb stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list
sudo apt update
sudo apt install grafana
sudo systemctl enable grafana-server
sudo systemctl start grafana-server
```

When Grafana is up and running, it should be reachable at `localhost:3000`. A browser can be pointed to that URL
to access a visualization dashboard. The browser will prompt for login credentials (user: `admin` and password: `admin`). 
When prompted, the default password should be changed and saved.

![](./grafana1.png)

The browser first redirects to the Grafana home page to set up the source data. 
Click on the configuration icon in the left bar and select "Data sources".

![](./grafana2.png)

There aren't any data sources yet, click on "Add data source" to define one.

![](./grafana3.png)

Select "InfluxDB" and proceed.

![](./grafana4.png)

Data source configuration is pretty straight forward if you are running tools on the same machine. You need to set the 
InfluxDB address and details for accessing the database. Refer to the picture below.

![](./grafana5.png)

If everything is complete and InfluxDB is reachable, click on "Save and test" and wait for the confirmation to pop up.

![](./grafana6.png)

Grafana is now set up to read data from InfluxDB. Now you need to create a dashboard which will interpret and display it. 
Dashboards properties are encoded in JSON files which can be created by anybody and easily imported. On the left bar, 
click on "Create and Import".

![](./grafana7.png)

For a Geth monitoring dashboard, copy the ID of [this dashboard](https://grafana.com/grafana/dashboards/13877/) 
and paste it in the "Import page" in Grafana. After saving the dashboard, it should look like this:

![](./grafana8.png)

The dashboards can be customized further. Each panel can be edited, moved, removed or added. 
To learn more about how dashboards work, refer to [Grafana's documentation](https://grafana.com/docs/grafana/latest/dashboards/).

Some users might also be interested in automatic [alerting](https://grafana.com/docs/grafana/latest/alerting/), which
sets up alert notifications that are sent automatically when metrics reach certain values. Various communication channels are supported.