x
/
fuel-plugin-influxdb-grafana
Code Issues Proposed changes
RETIRED, Fuel plugin to manage InfluxDB and Grafana
11 Commits 3 Branches 29 Tags 13 MiB
Go to file
Simon Pasquier ca4327c220 Fix label names in the UI 
Change-Id: I9858b40a465dbec608b0eb783cede0c0a84b962e
 		2015-03-27 14:53:29 +01:00
deployment_scripts/puppet Use hiera instead of fuel_settings. 2015-03-26 11:35:55 +01:00
figures Fix label names in the UI 2015-03-27 14:53:29 +01:00
repositories Create the plug-in structure. 2015-03-25 12:29:39 +01:00
specs Add blueprint for the InfluxDB/Grafana Fuel plugin 2015-03-04 17:13:00 +01:00
.gitreview Added .gitreview 2015-02-24 22:43:28 +00:00
LICENSE Create the plug-in structure. 2015-03-25 12:29:39 +01:00
README.md Fix version of the plugin. 2015-03-26 11:35:55 +01:00
environment_config.yaml Fix label names in the UI 2015-03-27 14:53:29 +01:00
metadata.yaml Fix version of the plugin. 2015-03-26 11:35:55 +01:00
pre_build_hook Install Grafana with nginx. 2015-03-26 11:35:47 +01:00
tasks.yaml Remove parts for managing disks. 2015-03-26 11:35:55 +01:00

README.md

InfluxDB-Grafana Plugin for Fuel

InfluxDB-Grafana plugin

Overview

InfluxDB provides an open source time series database. Grafana is a rich dashboard and graph editor for InfluxDB.

Requirements

Requirement Version/Comment
Mirantis OpenStack compatibility 6.1 or higher

Recommendations

None.

Limitations

None.

Installation Guide

InfluxDB-Grafana plugin installation

To install the InfluxDB-Grafana plugin, follow these steps:

  1. Download the plugin from the Fuel Plugins Catalog.

  2. Copy the plugin file to the Fuel Master node. Follow the Quick start guide if you don't have a running Fuel Master node yet.

    scp influxdb_grafana-1.0-1.0.0-0.noarch.rpm root@<the Fuel Master node IP address>:

  3. Install the plugin using the fuel command line:

    fuel plugins --install influxdb_grafana-1.0-1.0.0-0.noarch.rpm

  4. Verify that the plugin is installed correctly:

    fuel plugins

Please refer to the Fuel Plugins wiki if you want to build the plugin by yourself, version 2.0.0 (or higher) of the Fuel Plugin Builder is required.

User Guide

InfluxDB-Grafana plugin configuration

  1. Create a new environment with the Fuel UI wizard.
  2. Add a node with the "Operating System" role.
  3. Before applying changes or once changes applied, edit the name of the node by clicking on "Untitled (xx:yy)" and modify it for "influxdb".
  4. Click on the Settings tab of the Fuel web UI.
  5. Scroll down the page, select the "InfluxDB-Grafana Server plugin" checkbox and fill-in the required fields.
    • The name of the node where the plugin is deployed.
    • The password for the root user.
    • The name of the database where you want to store your metrics.
    • The username and the password for this specific database.

Here is a screenshot of the fields

InfluxDB-Grafana fields

Testing

Once installed, you can check that InfluxDB is working using curl:

curl -G 'http://<HOST>:8086/db/lma/series?u=lma&p=<yourpassword>' --data-urlencode "q=list series"

Where HOST is the IP address or the name of the node that runs the server and yourpassword is the password provided in the Fuel UI for the user of InfluxDB.

The curl command should return a valid JSON object similar to:

[{"name":"list_series_result","columns":["time","sequence_number","name"],"points":[...]}]

To check that Grafana is running, you need to make sure that nginx is listening on port 80.

Known issues

None.

Release Notes

1.0.0

  • Initial release of the plugin

Contributors