Skip to content
Safir Monitor Dashboard (Horizon plugin)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
devstack Minor bug fixes Aug 1, 2017
monitor_dashboard search added to project monitor multiselect Mar 26, 2018
.gitignore Upgrading to OpenStack stable/pike version Jan 19, 2018
LICENSE Safir monitor dashboard files added Jul 13, 2017
README.rst README updated for stable/pike version Jan 19, 2018
local.conf Moving to Gnocchi api Sep 15, 2017
package.json Safir monitor dashboard files added Jul 13, 2017
polling.yaml.example Upgrading to OpenStack stable/pike version Jan 19, 2018
requirements.txt Safir monitor dashboard files added Jul 13, 2017
setup.cfg Safir monitor dashboard files added Jul 13, 2017
setup.py
test-requirements.txt Safir monitor dashboard files added Jul 13, 2017
tox.ini Safir monitor dashboard files added Jul 13, 2017

README.rst

Safir Monitor Dashboard

Safir Monitor Dashboard is an Openstack Horizon plugin developed to visualize the collected utilization data of the physical and virtual machines in the clouds. Safir Monitor Dashboard currently visualizes CPU, RAM, disc, incoming network and outgoing network utilization. Openstack Telemetry Service (Ceilometer) is used to collect the data from the cloud. Safir Monitor Dashboard uses Gnocchi api to get the collected data as of release v2.0.

Installation

How To Use With Devstack

$ git clone http://github.com/openstack-dev/devstack -b stable/pike
$ cd devstack
$ wget -O local.conf https://github.com/b3lab/safir_monitor_dashboard/blob/master/local.conf?raw=true

Configure local.conf with host IP and set an admin password

$ ./stack.sh

Then follow the Configuration steps

How To Use With Existing Openstack Installation

At least the following Openstack services are needed to use Safir Monitor Dashboard; Keystone, Nova, Glance, Neutron, Ceilometer, Aodh and Horizon.

  • Clone Safir Monitor Dashboard from github and install it with pip
$ git clone https://github.com/b3lab/safir_monitor_dashboard.git
$ cd safir_monitor_dashboard
$ sudo pip install .
  • Copy Safir Monitor Dashboard enabled files to Horizon's local enabled files directory
$ cp monitor_dashboard/enabled/_*  {HORIZON_DIR}/openstack_dashboard/local/enabled/

Then follow the Configuration steps

Configuration

  • Set the following configuration settings in {HORIZON_DIR}/openstack_dashboard/local/local_settings.py AODH actions urls will be used when an alarm is launch from Monitor Panel. MONITORING_INTERFACES will be used to monitor specific interfaces on hypervisor nodes.
AODH_ALARM_ACTIONS = ['<ALARM-SERVICE-URL>']
AODH_OK_ACTIONS = ['<ALARM-SERVICE-URL>']

MONITORING_INTERFACES = ['eth0', 'eth1']
  • Collect Safir Monitor Dashboard static files on Horizon and restart Apache2 server
$ python {HORIZON_DIR}/manage.py collectstatic
$ python {HORIZON_DIR}/manage.py compress  # if compress enabled
$ sudo service apache2 restart
  • Configure Nova service to monitor compute instances like the following example and restart the service
notify_on_state_change = vm_and_task_state
instance_usage_audit_period = hour
instance_usage_audit = True
compute_monitors = nova.compute.monitors.cpu.virt_driver
  • Configure Ceilometer service to collect utilization data as shown in the {SAFIR_MONITOR_DASHBOARD_DIR}/polling.yaml.example file
  • Install SNMP server to compute nodes to monitor them.
You can’t perform that action at this time.