Skip to content

A powerful and easy-to-use monitoring tool for server hardware and validator nodes with alerts via telegram bot

License

Notifications You must be signed in to change notification settings

nodejumper-org/monitoring-tool

Repository files navigation

monitoring-tool

A powerful and easy-to-use monitoring tool for server hardware and validator nodes with alerts via telegram bot and grafana dashboards

Includes

Containers

Dashboards

Alerts

Server alerts

  • Server down
  • Out of memory (<10%)
  • Out of disk space (<10%)
  • Out of disk space within 24h
  • High CPU load (>85%)

Cosmos-based validator node alerts

  • Missing blocks
  • Degraded syncing (sync less than 40 blocks in last 5 min)
  • Low peers count (<5)

How to run

  1. Install docker
bash <(curl -s https://raw.githubusercontent.com/nodejumper-org/monitoring-tool/main/utils/install_docker.sh)
  1. Clone the repo
cd ~
git clone https://github.com/nodejumper-org/monitoring-tool.git 
  1. Create configuration files from examples
cd monitoring-tool
cp prometheus/prometheus.yml.example prometheus/prometheus.yml
cp alertmanager/config.yml.example alertmanager/config.yml
  1. Start containers
sudo docker compose up -d
  1. Open in browser http://<your_server_ip>:3000

default user: admin
default password: admin

How to configure

Servers to monitor

Add your servers with installed node_exporter or installed cosmos-based node with enabled prometheus port to file prometheus/prometheus.yml

  # example for servers with node_exporter installed
  - job_name: "my-servers"
    static_configs:
    - targets: ["172.0.0.1:9100"]
      labels:
        instance: "server1"
    - targets: ["172.0.0.2:9100"]
      labels:
        instance: "server2"
    
  # example for servers with node_exporter and cosmos-based node installed
  - job_name: "cosmos-validator-nodes"
    static_configs:
    - targets: ["192.0.0.1:9100","192.0.0.1:26660"]
      labels:
        instance: "validator1"
    - targets: ["192.0.0.2:9100","192.0.0.2:26660"]
      labels:
        instance: "validator2"
    - targets: ["192.0.0.3:9100","192.0.0.3:26660"]
      labels:
        instance: "validator3"

Telegram notifications

In order to enable telegram notifications, create your own bot and fill in the following fields in the file alertmanager/config.yml

chat_id=1111111                 # your telegram user id
bot_token=11111111:AAG_XXXXXXX  # your telegram bot token

How to install node_exporter

Just run next command

bash <(curl https://raw.githubusercontent.com/nodejumper-org/monitoring-tool/main/utils/install_node_exporter.sh)

How to update

Just run next commands

cd monitoring-tool
sudo docker-compose down
git pull
sudo docker-compose pull
sudo docker-compose up -d