Monasca common classes
Go to file
Habeeb Mohammed 94e0a059b5 Fixed inconfigurable kafka consumer offset location
PROBLEM: Consumer offset was resetting to the latest index rather than the earliest
SOLUTION: Modified consumer creation to include `auto_offset_reset="smallest"` which
	allows the offset to reset to the earliest known index.

NOTE: This does exactly what the whence parameter in SimpleConsumer.seek()
	is expected to do, however in order to achieve this functionality,
	the parameter `auto_offset_reset` MUST be set to either "largest"
	or "smallest".

Change-Id: I887892d80f2da9619c7f11737b3ab2e1d1dacf1e
2017-09-27 14:35:00 -06:00
java Revert "Revert "Release version 1.2.1 for Java"" 2017-02-15 13:43:52 +00:00
monasca_common Fixed inconfigurable kafka consumer offset location 2017-09-27 14:35:00 -06:00
tools Sync tools/tox_install.sh 2016-08-30 20:13:30 +02:00
.coveragerc Migrate to ostestr framework and PY3 2017-03-02 19:51:04 +01:00
.gitignore Migrate to ostestr framework and PY3 2017-03-02 19:51:04 +01:00
.gitreview Update .gitreview for new namespace 2015-10-17 22:30:45 +00:00
.testr.conf Migrate to ostestr framework and PY3 2017-03-02 19:51:04 +01:00
HACKING.rst Change repositories from stackforge to openstack 2015-10-19 09:50:12 +05:30
LICENSE Added license file 2014-05-01 16:22:06 -07:00
README.md Fix links in README.md 2017-06-20 07:13:29 +00:00
bindep.txt Add bindep.txt 2017-04-12 18:16:38 +02:00
mkdocs.yml Change repositories from stackforge to openstack 2015-10-19 09:50:12 +05:30
pom.xml Revert "Revert "Release version 1.2.1 for Java"" 2017-02-15 13:43:52 +00:00
requirements.txt Updated from global requirements 2017-09-13 00:06:29 +00:00
run_maven.sh Fail main maven build if java maven build fails 2015-02-19 12:53:22 -07:00
setup.cfg Migrate to ostestr framework and PY3 2017-03-02 19:51:04 +01:00
setup.py Updated from global requirements 2017-03-02 11:47:03 +00:00
test-blacklist-py3.txt Migrate to ostestr framework and PY3 2017-03-02 19:51:04 +01:00
test-requirements.txt Cleanup test-requirements 2017-09-21 19:12:52 +08:00
tox.ini Add bindep.txt 2017-04-12 18:16:38 +02:00

README.md

Team and repository tags

Team and repository tags

Overview

monasca-common is a collection of sub-projects containing reusable application and platform code for building monitoring related services.

Build Instructions

Download and do mvn install.

$ cd java
$ mvn clean install

There is a pom.xml in the base directory but that should only be used for the StackForge build. The issue is that currently StackForge's bare-precise system only has Maven 2 on it and at least one of the modules of monasca-common requires Maven 3.

In order to get around this problem, the pom.xml in the base directory uses the exec-maven-plugin to run the script run_maven.sh. This script checks if the version of mvn is Maven 3 and if it is not, it downloads Maven 3 and then uses it to run the build in the java directory.

In addition, the run_maven.sh script copies the jar files that get built from java/*/target directories to the target directory in the base project directory. This is because the StackForge "monasca-common-localrepo-upload" job uploads any jar files from that directory to http://tarballs.openstack.org/ci/monasca-common. Copying the jar files to that directory made it so there didn't have to be changes made to the "monasca-common-localrepo-upload" job. The build for monasca-thresh downloads the jars it depends on from that location on tarballs.openstack.org.

A change has been submitted to StackForge to switch to bare-trusty for this build in the hopes that those systems will have maven 3, but it is not known how long that change will take to be accepted.

Application Specific Sub-Projects

Platform Sub-Projects

python monasca-common

To install the python monasca-common modules, git clone the source and run the following command::

$ sudo python setup.py install

To run the python monasca-common tests use::

$ nosetests monasca_common/tests