Miscellaneous

This directory contains miscellaneous files, such as example Grafana dashboards and Prometheus configuration.

The files in this directory may undergo a lot of changes while reth is unstable, so do not expect them to necessarily be up to date.

Overview

• Prometheus: An example Prometheus configuration.
• Grafana: Example Grafana dashboards & data sources.

Docker Compose

To run Reth, Grafana or Prometheus with Docker Compose, refer to the docker docs.

Grafana

Adding a new metric to Grafana

To set up a new metric in Reth and its Grafana dashboard:

1. Add the metric to the codebase following the metrics section documentation.

2. Build the Reth image:

   docker build . -t reth:local

   Modify the docker-compose file to use your locally built image for the Reth service.

3. Run Docker Compose:

   docker compose -f etc/docker-compose.yml -f etc/lighthouse.yml up -d

4. Access Grafana:

   • Open http://localhost:3000/ in a browser
   • Log in with username and password admin
   • Navigate to the Dashboards tab

5. Create or modify a dashboard:

   • Select an existing dashboard or create a new one
   • Click Add > Visualization to create a new panel

6. Configure your metric panel:

   • Set a panel title and description
   • Select metric(s) from the Metrics browser or use the PromQL terminal
   • Document your metric(s) by setting units, legends, etc.
   • When adding multiple metrics, use field overwrites if needed

7. Save and arrange:

   • Click Apply to save the panel
   • Drag the panel to desired position on the dashboard

8. Export the dashboard:

   • Click Share > Export
   • Toggle Export for sharing externally
   • Click Save to file

9. Update dashboard file:

   • Replace the content of the corresponding file in the dashboards folder with the exported JSON

Your new metric is now integrated into the Reth Grafana dashboard.

Import Grafana dashboards

In order to import new Grafana dashboards or update a dashboard:

1. Go to Home > Dashboards

2. Click New > Import

3. Drag the JSON dashboard file to import it

4. If updating an existing dashboard, you will need to change the name and UID of the imported dashboard in order to avoid conflict

5. Delete the old dashboard