openstack
/
monasca-grafana-datasource
Code Issues Proposed changes
Monasca Grafana Datasource
20 Commits 1 Branch 5 Tags 327 KiB
JavaScript 66.2%
HTML 33.8%
Go to file
Witold Bedyk 7f0b8621cb Update version numbers 
* package.json
* plugin.json

Change-Id: I2497128971af08c7c8aba37a8ca50b0bce7f3d7a
 		2017-12-11 17:28:35 +01:00
examples Add OpenStack default dashboard 2017-12-01 10:02:47 +09:00
img Move monasca datasource to new repo 2016-07-27 17:21:19 +00:00
partials Add support for monasca-ui metrics API proxy 2017-12-05 11:02:22 +01:00
.gitreview Added .gitreview 2016-07-14 15:30:54 +00:00
LICENSE Move monasca datasource to new repo 2016-07-27 17:21:19 +00:00
README.md Add support for monasca-ui metrics API proxy 2017-12-05 11:02:22 +01:00
datasource.js Add support for monasca-ui metrics API proxy 2017-12-05 11:02:22 +01:00
module.js Add annotation support for monasca plugin 2016-10-19 10:57:44 -06:00
package.json Update version numbers 2017-12-11 17:28:35 +01:00
plugin.json Update version numbers 2017-12-11 17:28:35 +01:00
query_ctrl.js Updates for new dimensions endpoints 2016-10-06 15:02:40 -06:00

README.md

Team and repository tags

Team and repository tags

Monasca Datasource - A datasource for use with the OpenStack Monasca api.

For more information on Monasca see the Monasca documentation

Authentication Options

Horizon Session

The Monasca Horizon plugin offers Horizon integration for Monasca. Among other things this plugin proxies the Monasca metrics API, using the Horizon session for authentication (as opposed to a Keystone token). This proxied API can be used to let this plugin access the Monasca API with the privileges of the user logged in to Horizon.

Note that this is entirely separate from Grafana's user management.

Setting this up requires the following steps:

  1. Install and configure the monasca-ui Horizon plugin. Specifically you will need to set GRAFANA_URL to /grafana and point GRAFANA_LINKS to your dashboards which can either be JSON dashboards you point to or in-database dashboards. In the former case set the links' raw attribute to True and their path attribute to the dashboard's path or full URL. In the latter case, set the links' raw attribute to False (or omit it entirely) and set their path attributes to the database dashboards' names.

  2. Enable mod_proxy and mod_proxy_http in Apache:

    a2enmod proxy proxy_http

  3. Configure the VHost hosting your Horizon instance with a proxy path that points at your Grafana instance (the example assumes you are running Horizon on Apache - adapt as required for other web servers):

    ProxyPass "/grafana" "http://my.grafana.server:3000"
ProxyPassReverse "/grafana" "http://my.grafana.server:3000"

  4. Configure Grafana's [server/root_url] setting to point at your dashboard node's /grafana path:

    [server]
root_url = %(protocol)s://%(domain)s/grafana

  5. Configure the plugin as follows:

    • Http settings:
      • Url: http://my.dashboard.server/monitoring/proxy (substitute your dashboard's actual host name for my.dashboard.server here)
      • Access: direct
    • Authentication
      • Auth: Horizon

Steps (2) and (3) are neccessary to ensure both Grafana and Horizon are on the same Host/Port from the browser's perspective. Otherwise the browser's XSS protection mechanisms will omit the Horizon session cookie from any requests triggered by the monasca-grafana-datasource plugin.

Keystone Authentication

When combined with Grafana Keystone authentication this datasource supports using login credentials to authenticate queries.

Keystone Token

Without the Grafana Keystone auth, this datasource can be used by inserting a keystone token into the datasource. To get a keystone token download the python-openstackclient, source credentials and run openstack token issue.