Metadata-Version: 2.1
Name: monasca-persister
Version: 9.0.1.dev2
Summary: Moves metrics and alarm state transitions from the Message Queue to the Metrics and Alarms database.
Home-page: https://opendev.org/openstack/monasca-persister
Author: OpenStack
Author-email: openstack-discuss@lists.openstack.org
License: Apache
Keywords: openstack monitoring storage
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Topic :: System :: Monitoring
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.6
Requires-Dist: cassandra-driver (>=3.21.0)
Requires-Dist: monasca-common (>=2.16.0)
Requires-Dist: oslo.config (>=5.2.0)
Requires-Dist: oslo.log (>=3.36.0)
Requires-Dist: simplejson (>=3.8.1)
Provides-Extra: cassandra
Requires-Dist: cassandra-driver (>=3.21.0) ; extra == 'cassandra'
Provides-Extra: elasticsearch
Requires-Dist: elasticsearch (<3.0.0,>=2.0.0) ; extra == 'elasticsearch'
Provides-Extra: influxdb
Requires-Dist: influxdb (>=2.9.2) ; extra == 'influxdb'
Provides-Extra: test
Requires-Dist: bandit (>=1.1.0) ; extra == 'test'
Requires-Dist: cassandra-driver (>=3.21.0) ; extra == 'test'
Requires-Dist: coverage (!=4.4,>=4.0) ; extra == 'test'
Requires-Dist: hacking (<3.1.0,>=3.0.1) ; extra == 'test'
Requires-Dist: oslotest (>=3.2.0) ; extra == 'test'
Requires-Dist: pycodestyle (>=2.5.0) ; extra == 'test'
Requires-Dist: stestr (>=1.0.0) ; extra == 'test'

Monasca Persister
=================

.. image:: https://governance.openstack.org/tc/badges/monasca-persister.svg
    :target: https://governance.openstack.org/tc/reference/tags/index.html

.. Change things from this point on

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


.. _Storyboard: https://storyboard.openstack.org



