Horizon UI for Monasca

Go to file

Cao Xuan Hoang c799de4975 Add Apache 2.0 license to source file As per OpenStack licensing guide lines [1]: [H102 H103] Newly contributed Source Code should be licensed under the Apache 2.0 license. [1] http://docs.openstack.org/developer/hacking/#openstack-licensing Change-Id: I35d6714b41cd139e2a8f08820afd32ef256fbef2		2017-01-16 08:11:05 +00:00
debian	Initial installer work	2014-04-29 14:09:19 -06:00
grafana-dashboards	Updates for grafana 2.	2016-03-24 10:23:46 -06:00
monitoring	Add Apache 2.0 license to source file	2017-01-16 08:11:05 +00:00
tools	Add Constraints support	2017-01-02 12:30:55 +01:00
.gitignore	Fix functions of translation	2016-02-19 18:26:21 +09:00
.gitreview	Update .gitreview for new namespace	2015-10-17 22:31:15 +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
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
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
monasca_policy.json.sample	Added monasca-ui permissions policy	2014-10-31 13:26:13 -06:00
README.md	Show team and repo badges on README	2016-11-25 18:31:28 +01:00
requirements.txt	Sync from global-requirements	2016-12-04 03:35:57 +01:00
run_tests.sh	Fix functions of translation	2016-02-19 18:26:21 +09:00
setup.cfg	Changed author and author-email	2016-11-14 12:36:07 +05:30
setup.py	Sync from global-requirements	2016-12-04 03:35:57 +01:00
test-requirements.txt	Updated from global requirements	2017-01-03 20:23:38 +00:00
tox.ini	Merge "H305 and H307 hacking have been deprecated"	2017-01-05 08:02:12 +00: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 monasca-vagrant.

#Deployment Set Up

git clone https://git.openstack.org/openstack/horizon.git # clone horizon
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 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/twc-openstack/grafana.git  # clone grafana
git clone https://github.com/twc-openstack/grafana-plugins.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 go to http://docs.openstack.org/developer/horizon/quickstart.html#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.python.org/pypi/python-monascaclient
Link monasca into Horizon:

cp ../monasca-ui/monitoring/enabled/_50_admin_add_monitoring_panel.py openstack_dashboard/enabled/.
ln -s ../monasca-ui/monitoring monitoring
./run_tests #load monasca-client into virtualenv

##Set up Grafana 2.6

The v2.6.0-keystone branch of grafana is stable, as is v2.6.0 in grafana-plugins
Copy grafana-plugins/datasources/monasca into the grafana/public/app/plugins/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

##Removing notification panel If you want to disable the notification panel copy over _70_remove_monasca_notification_panel to the openstack_dashboard/enabled directory

#License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.