cloudkitty/doc/source/common-index.rst
Luka Peschke b7e8323f63 Add support for PDF doc generation
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
2019-09-16 15:42:55 +02:00

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