Monasca Database Persister
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
OpenStack Release Bot 9354132284 Update master for stable/train 2 weeks ago
common Replace URLs with URLs 4 months ago
config-generator Update documentation to use new default config 8 months ago
docker Support Kafka_events option in docker evn 2 months ago
etc/monasca Turn logging down from DEBUG in persister-logging.conf 1 year ago
java Deprecate Java implementation 1 month ago
monasca_persister Tool to migrate existing data to db per tenant 2 weeks ago
perf Fix the misspelling of "available" 8 months ago
playbooks Push Docker image to Docker Hub 6 months ago
releasenotes Update master for stable/train 2 weeks ago
.coveragerc Add coverage report display 6 months ago
.gitignore Add job for releasenotes 8 months ago
.gitreview OpenDev Migration Patch 6 months ago
.stestr.conf Add .stestr.conf . 2 years ago
.testr.conf Add unit tests 2 years ago
.zuul.yaml Set job with Java persister non-voting 3 weeks ago
LICENSE Added copyright header and LICENSE file. 5 years ago
README.rst Deprecate Java implementation 1 month ago
bindep.txt Add bindep.txt 2 years ago
lower-constraints.txt Use Confluent Kafka client 2 months ago
pom.xml Upper pom version to 1.3.0 1 year ago
requirements.txt Use Confluent Kafka client 2 months ago Ensure the same branch is used for common build 3 years ago
setup.cfg Exclude influxdb 5.2.3 for python 1 month ago Updated from global requirements 2 years ago
test-requirements.txt Change lower-constraints for cassandra-driver 3 months ago
tox.ini Update the constraints url 3 weeks ago


Team and repository tags



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


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

$ pip install -c -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


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.


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

Contributing and Reporting Bugs

Ongoing work for the Monasca project is tracked in Storyboard.


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

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.