Monasca REST API
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.
OpenDev Sysadmins 26133aefe4 OpenDev Migration Patch 1 month ago
api-ref Prepare foundation for doc migration 1 year ago
common Restore user condition but with zuul 1 year ago
config-generator Add keystonemiddleware to oslo-config-generator conf 3 months ago
contrib Remove bundled intree monasca-api tempest plugin 1 year ago
devstack Improve devstack vagrantfile 1 month ago
doc Replace api-config.conf with monasca-api.conf 4 months ago
docker Merge "Improve Docker README file" 1 month ago
docs Update /v2/alarms/count api endpoint 1 month ago
etc Enable uWSGI support in devstack 11 months ago
java [Trivial Fix] change the unicode of some higher numbered characters 8 months ago
monasca_api cassandra cluster no load-balancing policy 1 month ago
perf Add read performance testing to monasca-api 1 year ago
playbooks Fix docker hub login variable 3 months ago
releasenotes cassandra cluster no load-balancing policy 1 month ago
tools Avoid tox_install.sh for constraints support 1 year ago
.coveragerc Migrate test run to ostestr 2 years ago
.gitignore Add .stestr.conf . 1 year ago
.gitreview OpenDev Migration Patch 1 month ago
.stestr.conf Add .stestr.conf . 1 year ago
.testr.conf Migrate test run to ostestr 2 years ago
.zuul.yaml OpenDev Migration Patch 1 month ago
LICENSE Added license file 5 years ago
README.rst README.rst: make it us-ascii 2 months ago
babel.cfg initial python implementation 4 years ago
bindep.txt Add libssl to fix pep8 1 year ago
lower-constraints.txt Merge "Add "monasca-status upgrade check" for pre-upgrade" 6 months ago
pom.xml Update links in pom.xml 1 year ago
requirements.txt Add "monasca-status upgrade check" for pre-upgrade 6 months ago
run_maven.sh Ensure the same branch is used for common build 3 years ago
setup.cfg Dropping the py35 testing 1 month ago
setup.py Updated from global requirements 2 years ago
test-requirements.txt Switch to using stestr 11 months ago
tox.ini Replace api-config.conf with monasca-api.conf 4 months ago

README.rst

Team and repository tags

image

Overview

monasca-api is a RESTful API server that is designed with a layered architecture.

Documentation

The full API Specification can be found in docs/monasca-api-spec.md

Python Monasca API Implementation

To install the python api implementation, git clone the source and run the following command:

$ sudo python setup.py install

If it installs successfully, you will need to make changes to the following two files to reflect your system settings, especially where kafka server is located:

/etc/monasca/api-config.ini
/etc/monasca/monasca-api.conf
/etc/monasca/api-logging.conf

Once the configuration files are modified to match your environment, you can start up the server by following the following instructions.

To start the server, run the following command:

Running the server in foreground mode
$ gunicorn -k eventlet --worker-connections=2000 --backlog=1000 --paste /etc/monasca/api-config.ini

Running the server as daemons
$ gunicorn -k eventlet --worker-connections=2000 --backlog=1000 --paste /etc/monasca/api-config.ini -D

To check if the code follows python coding style, run the following command from the root directory of this project

$ tox -e pep8

To run all the unit test cases, run the following command from the root directory of this project

$ tox -e py27

Start the Server - for Apache

To start the server using Apache: create a modwsgi file, create a modwsgi configuration file, and enable the wsgi module in Apache.

The modwsgi configuration file may look something like this, and the site will need to be enabled:

The wsgi file may look something like this:

Java Implementation

Details on usage can be found here

WARNING: The Java implementation of Monasca API is DEPRECATED and will be removed in future release.

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.