charm-gnocchi/src
camille.rodriguez b9a5c54da8 Enable S3 storage backend for Gnocchi
This feature enables the use of a S3 storage backend for Gnocchi.

Charm specs PR: https://review.opendev.org/#/c/738631/
func-test-pr: https://github.com/openstack-charmers/zaza-openstack-tests/pull/334

Change-Id: I959ed69e08b178cddf72535f22499a66b24f9567
2020-06-30 15:31:00 +00:00
..
files Sync charm/ceph helpers, tox, and requirements 2019-10-11 11:29:24 +00:00
lib/charm/openstack Enable S3 storage backend for Gnocchi 2020-06-30 15:31:00 +00:00
reactive Enable S3 storage backend for Gnocchi 2020-06-30 15:31:00 +00:00
templates Enable S3 storage backend for Gnocchi 2020-06-30 15:31:00 +00:00
tests Enable S3 storage backend for Gnocchi 2020-06-30 15:31:00 +00:00
README.md Enable S3 storage backend for Gnocchi 2020-06-30 15:31:00 +00:00
config.yaml Enable S3 storage backend for Gnocchi 2020-06-30 15:31:00 +00:00
copyright Initial charm version 2017-07-03 14:50:32 +01:00
icon.svg Update icon 2017-08-01 17:11:03 +01:00
layer.yaml Rebuild for sync layer-openstack 2019-08-22 09:00:19 +02:00
metadata.yaml Enable S3 storage backend for Gnocchi 2020-06-30 15:31:00 +00:00
test-requirements.txt Porting tests from Amulet to Zaza 2020-03-12 13:32:19 +01:00
tox.ini Porting tests from Amulet to Zaza 2020-03-12 13:32:19 +01:00
wheelhouse.txt Enable S3 storage backend for Gnocchi 2020-06-30 15:31:00 +00:00

README.md

Overview

Gnocchi is an open-source, multi-tenant timeseries, metrics and resources database. It provides an HTTP REST interface to create and manipulate the data. It is designed to store metrics at a very large scale while providing access to metrics and resources information and history.

Usage

Gnocchi is typically deployed as part of an OpenStack cloud, providing storage for Ceilometer, the telemetry collection service; To deploy Gnocchi to an existing OpenStack cloud (which includes ceilometer):

juju deploy gnocchi
juju deploy memcached
juju add-relation gnocchi mysql
juju add-relation gnocchi memcached
juju add-relation gnocchi keystone
juju add-relation gnocchi ceph-mon
juju add-relation gnocchi ceilometer

After re-configuration the Ceilometer API will be disabled - the Gnocchi REST API should be used to query information on resource, metrics and associated measures.

Gnocchi then needs to be initialized with the current ceilometer data:

juju run-action <ceilometer unit leader> ceilometer-upgrade

Usage with S3 storage backend

Note: S3 storage support for Gnocchi is available starting with OpenStack Stein.

Gnocchi is configured to be deployed by default with Ceph, however, it can also connect to an S3 storage backend. To configure Gnocchi with S3, configuration options (storage-backend, s3-region-name, s3-endpoint-url, s3-access-key-id and s3-secret-access-key) must be provided. Please take a look at config.yaml for more details.