TANGO monitor infrastructure
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Collectd docs updated Sep 20, 2018
docs_resources
rest-api
.travis.yml
Jenkinsfile
LICENSE.TXT
README.md

README.md

Monitoring Infrastructure

© Atos Spain S.A. 2016

The Monitoring Infrastructure is a component of the European Project TANGO (http://tango-project.eu ).


Description

Component architecture

Installation Guide

Usage Guide

Relation to other TANGO components


Description

The responsibility of this component is twofold. On one side it must provide running applications with metrics of the status of different devices, such as CPU, GPUs, FPGAs, etc. This information should be both energy consumption and performance status. On the other side it should also provide historical statistics for device metrics for latter analysis of upper components of the TANGO architecture.

TANGO architecture

This component relies on Collectd, which will be used together with some custom plugins done specifically for TANGO, in order to get and store energy consumption and performance values from the applications running in the different environments.

Available collection of probes to measure energy in heterogeneous hardware for the TANGO project:

  1. NVIDIA collectd plugin

    • power
    • temperature
    • memory used
    • usage
    • processes running
  2. Xeon Phi collectd plugin

    • power
    • temperature
    • memory used
    • usage
  3. IPMI plugin from collectd

    • power

Component architecture

Components

The monitoring Infrastructure is composed by the following components:

Collectd & plugins

Collectd is a daemon which collects system and application performance metrics periodically and provides mechanisms to store the values in a variety of ways. The TANGO Collectd plugins provide metrics from specific devices like the NVIDIA GPUs and the XEON PHI processors. The metrics gathered from this component are stored in the InfluxDB instance.

InfluxDB

InfluxDB is used as a data store for the metrics gathered from Collectd. The REST API and the Graphana applications connect to this tool in order to present the processed information.

Graphana

Graphana is a data visualization and monitoring tool with support for Graphite, InfluxDB and many more databases. This component is used as the GUI of the monitoring component.

REST API

The main purpose of the REST API application is to offer to other TANGO components the information they need from the metrics gathered from Collectd.

View REST API specification to see the available methods.

Architecture

Component architecture


Installation Guide (ubuntu, 64-bit systems)

1. Requirements
  • ubuntu 64-bit system
  • Java 8
  • Leiningen 2.0.0 or above installed.
2. Install Collectd
sudo apt-get update
sudo apt-get install collectd collectd-utils
2.1. Install plugins

View Collectd - Readme file to see how to compile and install the plugins.

3. Install InfluxDB
wget https://dl.influxdata.com/influxdb/releases/influxdb_0.13.0_amd64.deb
sudo dpkg -i influxdb_0.13.0_amd64.deb
sudo service influxdb start
sudo service influxdb statu
4. Install Grafana
wget https://grafanarel.s3.amazonaws.com/builds/grafana_3.0.4-1464167696_amd64.deb
sudo apt-get install -y adduser libfontconfig
sudo dpkg -i grafana_3.0.4-1464167696_amd64.deb
5. Collectd & InfluxDB & Grafana setup

See Monitoring with Collectd, InfluxDB & Grafana for more information about how to setup the three components.

6. Install and configure the REST API component

View rest-api - Readme file to see how to install and configure the REST API component.


Usage Guide


Relation to other TANGO components

The other TANGO components connect to the monitoring Infrastructure through the REST API application:

  • Programming model

  • heterogeneous parallel device clusters

  • Energy modeller

  • Self-Adaptation Manager