{"id":20111779,"url":"https://github.com/openstack/monasca-ui","last_synced_at":"2025-04-07T07:12:25.137Z","repository":{"id":18654526,"uuid":"21861645","full_name":"openstack/monasca-ui","owner":"openstack","description":"Horizon UI for Monasca. Mirror of code maintained at opendev.org.","archived":false,"fork":false,"pushed_at":"2024-12-13T15:03:17.000Z","size":1013,"stargazers_count":45,"open_issues_count":0,"forks_count":23,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-03-31T06:03:38.388Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://opendev.org/openstack/monasca-ui","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openstack.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-07-15T13:55:58.000Z","updated_at":"2023-10-24T15:31:32.000Z","dependencies_parsed_at":"2024-02-10T09:27:16.815Z","dependency_job_id":"252a70d0-8299-4199-bdb6-912fa5c2c0f6","html_url":"https://github.com/openstack/monasca-ui","commit_stats":null,"previous_names":[],"tags_count":112,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Fmonasca-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Fmonasca-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Fmonasca-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openstack%2Fmonasca-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openstack","download_url":"https://codeload.github.com/openstack/monasca-ui/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247608153,"owners_count":20965952,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T18:17:40.335Z","updated_at":"2025-04-07T07:12:25.115Z","avatar_url":"https://github.com/openstack.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Monasca UI\n========================\n\n.. image:: https://governance.openstack.org/tc/badges/monasca-ui.svg\n    :target: https://governance.openstack.org/tc/reference/tags/index.html\n\nmonasca-ui\n==========\n\nMonasca UI is implemented as a Horizon plugin that adds panels to\nHorizon. It is installed into devstack by the monasca-api plugin.\n\nDevstack Deployment Set Up\n==========================\n\n-  ``cd /opt/stack/horizon``\n-  Install Openstack upper-constraints requirements\n   ``pip install -c https://opendev.org/openstack/requirements/raw/branch/master/upper-constraints.txt -r requirements.txt``\n-  Clone monasca-ui:\n   ``git clone https://opendev.org/openstack/monasca-ui.git``\n-  Add ``git+https://opendev.org/openstack/monasca-ui.git`` to\n   ``requirements.txt``.\n-  Install monasca-ui required packages\n   ``pip install -r requirements.txt`` (monasca-client packages will be installed.)\n-  Edit ``openstack_dashboard/settings.py`` to include the following two\n   lines:\n\n   -  ``import monitoring.enabled``\n   -  ``monitoring.enabled,`` (Add this line to the\n      ``settings_utils.update_dashboards`` list.)\n-  Link monasca into Horizon:\n\n::\n\n   ln -sf $(pwd)/../monasca-ui/monitoring/enabled/_50_admin_add_monitoring_panel.py \\\n       $(pwd)/openstack_dashboard/enabled/_50_admin_add_monitoring_panel.py\n   ln -sf $(pwd)/../monasca-ui/monitoring/conf/monitoring_policy.yaml \\\n       $(pwd)/openstack_dashboard/conf/monitoring_policy.yaml\n   ln -sfF $(pwd)/../monasca-ui/monitoring $(pwd)/monitoring\n\n-  Collect static files, run tests\n\n::\n\n   python manage.py collectstatic --noinput\n   python manage.py compress\n   ./run_tests.sh\n\n-  Restart apache service ``service apache2 restart``\n\nDevelopment Environment Set Up\n==============================\n\nGet the Code\n------------\n\n::\n\n   git clone https://opendev.org/openstack/monasca-ui.git  # clone monasca-ui\n   git clone https://opendev.org/openstack/horizon.git  # clone horizon\n   git clone https://github.com/monasca/grafana.git  # clone grafana\n   git clone https://github.com/openstack/monasca-grafana-datasource.git # clone grafana plugins\n\nSet up Horizon\n--------------\n\nSince Monasca UI is a Horizon plugin, the first step is to get their\ndevelopment environment set up.\n\n::\n\n   cd horizon\n   ./run_tests.sh\n   cp openstack_dashboard/local/local_settings.py.example openstack_dashboard/local/local_settings.py\n\nPro Tip: Make sure you have Horizon running correctly before proceeding.\nFor more details visit: https://docs.openstack.org/horizon/latest/#setup\n\nSet up Monasca-UI\n-----------------\n\n-  Edit ``openstack_dashboard/local/local_settings.py`` to modify the\n   ``OPENSTACK_HOST`` IP address to point to devstack.\n-  Add ``monasca-client`` to ``requirements.txt``. Get the latest\n   version from: https://pypi.org/project/python-monascaclient\n-  Link monasca into Horizon:\n\n::\n\n   ln -sf $(pwd)/../monasca-ui/monitoring/enabled/_50_admin_add_monitoring_panel.py \\\n       $(pwd)/openstack_dashboard/enabled/_50_admin_add_monitoring_panel.py\n   ln -sf $(pwd)/../monasca-ui/monitoring/conf/monitoring_policy.yaml \\\n       $(pwd)/openstack_dashboard/conf/monitoring_policy.yaml\n   ln -sfF $(pwd)/../monasca-ui/monitoring $(pwd)/monitoring\n   ./run_tests #load monasca-client into virtualenv\n\nSet up Grafana 4.1\n------------------\n\n-  The grafana4 branch of grafana is stable, as is master in\n   monasca-grafana-datasource.\n-  Copy ``monasca-grafana-datasource/`` into\n   ``grafana/plugins/monasca-grafana-datasource/``.\n-  Use the grafana docs to build and deploy grafana:\n\n   -  https://grafana.com/docs/project/building_from_source/\n   -  https://grafana.com/docs/installation/configuration/\n\n-  Copy ``monasca-ui/grafana-dashboards/*`` to ``/public/dashboards/``\n   in your grafana deployment.\n-  Set ``GRAFANA_URL`` in the Horizon settings.\n\nStart Server\n------------\n\n::\n\n   ./run_tests.sh --runserver\n\nStyle checks\n------------\n\nTo check if the code follows python coding style, run the following\ncommand from the root directory of this project:\n\n::\n\n   $ tox -e pep8\n\nCoverage checks\n---------------\n\nTo measure the code coverage, run the following command from the root\ndirectory of this project:\n\n::\n\n   $ tox -e cover\n\nUnit tests\n----------\n\nTo run all the unit test cases, run the following command from the root\ndirectory of this project:\n\n::\n\n   $ tox -e py36\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenstack%2Fmonasca-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenstack%2Fmonasca-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenstack%2Fmonasca-ui/lists"}