Skip to main content

How to monitor your node


Prepare the node operating environment, specific information can follow this article

Install Prometheus and configure the environment

We use Prometheus as the node data collection tool

Configure the Prometheus environment

  1. To prevent Prometheus from logging in, we need to set --no-create-home and create a user for Prometheus

    sudo useradd --no-create-home --shell /usr/sbin/nologin prometheus
  2. Create a directory where the configuration and executable files are stored

    sudo mkdir /etc/prometheus
    sudo mkdir /var/lib/prometheus
  3. Modify folder ownership

    sudo chown -R prometheus:prometheus /etc/prometheus
    sudo chown -R prometheus:prometheus /var/lib/prometheus

Install Prometheus

  1. After configuring the environment, we start the installation. You can check the latest version in the Releases of the official Github Repo and replace the version of the following command:

    sudo apt-get update && apt-get upgrade
    tar xfz prometheus-*.tar.gz
    cd prometheus-2.32.1.linux-amd64
  2. After the download is complete, there will be two executable files and two folders in the current path folder:

  3. Copy the executable file to the specified folder and modify the ownership:

    sudo cp ./prometheus /usr/local/bin/
    sudo cp ./promtool /usr/local/bin/
    sudo chown prometheus:prometheus /usr/local/bin/prometheus
    sudo chown prometheus:prometheus /usr/local/bin/promtool
  4. Copy the folder to the specified folder and modify the ownership:

    sudo cp -r ./consoles /etc/prometheus
    sudo cp -r ./console_libraries /etc/prometheus
    sudo chown -R prometheus:prometheus /etc/prometheus/consoles
    sudo chown -R prometheus:prometheus /etc/prometheus/console_libraries
  5. Delete redundant folders

    cd .. && rm -rf prometheus*
  6. Test whether the Prometheus installation is successful

    promtool check config /etc/prometheus/prometheus.yml
  7. Modify the ownership of the configuration file

    sudo chown prometheus:prometheus /etc/prometheus/prometheus.yml

You can also choose to install through the official documentation

2.3. Configure Prometheus environment

After the installation is complete, we need to configure the Prometheus environment as follows:

sudo vim /etc/prometheus/prometheus.yml

Fill in:

scrape_interval: 15s
evaluation_interval: 15s

# - "first.rules"
# - "second.rules"

- job_name: "prometheus"
scrape_interval: 5s
- targets: ["localhost:9090"]
- job_name: "zeitgeist_node"
scrape_interval: 5s
- targets: ["localhost:9616"]

Run Prometheus

Run the following command in Terminal:

sudo -u prometheus /usr/local/bin/prometheus --config.file /etc/prometheus/prometheus.yml --storage.tsdb.path /var/lib/prometheus/ --web.console.templates=/etc/prometheus/consoles --web.console.libraries=/etc/prometheus/console_libraries

After the operation is successful, the relevant log will be printed out.

Enter in the browser to view and query related information

Set Prometheus as a system service and run it automatically

  1. Create service file

    sudo vim /etc/systemd/system/prometheus.service
  2. Enter the following configuration:

    Description=Prometheus Monitoring

    ExecStart=/usr/local/bin/prometheus \
    --config.file /etc/prometheus/prometheus.yml \
    --storage.tsdb.path /var/lib/prometheus/ \
    --web.console.templates=/etc/prometheus/consoles \
    ExecReload=/bin/kill -HUP $MAINPID

  3. Reload systemd and start the service:

    sudo systemctl daemon-reload && systemctl enable prometheus && systemctl start prometheus

Install Grafana and configure the environment

We use Grafana as a visualization tool for node information. Grafana will capture the data provided by Prometheus and visualize the output in real time, giving node operators a more intuitive experience

Install Grafana

Enter in Terminal:

sudo apt-get install -y adduser libfontconfig1
sudo dpkg -i grafana_8.3.3_amd64.deb

The specific latest version can be found on the Grafana official website

Run and automatically run Grafana as a system service

Enter in Terminal:

sudo systemctl daemon-reload
sudo systemctl enable grafana-server
sudo systemctl start grafana-server

Configure Grafana data source

  1. Enter the following IP in the browser and log in:, the default account and password are both admin.

  2. Find the Configuration button on the left, select Data Sources, and after entering, select Add data source.

  3. You can choose according to the data source you use. In this article, we choose Prometheus.

  4. Set the data source parameters, set the URL to http://localhost:9090, select the bottom Save & Test, if you see Data source is working, it means there is no problem with the configuration.

Monitor Zeitgeist node metrics

After completing all the above configurations, we can import the pre-designed Dashboard to monitor the key information of the node.

  1. Select Import in the Create column of the menu bar, we can choose to import from the community with ID or through the Json file to import.

  2. Select Load, confirm again that the column of Prometheus is not selected wrong, and click Import.

  3. To run the Zeitgeist node locally, please use the following command line to execute (currently only supports binary file operation)

    ./zeitgeist --chain=battery_station --pruning=archive --prometheus-port=9616
  4. After waiting a few seconds, you will see the data update in the interface.