Overview

This application adds capability to report and retrieve metrics stored in MetricsService to/from InfluxDB.

InfluxDB is a distributed time-series database which is written in Go language. InfluxDB is optimized for storing time-series data, and it supports clustering.
With this application, each of ONOS instance can periodically report various metrics data to influxDB, and developers/users can easily query global perform metrics from influxDB.
Since influxDB provides an interface to expose its data, network administrator can easily integrate influxDB with third-party visualization tools to realize dashboard. By far, influxDB supports Grafana and Graphite visualization tool.

Architecture

TBD

Usage

We recommend the users to install influxDB in Ubuntu or CentOS.
In this installation guide, we will use CentOS 7 to install influxDB.

Prerequisites

Before you start, you will need followings:

• CentOS 7 64-bit
• 2GB or more RAM
• 2 or more processors

You can install CentOS 7 with minimum requirements.

InfluxDB Installation

In this step, we will install InfluxDB.

First update your CentOS to make sure that you have the latest software stacks installed.

$ sudo yum -y update

Add InfluxDB repository into yum.

$ cat <<EOF | sudo tee /etc/yum.repos.d/influxdb.repo
[influxdb]
name = InfluxDB Repository - RHEL \$releasever
baseurl = https://repos.influxdata.com/rhel/\$releasever/\$basearch/stable
enabled = 1
gpgcheck = 1
gpgkey = https://repos.influxdata.com/influxdb.key
EOF

Once repository is added to the yum configuration, try to install InfluxDB using yum install.

$ sudo yum -y install influxdb

You can try following commands to automatically start influxdb at OS boot time.

$ sudo chkconfig --level 2345 influxdb on

Finally, run InfluxDB.

$ sudo service influxdb start

InfluxDB Configuration

TBD

InfluxDB Report and Query Application Initialization

TBD

References

TBD