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