Horizon UI for Monasca

Go to file

Denis Poisson 5fdd270d46 Update README with new installation steps Use current grafana. Use monasca-grafana-datasource - not grafana-plugins. Change-Id: I08a32abcf1ac8d200259c76a7916ceb2d16af98d story: 2001980 task: 19598		2018-06-27 12:01:50 +00:00
debian	Initial installer work	2014-04-29 14:09:19 -06:00
grafana-dashboards	Extended grafana dashboard to display dimensions.	2017-09-01 10:38:30 +02:00
monitoring	Merge "Fix Alarm status Panel on Overview page"	2018-05-11 08:40:47 +00:00
tools	Make monasca-ui python3 compatible	2018-03-29 15:53:22 -04:00
.gitignore	Update pep8 checks	2018-04-18 16:09:26 +02:00
.gitreview	Update .gitreview for new namespace	2015-10-17 22:31:15 +00:00
.zuul.yaml	add lower-constraints job	2018-04-10 16:42:22 +00:00
ChangeLog	Updates for grafana 2.	2016-03-24 10:23:46 -06:00
LICENSE	pypi packaging files	2014-05-30 16:52:14 -06:00
README.md	Update README with new installation steps	2018-06-27 12:01:50 +00:00
babel-django.cfg	This is a preparation for using Zanata	2016-01-28 15:34:06 +09:00
babel-djangojs.cfg	This is a preparation for using Zanata	2016-01-28 15:34:06 +09:00
lower-constraints.txt	add lower-constraints job	2018-04-10 16:42:22 +00:00
manage.py	Add Apache 2.0 license to source file	2017-01-16 08:11:05 +00:00
mkdocs.yml	Change repositories from stackforge to openstack	2015-10-19 09:59:14 +05:30
requirements.txt	Merge "add lower-constraints job"	2018-04-11 09:45:01 +00:00
run_tests.sh	Move coverage reports to `cover` directory	2018-03-16 14:54:20 +01:00
setup.cfg	Changed author and author-email	2016-11-14 12:36:07 +05:30
setup.py	Updated from global requirements	2017-03-02 11:47:16 +00:00
test-requirements.txt	Drop mox3 from test-requirements.txt	2018-03-23 10:11:52 -04:00
tox.ini	Update pep8 checks	2018-04-18 16:09:26 +02:00

README.md

Team and repository tags

monasca-ui

Monasca UI is implemented as a Horizon plugin that adds panels to Horizon. It is installed into devstack by the monasca-api plugin.

Deployment Set Up

Clone Horizon: git clone https://git.openstack.org/openstack/horizon.git
cd horizon
Add git+https://git.openstack.org/openstack/monasca-ui.git to requirements.txt.
Edit openstack_dashboard/settings.py to include the following two lines:
- import monitoring.enabled
- monitoring.enabled, (Add this line to the settings.update_dashboards list.)

Development Environment Set Up

Get the Code

git clone https://git.openstack.org/openstack/monasca-ui.git  # clone monasca-ui
git clone https://git.openstack.org/openstack/horizon.git  # clone horizon
git clone https://github.com/monasca/grafana.git  # clone grafana
git clone https://github.com/openstack/monasca-grafana-datasource.git # clone grafana plugins

Set up Horizon

Since Monasca UI is a Horizon plugin, the first step is to get their development environment set up.

cd horizon
./run_tests.sh
cp openstack_dashboard/local/local_settings.py.example openstack_dashboard/local/local_settings.py

Pro Tip: Make sure you have Horizon running correctly before proceeding. For more details visit: https://docs.openstack.org/horizon/latest/#setup

Set up Monasca-UI

Edit openstack_dashboard/local/local_settings.py to modify the OPENSTACK_HOST IP address to point to devstack.
Add monasca-client to requirements.txt. Get the latest version from: https://pypi.org/project/python-monascaclient
Link monasca into Horizon:

ln -sf $(pwd)/../monasca-ui/monitoring/enabled/_50_admin_add_monitoring_panel.py \
    $(pwd)/openstack_dashboard/enabled/_50_admin_add_monitoring_panel.py
ln -sf $(pwd)/../monasca-ui/monitoring/conf/monitoring_policy.json \
    $(pwd)/openstack_dashboard/conf/monitoring_policy.json
ln -sfF $(pwd)/../monasca-ui/monitoring $(pwd)/monitoring
./run_tests #load monasca-client into virtualenv

Set up Grafana 4.1

The grafana4 branch of grafana is stable, as is master in monasca-grafana-datasource.
Copy monasca-grafana-datasource/ into grafana/plugins/monasca-grafana-datasource/.
Use the grafana docs to build and deploy grafana:
- http://docs.grafana.org/project/building_from_source/
- http://docs.grafana.org/installation/configuration/
Copy monasca-ui/grafana-dashboards/* to /public/dashboards/ in your grafana deployment.
Set GRAFANA_URL in the Horizon settings.

Start Server

./run_tests.sh --runserver

Style checks

To check if the code follows python coding style, run the following command from the root directory of this project:

$ tox -e pep8

Coverage checks

To measure the code coverage, run the following command from the root directory of this project:

$ tox -e cover

Unit tests

To run all the unit test cases, run the following command from the root directory of this project:

$ tox -e py27,py35