Clone the node_tooling repo and descend into the monitoring folder:

$ git clone https://github.com/Xiphiar/node_tooling.git
$ cd ./node_tooling/monitoring

In the Prometheus folder, modify cosmos.yaml, replace NODE_IP with the IP of your node. (If your node is on the docker host machine, use 172.17.0.1)

$ nano ./prometheus/cosmos.yaml

Replace the default Prometheus config with the modified cosmos.yaml

$ mv ./prometheus/prometheus.yml ./prometheus/prometheus.yml.orig
$ cp ./prometheus/cosmos.yaml ./prometheus/prometheus.yml

The docker images expose the following ports:

• 3000 Grafana. Your main dashboard. Default login is admin\admin.

• 9090 Prometheus. Access to this port should be restricted.

• 9100 Node Exporter. Access to this port should be restricted.

• Your secret node metrics on port 26660 should also be restricted.

If you followed the basic security guide, these ports are already restricted. You will need to allow the grafana port:

sudo ufw allow 3000

You can also allow access from a specific IP if desired:

sudo ufw allow from 123.123.123.123 to any port 3000

Start the containers deploying the monitoring stack (Grafana + Prometheus + Node Exporter):

$ docker-compose --profile monitor up -d

Login to Grafana at http://your-ip:3000 with username admin and password admin

The containers will restart automatically after rebooting unless they are stopped manually.

The dashboard for Cosmos SDK nodes is pre-installed, to use it:

Enable Tendermint metrics in your secret-node

sed -i 's/prometheus = false/prometheus = true/g' <YOUR-NODE-HOMEDIR>/config/config.toml

After restarting your node, you should be able to access the Tendermint metrics (default port is 26660): http://localhost:26660

If you did not replace NODE_IP with the IP of your node in the Prometheus config, do so now. If your node is on the docker host machine, use 172.17.0.1

$ nano ./prometheus/prometheus.yml
$ docker-compose down
$ docker-compose --profile monitor up -d

1. Login to Grafana and open the Cosmos Dashboard from the Manage Dashboards page.

2. Set the chain-id to secret-3

Docker and Docker Compose will allow you to run the required monitoring applications with a few commands. These instructions will run the following:

• Grafana on port 3000: An open source interactive analytics dashboard.

• Prometheus on port 9090: An open source metric collector.

• Node Exporter on port 9100: An open source hardware metric exporter.

Preparing Your Environment

• You will need to install docker and docker-compose.

• The following instructions assume Ubuntu 20.04 on an x86-64 CPU.

Install Docker

Test the installation:

Apply executable permissions to the binary:

Download the current stable release of Docker Compose:

Install Docker Compose

Test the installation:

Install docker:

Setup the docker stable repository:

Add Docker’s official GPG key:

Update the apt package index and install packages to allow apt to use a repository over HTTPS:

From the node_tooling/monitoring directory: