Skip to content

Latest commit

 

History

History
72 lines (58 loc) · 1.73 KB

README.md

File metadata and controls

72 lines (58 loc) · 1.73 KB
Raw

metviz

A tool that relays metrics (as time-series) from an HTTP endpoint in an ABS model to InfluxDB for visualization.

Installation

  • Install Python 3+
$ sudo apt-get install python3
  • Install Python 3 pip
$ sudo apt-get install python3-pip
  • Install Python Requests
$ (sudo) pip3 install requests
  • Install modgrammar
$ (sudo) pip3 install modgrammar
  • Install docker
$ sudo apt-get install docker-engine

Configuration

  • Start the monitoring backend. For more information refer to here:
$ ./run-monitoring.sh
  • Go to InfluxDB admin at http://localhost:3004
  • Use Query Templates to create a database datasource if it does not exist.
  • Go to Grafana at http://localhost:3003
  • Use root/root to log in
  • From top-left menu, go to Data Sources to configure one
    • Name: default and also check Default option
    • Type: InfluxDB
    • URL: http://localhost:8086
    • Access: direct
    • Database: datasource
    • User/Pass: datasource/datasource
  • From top-left menu, go to Dashboards to Import one
    • Use the file in the root of this repository Metric-Viz.json.
    • Use the above default data source for the dashboard.
    • Save and open the dashboard

Running

Debug mode

If the backend for metrics data from ABS is not available, run the following to use the tool in a sample test data mode:

$ python metviz.py TEST

Production mode

To use the tool against a running ABS metric endpoint:

$ python metviz.py http://localhost:9999/X/Y/Z

The above endpoint should be accessible with HTTP GET method with the specified JSON format.