x
/
fuel-plugin-influxdb-grafana
Code Issues Proposed changes
RETIRED, Fuel plugin to manage InfluxDB and Grafana
128 Commits 3 Branches 29 Tags 13 MiB
Go to file
OpenDev Sysadmins 847f185d9b OpenDev Migration Patch 
This commit was bulk generated and pushed by the OpenDev sysadmins
as a part of the Git hosting and code review systems migration
detailed in these mailing list posts:

http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html
http://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html

Attempts have been made to correct repository namespaces and
hostnames based on simple pattern matching, but it's possible some
were updated incorrectly or missed entirely. Please reach out to us
via the contact information listed at https://opendev.org/ with any
questions you may have.
 		2019-04-19 19:49:50 +00:00
contrib/dashboards Fix wrong path in the README file. 2015-04-23 12:06:24 +02:00
deployment_scripts/puppet Merge remote-tracking branch 'origin/master' into merge-master-into--upgrade-influxdb-grafana 2015-08-17 10:04:52 +02:00
figures Manage the size of the partition 2015-04-21 14:48:51 +00: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 OpenDev Migration Patch 2019-04-19 19:49:50 +00:00
LICENSE Add appendix to LICENSE 2015-06-19 18:45:49 +02:00
README.md Upgrade Grafana to 2.1 2015-07-29 09:46:02 +00:00
environment_config.yaml Add support for retention policy 2015-08-10 09:24:18 +02:00
functions.sh Use official 2.1.0 packages for Grafana 2015-08-10 12:40:39 +02:00
metadata.yaml Bump version to 0.8.0 2015-07-08 18:38:46 +02:00
pre_build_hook Use official 2.1.0 packages for Grafana 2015-08-10 12:40:39 +02:00
tasks.yaml Set deployment order of tasks 2015-06-05 16:24:50 +02: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-0.8-0.8.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-0.8-0.8.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 InfluxDB root user.
    • The name of the database where you want to store your metrics.
    • The username and the password for this specific database.
    • The name and the password for the Grafana admin user.

You can select up to 3 physical disks that will be mounted as a single logical volume to store the InfluxDB data. If you specify no disk, the data will be stored on the root filesystem. In all cases, InfluxDB data will be located in the /opt/influxdb directory.

For each disk, you can also specify the allocated size (in GB). If you don't specify a value, the plugin will use all the free space of the disk.

Here is a screenshot of the fields

InfluxDB-Grafana fields

Testing

InfluxDB

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

curl -G 'http://<HOST>:8086/'  \
  --data-urlencode "u=<root user of InfluxDB>" \
  --data-urlencode "p=<password of root user>" \
  --data-urlencode "q=show databases"

Where HOST is the IP address or the name of the node that runs the server and credentials are those provided in the Fuel UI for the InfluxDB root user.

The curl command should return something similar to:

{"results":[{"series":[{"name":"databases","columns":["name"],"values":[["lma"]]}]}]}

Grafana

Grafana is available at:

http://$HOST:8000/

You can login by using the username and password that you provided in the Fuel UI.

Known issues

None.

Release Notes

0.8.0

  • Upgrade Grafana to 2.1
  • Upgrade InfluxDB to 0.9

0.7.0

  • Initial release of the plugin. This is a beta version.

Development

The OpenStack Development Mailing List is the preferred way to communicate, emails should be sent to openstack-dev@lists.openstack.org with the subject prefixed by [fuel][plugins][lma].

Reporting Bugs

Bugs should be filled on the Launchpad fuel-plugins project (not GitHub) with the tag lma.

Contributing

If you would like to contribute to the development of this Fuel plugin you must follow the OpenStack development workflow.

Patch reviews take place on the OpenStack gerrit system.

Contributors