New Visualization Tool for Openstack
Python JavaScript HTML CSS Shell Scala
Latest commit becf7dd May 13, 2015 @lexholden lexholden Fixed readme markdown OL
Permalink
Failed to load latest commit information.
.tx Update .tx/config with type of files Mar 21, 2014
doc Merge "Add collectstatic commands to install doc" Dec 19, 2014
horizon Fix joint evaluation of angular hooks and jquery handlers Jan 14, 2015
openstack_dashboard Changed heatmap plot to calculate data set and plot once - fixes #21 Feb 2, 2015
tools Remove requirements style check Jul 8, 2014
.gitignore Added AVOS framework Jan 6, 2015
.gitreview Add .gitreview and rfc.sh. Oct 28, 2011
.mailmap Update my mailmap Oct 25, 2013
.pylintrc updating run_tests.sh to mimic other openstack projects, pep8, pylint… Aug 31, 2011
CONTRIBUTING.rst Workflow documentation is now in infra-manual Dec 5, 2014
HACKING.rst Remove #noqa from django.conf.urls.include Sep 29, 2014
LICENSE Initial commit Jan 12, 2011
MANIFEST.in Drop NodeJS dependency in favor of pure-python lesscpy Aug 16, 2013
Makefile Unifies the project packaging into one set of modules. Feb 29, 2012
README.md Fixed readme markdown OL May 13, 2015
README.rst changed readme Mar 11, 2015
manage.py Gate on H102 Apache 2.0 license header not found for pep8 Nov 19, 2013
openstack-common.conf Remove unused openstack.common.importutils Oct 13, 2014
requirements.txt Updated from global requirements Dec 18, 2014
run_tests.sh Determine environment version based requirement files Oct 23, 2014
setup.cfg Remove Python 2.6 classifier Nov 26, 2014
setup.py Updated from global requirements May 1, 2014
test-requirements.txt Updated from global requirements Nov 20, 2014
tox.ini Merge "Remove Python 2.6 classifier" Dec 8, 2014

README.md

         _  ____   ____   ___     ______   
        / \|_  _| |_  _|.'   `. .' ____ \  
       / _ \ \ \   / / /  .-.  \| (___ \_| 
      / ___ \ \ \ / /  | |   | | _.____`.  
    _/ /   \ \_\ ' /   \  `-'  /| \____) | 
   |____| |____|\_/     `.___.'  \______.' 
   Analytics & Visualisation on OpenStack

Cisco's Project AVOS attempts to provide a feature rich and intuitive analytics dashboard for OpenStack clouds giving developers and operators quick insight into your clouds configuration, state, performance and faults.

AVOS Dashboard

Install Instructions

The current master branch is a fork of stable/juno horizon with AVOS installed. For now, the standlone version (working outside horizon) has halted development, though is still available from the branch 'standalone'.

Simply clone AVOS in place of a horizon install, and everything will work.

Alternately, to point a fresh clone of this repo at another instance of OpenStack:

  1. Make sure you have the dependencies for horizon installed first: (e.g. on ubuntu run "sudo apt-get install apache2 libapache2-mod-wsgi memcached python-memcache" )
  2. Clone AVOS fresh (i.e. 'git clone https://github.com/ciscosystems/avos.git' )
  3. Copy openstack_dashboard/local/local_settings.py.example to openstack_dashboard/local/local_settings.py
  4. Edit openstack_dashboard/local/local_settings.py, find the line that defines OPENSTACK_HOST and change the IP to point to your control node.
  5. From the root folder run: python manage.py runserver xx.xx.xx.xx:xx (passing the IP and port you want to run horizon on)
  6. access that URL in browser, login in and select the AVOS panel from the admin section of the Horizon menu.

To access AVOS, log into horizon and see the panel under Admin > System > AVOS.

Current Limitations:

This is a beta release, AVOS still has some UX glitches, needs full cross browser testing and has a whole load of features still to come in future releases.

Installation of AVOS currently requires Ceilometer and Neutron, future releases will allow for a smart feature rollback that will work without these.

The Network plot (with VM to VM traffic flows) requires modifications to ceilometer not yet released. This feature will not work, and has temporarily been disabled, but the rest of AVOS will work.

We've been using Ceilometer intervals of 5 seconds, by default Ceilometer stores data every 10 minutes. Don't expect your heatmaps to update often unless you change this in your publisher .yaml files.

Questions

Any questions/bugs/feature requests? File an issue or Get in touch:

Alex Holden (ajonasho@cisco.com, a@lexholden.com) Debo~ Dutta (dedutta@cisco.com)


Horizon (OpenStack Dashboard)

Horizon is a Django-based project aimed at providing a complete OpenStack Dashboard along with an extensible framework for building new dashboards from reusable components. The openstack_dashboard module is a reference implementation of a Django site that uses the horizon app to provide web-based interactions with the various OpenStack projects.

Using Horizon

See doc/source/topics/install.rst about how to install Horizon in your OpenStack setup. It describes the example steps and has pointers for more detailed settings and configurations.

It is also available at http://docs.openstack.org/developer/horizon/topics/install.html.

Getting Started for Developers

doc/source/quickstart.rst or http://docs.openstack.org/developer/horizon/quickstart.html describes how to setup Horizon development environment and start development.

Building Contributor Documentation

This documentation is written by contributors, for contributors.

The source is maintained in the doc/source directory using reStructuredText_ and built by Sphinx_

.. _reStructuredText: http://docutils.sourceforge.net/rst.html .. _Sphinx: http://sphinx-doc.org/

  • Building Automatically::

    $ ./run_tests.sh --docs

  • Building Manually::

    $ tools/with_venv.sh sphinx-build doc/source doc/build/html

Results are in the doc/build/html directory