Monasca Database Persister
Go to file
Bharat Kunwar 97aab2f004 Support default_retention_hours for influxdb
At the moment, all data is retained infinitely. This change allows users
to specify a default_retention_hours (defaults to 0 meaning unlimited
retention) in the influxdb section of monasca persister configuration so
that new projects are automatically assigned this retention policy when
the given hour is greater than 0 to preserve original behaviour.

Story: 2006331
Task: 37234

Change-Id: I4136df1d43954eb026a104f3f85b3a58197f5435
2019-11-15 13:47:47 +00:00
common Replace git.openstack.org URLs with opendev.org URLs 2019-06-03 15:33:15 +02:00
config-generator Update documentation to use new default config 2019-02-18 18:21:25 +01:00
docker Support Kafka_events option in docker evn 2019-08-14 12:38:42 +00:00
etc/monasca Turn logging down from DEBUG in persister-logging.conf 2018-09-28 16:26:36 -07:00
java Deprecate Java implementation 2019-09-17 10:29:34 +02:00
monasca_persister Support default_retention_hours for influxdb 2019-11-15 13:47:47 +00:00
perf Fix the misspelling of "available" 2019-01-22 13:32:21 +08:00
playbooks Push Docker image to Docker Hub 2019-04-15 15:04:28 +02:00
releasenotes Support default_retention_hours for influxdb 2019-11-15 13:47:47 +00:00
.coveragerc Add coverage report display 2019-04-05 13:33:43 +02:00
.gitignore Add job for releasenotes 2019-02-19 10:46:25 +00:00
.gitreview OpenDev Migration Patch 2019-04-19 19:26:25 +00:00
.stestr.conf Add .stestr.conf . 2017-09-22 14:13:18 +02:00
.testr.conf Add persister.py unit tests 2017-01-12 09:18:29 +00:00
.zuul.yaml Set job with Java persister non-voting 2019-09-23 12:28:11 +02:00
LICENSE Added copyright header and LICENSE file. 2014-05-01 12:45:08 -06:00
README.rst Deprecate Java implementation 2019-09-17 10:29:34 +02:00
bindep.txt Add bindep.txt 2017-04-12 18:10:55 +02:00
lower-constraints.txt Use Confluent Kafka client 2019-08-15 14:47:51 +02:00
pom.xml Upper pom version to 1.3.0 2017-12-19 13:11:41 -08:00
requirements.txt Use Confluent Kafka client 2019-08-15 14:47:51 +02:00
run_maven.sh Ensure the same branch is used for common build 2016-02-10 15:30:38 -07:00
setup.cfg Exclude influxdb 5.2.3 for python 2019-09-05 14:44:37 +01:00
setup.py Updated from global requirements 2017-03-13 19:34:04 +00:00
test-requirements.txt Change lower-constraints for cassandra-driver 2019-07-04 17:53:48 +02:00
tox.ini Update the constraints url 2019-09-26 13:50:18 +08:00

README.rst

Team and repository tags

image

monasca-persister

The Monasca Persister consumes metrics and alarm state transitions from the Apache Kafka message queue and stores them in the time series database.

Running

To install the Python monasca-persister modules, git clone the source and run the following command:

$ pip install -c https://releases.openstack.org/constraints/upper/master -e ./monasca-persister

To run the unit tests use:

$ tox -e py27,py36

To start the persister run:

$ monasca-persister --config-file=monasca-persister.conf

Configuration

A sample configuration file can be generated using the Oslo standards used in other OpenStack projects.

tox -e genconfig

The result will be in ./etc/monasca/monasca-persister.conf.sample

If the deployment is using the Docker files, the configuration template can be found in docker/monasca-persister.conf.j2.

Java

For information on Java implementation see java/Readme.rst.

Contributing and Reporting Bugs

Ongoing work for the Monasca project is tracked in Storyboard.

License

Copyright (c) 2014 Hewlett-Packard Development Company, L.P.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.