Monasca Grafana Datasource
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Witek Bedyk e076ee51d2 Add CONTRIBUTING.rst 6 months ago
examples Add OpenStack default dashboard 3 years ago
img Move monasca datasource to new repo 4 years ago
partials Revert "Revert "Add support for monasca-ui metrics API proxy"" 2 years ago
.gitreview OpenDev Migration Patch 1 year ago
CONTRIBUTING.rst Add CONTRIBUTING.rst 6 months ago
LICENSE Move monasca datasource to new repo 4 years ago
README.rst Convert to ReStructuredTest format 2 years ago
datasource.js Support time range to query dimension names/values 1 year ago
module.js Add annotation support for monasca plugin 4 years ago
package.json Support time range to query dimension names/values 1 year ago
plugin.json Support time range to query dimension names/values 1 year ago
query_ctrl.js Updates for new dimensions endpoints 4 years ago


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:

    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.