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.
Hervé Beraud 37411e792a Add doc/requirements 2 years ago
common Replace URLs with URLs 4 years ago
config-generator Update documentation to use new default config 4 years ago
doc Add doc/requirements 2 years ago
docker Set legacy_kafka_client_enabled = False on default for Docker 2 years ago
etc/monasca Turn logging down from DEBUG in persister-logging.conf 4 years ago
java Deprecate Java implementation 3 years ago
monasca_persister Add doc/requirements 2 years ago
perf Fix the misspelling of "available" 4 years ago
playbooks Push Docker image to Docker Hub 4 years ago
releasenotes Update master for stable/victoria 2 years ago
.coveragerc Add coverage report display 4 years ago
.gitignore Add job for releasenotes 4 years ago
.gitreview OpenDev Migration Patch 4 years ago
.stestr.conf Add .stestr.conf . 5 years ago
.zuul.yaml Add Python3 wallaby unit tests 2 years ago
LICENSE Added copyright header and LICENSE file. 9 years ago
README.rst Change README.rst with a better title 3 years ago
bindep.txt Add bindep.txt 6 years ago
lower-constraints.txt Add doc/requirements 2 years ago
pom.xml Update links in pom.xml 5 years ago
requirements.txt Remove six 2 years ago Ensure the same branch is used for common build 7 years ago
setup.cfg [goal] Migrate testing to ubuntu focal 2 years ago Cleanup py27 support 3 years ago
test-requirements.txt Add doc/requirements 2 years ago
tox.ini Add doc/requirements 2 years ago


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.


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 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.