openstack/gnocchi
Code Issues Proposed changes
73ed97906b
gnocchi/doc/source/grafana.rst
Julien Danjou d46fa37277 rest: set useful default values for CORS middleware 
This makes Grafana easier to setup.

Change-Id: Ib53e1a3c8c9e986af5c58697476dd2922f6526fd
2016-07-18 17:12:02 +02:00

1.8 KiB
Raw Blame History

Grafana support

Grafana has support for Gnocchi through a plugin. It can be installed with grafana-cli:

sudo grafana-cli plugins install sileht-gnocchi-datasource

Source and Documentation are also available.

Grafana has 2 modes of operation: proxy or direct mode. In proxy mode, your browser only communicates with Grafana, and Grafana communicates with Gnocchi. In direct mode, your browser communicates with Grafana, Gnocchi, and possibly Keystone.

Picking the right mode depends if your Gnocchi server is reachable by your browser and/or by your Grafana server.

In order to use Gnocchi with Grafana in proxy mode, you just need to:

  1. Install Grafana and its Gnocchi plugin
  2. Configure a new datasource in Grafana with the Gnocchi URL. If you are using the Keystone middleware for authentication, you can also provide an authentication token.

In order to use Gnocchi with Grafana in direct mode, you need to do a few more steps:

  1. Configure the CORS middleware in gnocchi.conf to allow request from Grafana:

    [cors]
allowed_origin = http://example.com/grafana

  2. Configure the CORS middleware in Keystone to allow request from Grafana too:

    [cors] allowed_origin = http://example.com/grafana

  3. Configure a new datasource in Grafana with the Keystone URL, a user, a project and a password. Your browser will query Keystone for a token, and then query Gnocchi based on what Grafana needs.

Grafana screenshot