Skip to content

Latest commit

 

History

History
58 lines (29 loc) · 3.29 KB

monitoring-setup.md

File metadata and controls

58 lines (29 loc) · 3.29 KB

Configuring monitoring (Grafana + Prom)

Easiest setup, join my 0-fee solo pool

Reqirements

Docker must be installed! Visit https://www.docker.com/ and follow the setup instructions on the docker website

Configuration

To begin you need to pull down the repo (or use the zipped source from the release). I'll use the release code for this example.

Go to the latest release (v1.1 at the time of writing) and download the source code. Download the zip archive for windows, tar.gz for everything else.

image

Unzip the source in a directory of your choice and open a shell/cmd prompt.

image

At this point if you can not progress without docker installed. Go install it if you haven't already.

For this example I'll be running everything in docker -- including the bridge. So type the following from the root folder to stand up everything:

docker compose -f docker-compose-all.yml up -d

Youll see output about downloading images and such and eventually see output like below:

image

At this point everything is running successfully in the background.

  • ks_bridge is running on port :5555
  • prometheus is running on port :9090
  • grafana is running on port :3000

You may point your miners the IP address of the computer you installed on at port 5555. I you're unsure your current IP then run ipconfig on windows and ifconfig in linux. You'll put this IP and the port into your miner config.

Accessing grafana

Assuming the setup went correctly you'll be able to access grafana by visiting http://127.0.0.1:3000

image

The default user/password is admin/admin. Grafana will prompt you to change the password but you can just ignore it (hit skip).

You'll land on the main grafana page. There's a lot you can do here but for now just click the pre-made dashboard:

image

This will drop you to the mining dashboard. It'll look like below until you start getting info from your miners.

image

At this point you're configured and good to go. Things to note here are that the stats will be inaccurate for the first hour or so that the bridge is running as most of the stats are based on 10-30m averages. Also note that there is a 'wallet_filter' and 'show_balances' toggle near the top of the screen. These filter the database and hide your balance if you don't want that exposed. The monitoring UI is also accessable on any device on your local network (including your phone!) if you use the host computers ip address -- just type in the ip and port such as http://192.168.0.25/3000 (this is an example, this exact link probablly wont work for you)