From fe5e84f6a71d85339e7194cc4a4ee341c0be9005 Mon Sep 17 00:00:00 2001 From: Denis Poisson Date: Wed, 20 Jun 2018 11:53:21 +0200 Subject: [PATCH] Convert README.md to ReStructuredTest format Change-Id: Ic2ae9acab65a54e2fcab9581dad97b1d9e990425 story: 2002163 task: 22257 --- README.md | 70 ------------------------------------ README.rst | 103 +++++++++++++++++++++++++++++++++++++++++++++++++++++ setup.cfg | 2 +- 3 files changed, 104 insertions(+), 71 deletions(-) delete mode 100644 README.md create mode 100644 README.rst diff --git a/README.md b/README.md deleted file mode 100644 index 92ffd695..00000000 --- a/README.md +++ /dev/null @@ -1,70 +0,0 @@ -Team and repository tags -======================== - -[![Team and repository tags](https://governance.openstack.org/tc/badges/monasca-persister.svg)](https://governance.openstack.org/tc/reference/tags/index.html) - - - -monasca-persister -============= - -The Monitoring Persister consumes metrics and alarm state transitions from the Message Queue and stores them in the Metrics and Alarms database. - -Although the Persister isn't primarily a Web service it uses DropWizard, https://dropwizard.github.io/dropwizard/, which provides a nice Web application framework to expose an http endpoint that provides an interface through which metrics about the Persister can be queried as well as health status. - -The basic design of the Persister is to have one Kafka consumer publish to a Disruptor, https://github.com/LMAX-Exchange/disruptor, that has output processors. The output processors use prepared batch statements to write to the Metrics and Alarms database. - -The number of output processors/threads in the Persister can be specified to scale to more messages. To horizontally scale and provide fault-tolerance any number of Persisters can be started as consumers from the Message Queue. - -# Build - -Requires monasca-common from https://github.com/openstack/monasca-common. Download and build following instructions in its README.md. Then build monasca-persister by: - -``` -mvn clean package -``` - -# Configuration - -A sample configuration file is available in java/src/deb/etc/persister-config.yml-sample. - -A second configuration file is provided in java/src/main/resources/persister-config.yml for use with the [vagrant "mini-mon" development environment](https://github.com/openstack/monasca-vagrant/). - -# TODO - -* Purge metrics on shutdown -* Add more robust offset management in Kafka. Currently, the offset is advanced as each message is read. If the Persister stops after the metric has been read and prior to it being committed to the Metrics and Alarms database, the metric will be lost. -* Add better handling of SQL exceptions. -* Complete health check. -* Specify and document the names of the metrics that are available for monitoring of the Persister. -* Document the yaml configuration parameters. - -# 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. - - -Python -====== - -To install the Python monasca-persister modules, git clone the source and run the -following command: - - $ sudo python setup.py install - -To run the unit tests use: - - $ tox -e py27,py35 diff --git a/README.rst b/README.rst new file mode 100644 index 00000000..d56f208f --- /dev/null +++ b/README.rst @@ -0,0 +1,103 @@ +Team and repository tags +======================== + +.. 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 + +monasca-persister +================= + +The Monitoring Persister consumes metrics and alarm state transitions +from the Message Queue and stores them in the Metrics and Alarms +database. + +Although the Persister isn’t primarily a Web service it uses DropWizard, +https://dropwizard.github.io/dropwizard/, which provides a nice Web +application framework to expose an http endpoint that provides an +interface through which metrics about the Persister can be queried as +well as health status. + +The basic design of the Persister is to have one Kafka consumer publish +to a Disruptor, https://github.com/LMAX-Exchange/disruptor, that has +output processors. The output processors use prepared batch statements +to write to the Metrics and Alarms database. + +The number of output processors/threads in the Persister can be +specified to scale to more messages. To horizontally scale and provide +fault-tolerance any number of Persisters can be started as consumers +from the Message Queue. + +Build +===== + +Requires monasca-common from +https://github.com/openstack/monasca-common. Download and build +following instructions in its README.md. Then build monasca-persister +by: + +:: + + mvn clean package + +Configuration +============= + +A sample configuration file is available in +java/src/deb/etc/persister-config.yml-sample. + +A second configuration file is provided in +java/src/main/resources/persister-config.yml for use with the `vagrant +“mini-mon” development environment`_. + +TODO +==== + +- Purge metrics on shutdown +- Add more robust offset management in Kafka. Currently, the offset is + advanced as each message is read. If the Persister stops after the + metric has been read and prior to it being committed to the Metrics + and Alarms database, the metric will be lost. +- Add better handling of SQL exceptions. +- Complete health check. +- Specify and document the names of the metrics that are available for + monitoring of the Persister. +- Document the yaml configuration parameters. + +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. + +Python +====== + +To install the Python monasca-persister modules, git clone the source +and run the following command: + +:: + + $ sudo python setup.py install + +To run the unit tests use: + +:: + + $ tox -e py27,py35 + +.. _vagrant “mini-mon” development environment: https://github.com/openstack/monasca-vagrant/ \ No newline at end of file diff --git a/setup.cfg b/setup.cfg index 76702f1e..6858bb00 100644 --- a/setup.cfg +++ b/setup.cfg @@ -8,7 +8,7 @@ classifier= License :: OSI Approved :: Apache Software License Topic :: System :: Monitoring keywords = openstack monitoring storage -description-file = README.md +description-file = README.rst home-page = https://github.com/openstack/monasca-persister license = Apache