b7e8323f63
This adds support for pdf documentation generation. Work items: * Provide a distinct index for pdf doc. This is required as the toctree in a tab fails to render as a pdf document. * Remove the v2 API reference from the pdf documentation. "rest_expand_all", "rest_method" and "rest_parameters" are not supported. * Add a pdf-docs tox env * Update conf.py Story: 2006075 Task: 34808 Change-Id: I848d59b551fe6d5077960dc45554c7281c2372a7
60 lines
2.1 KiB
ReStructuredText
60 lines
2.1 KiB
ReStructuredText
What is CloudKitty ?
|
|
====================
|
|
|
|
CloudKitty is a **Rating-as-a-Service** project for OpenStack and more.
|
|
The project aims at being a **generic** solution for the chargeback and rating
|
|
of a cloud. Historically, it was only possible to operate it inside of an
|
|
OpenStack context, but it is now possible to run CloudKitty in standalone mode.
|
|
|
|
CloudKitty allows to do metric-based rating: it polls endpoints in order to
|
|
retrieve measures and metadata about specific metrics, applies rating rules to
|
|
the collected data and pushes the rated data to its storage backend.
|
|
|
|
CloudKitty is highly modular, which makes it easy to add new features.
|
|
|
|
.. only:: html
|
|
|
|
.. note::
|
|
|
|
**We're looking for contributors!** If you want to contribute, please have
|
|
a look at the `developer documentation`_ .
|
|
|
|
.. _developer documentation: developer/index.html
|
|
|
|
What can be done with CloudKitty ? What can't ?
|
|
===============================================
|
|
|
|
**With Cloudkitty, it is possible to:**
|
|
|
|
- Collect metrics from OpenStack (through Gnocchi and Monasca) or from
|
|
somewhere else (through Gnocchi in standalone mode and Prometheus). Metric
|
|
collection is **highly customizable**.
|
|
|
|
- Apply rating rules to the previous metrics through the `hashmap`_ module or
|
|
`custom scripts`_. This is all done via CloudKitty's API.
|
|
|
|
- Retrieve the rated information through the API, grouped by scope and/or by
|
|
metric type.
|
|
|
|
**However, it is not possible to:**
|
|
|
|
- Limit resources in other OpenStack services once a certain limit has been
|
|
reached. Ex: block instance creation in Nova above a certain price.
|
|
Cloudkitty does **rating and only rating**.
|
|
|
|
- Add taxes, convert between currencies, etc... This needs to be done by a
|
|
billing software. CloudKitty associates a price to a metric for a given
|
|
period, but the price's unit is what you decide it to be: euros, dollars,
|
|
cents, squirrels...
|
|
|
|
.. _custom scripts: user/rating/pyscripts.html
|
|
|
|
.. _roadmap: developer/roadmap.html
|
|
|
|
What changes/features are to expect ?
|
|
=====================================
|
|
|
|
If you're interested in CloudKitty's evolution, see the project's `roadmap`_ .
|
|
|
|
.. _hashmap: user/rating/hashmap.html
|