README.md

Guider Visualizer

Visualizer using Grafana & InfluxDB for Guider

Container Run

Version

Docker Image: 2.3.0
Ubuntu: 18.04
InfluxDB: 1.7.10
Grafana: 6.6.2

Run

• Start container

  • Method 1: Use DockerHub

  $ docker pull yoonje/guider-influxdb-grafana

  $ docker run --ulimit nofile=66000:66000 \
    -d \
    --name guider-visualization \
    -p 3003:3003 \
    -p 8086:8086 \
  yoonje/guider-influxdb-grafana

  • Method 2: Build in local environment

  $ git clone https://github.com/guiderOrg/visualizer.git

  $ docker build -t guider-influxdb-grafana .

  $ docker run --ulimit nofile=66000:66000 \
    -d \
    --name guider-visualization \
    -p 3003:3003 \
    -p 8086:8086 \
  guider-influxdb-grafana

• Stop container

$ docker stop guider-visualization

• Restart container

$ docker start guider-visualization

Port Forwarding

Host	Container	Service
3003	3003	grafana
8086	8086	influxdb

Grafana

Open http://localhost:3003

Username: root
Password: root

Add data source on Grafana

1. Using the wizard click on Configuration -> Add data source
2. Select InfluxDB
3. Fill remaining fields as follows and click on Add without altering other fields

Url: http://localhost:8086
Database: guider
User: guider
Password: guider

4. Click Save & Test

Import dashboard

1. Using the wizard click on Create -> Import
2. Upload Dashbaord and Click Import

Guider Visualizer Run

Requirements

Python >= 3.0

Install Python Dependencies

It is recommended to use virtualenv.

$ pip3 install virtualenv

$ virtualenv venv 

$ source ./venv/bin/activate

If you don't want to use virtualenv, just run this command.

$ pip3 install -r requirements.txt

Run

• First, Run the guider server on the system to measure performance. Only ports between 50 and 999 are available.

  $ python3 guider.py server -x {PORT}

• Run visualization client. Only ports between 50 and 999 are available.

  $ python3 visualize.py {guider server IP:PORT}