Monasca UI
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.
Devstack Deployment Set Up
cd /opt/stack/horizon
Install Openstack upper-constraints requirements pip install -c https://opendev.org/openstack/requirements/raw/branch/master/upper-constraints.txt -r requirements.txt
Clone monasca-ui: git clone https://opendev.org/openstack/monasca-ui.git
Add git+https://opendev.org/openstack/monasca-ui.git to requirements.txt.
Install monasca-ui required packages pip install -r requirements.txt (monasca-client packages will be installed.)
Edit openstack_dashboard/settings.py to include the following two lines:
import monitoring.enabled
monitoring.enabled, (Add this line to the settings_utils.update_dashboards list.)
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.yaml \
$(pwd)/openstack_dashboard/conf/monitoring_policy.yaml
ln -sfF $(pwd)/../monasca-ui/monitoring $(pwd)/monitoring
Collect static files, run tests
python manage.py collectstatic --noinput python manage.py compress ./run_tests.sh
Restart apache service service apache2 restart
Development Environment Set Up
Get the Code
git clone https://opendev.org/openstack/monasca-ui.git # clone monasca-ui git clone https://opendev.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.yaml \
$(pwd)/openstack_dashboard/conf/monitoring_policy.yaml
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:
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 py36
1 maintainer
Release files for monasca-ui 9.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| monasca-ui-9.0.0.tar.gz | 108.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| monasca_ui-9.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 251.0 kB
Release files / monasca-ui-9.0.0.tar.gz
| Download URL | monasca-ui-9.0.0.tar.gz |
|---|---|
| Size | 108.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2b250c1064fe8a49b3bfc9aa7e6cd253cfc52bcb4f85c943eb33338fbbdf99dc
|
|
BLAKE2b-256 checksum How to use checksums |
cf7403364a427d6588a3849010d2a4e213f210e071d01369e9ca1d2eb6369900
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.4
|
Release files / monasca_ui-9.0.0-py3-none-any.whl
| Download URL | monasca_ui-9.0.0-py3-none-any.whl |
|---|---|
| Size | 142.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6d38c70fd7b3c9dba2d4b9a87786bd7a4230f691555c3ceb1f4c51c58e316866
|
|
BLAKE2b-256 checksum How to use checksums |
22454cd3f404c7dbdbbdb3ce664bdf751c0a53959e4454d948d5d65dc513f797
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.4
|
