Fix doc gate job false success
pbr config was missing from setup.cfg. With adding "warnerrors = true" under '[pbr]' in setup.cfg, the Sphinx build will fail in case of warnings and errors during the build process. This patch also fixes the currently existing problems in the developer documentation of Ceilometer. The unused todo extension was also removed. Fixes-Bug: #1317648 Fixes-Bug: #1321193 Fixes-Bug: #1272845 Change-Id: If1a9d7aca5c1d350568a83fb49bb8ea3defefdca
This commit is contained in:
parent
1fa9302fee
commit
b436ddad47
@ -1,8 +0,0 @@
|
||||
======================
|
||||
Internal API Reference
|
||||
======================
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
|
||||
autoindex
|
@ -47,15 +47,9 @@ Metering
|
||||
If you divide a billing process into a 3 step process, as is commonly done in
|
||||
the telco industry, the steps are:
|
||||
|
||||
1. :term:`Metering` is the process of collecting information about what,
|
||||
who, when and how much regarding anything that can be billed. The result of
|
||||
this is a collection of "tickets" (a.k.a. samples) which are ready to be
|
||||
processed in any way you want.
|
||||
2. :term:`Rating` is the process of analysing a series of tickets,
|
||||
according to business rules defined by marketing, in order to transform
|
||||
them into bill line items with a currency value.
|
||||
3. :term:`Billing` is the process to assemble bill line items into a
|
||||
single per customer bill, emitting the bill to start the payment collection.
|
||||
1. :term:`Metering`
|
||||
2. :term:`Rating`
|
||||
3. :term:`Billing`
|
||||
|
||||
Ceilometer's initial goal was, and still is, strictly limited to step
|
||||
one. This is a choice made from the beginning not to go into rating or billing,
|
||||
|
@ -143,7 +143,6 @@ write_autodoc_index()
|
||||
extensions = [
|
||||
'sphinx.ext.autodoc',
|
||||
'sphinx.ext.intersphinx',
|
||||
'sphinx.ext.todo',
|
||||
'sphinxcontrib.autohttp.flask',
|
||||
'wsmeext.sphinxext',
|
||||
'sphinx.ext.coverage',
|
||||
@ -252,7 +251,7 @@ html_theme_options = {
|
||||
# Add any paths that contain custom static files (such as style sheets) here,
|
||||
# relative to this directory. They are copied after the builtin static files,
|
||||
# so a file named "default.css" will overwrite the builtin "default.css".
|
||||
html_static_path = ['_static']
|
||||
#html_static_path = ['_static']
|
||||
|
||||
# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
|
||||
# using the given strftime format.
|
||||
|
@ -24,4 +24,3 @@
|
||||
areas
|
||||
source
|
||||
plugins
|
||||
../api/index
|
||||
|
@ -30,6 +30,15 @@
|
||||
API server
|
||||
HTTP REST API service for ceilometer.
|
||||
|
||||
billing
|
||||
Billing is the process to assemble bill line items into a single
|
||||
per customer bill, emitting the bill to start the payment collection.
|
||||
|
||||
bus listener agent
|
||||
Bus listener agent which takes events generated on the Oslo
|
||||
notification bus and transforms them into Ceilometer samples. This
|
||||
is the preferred method of data collection.
|
||||
|
||||
ceilometer
|
||||
From Wikipedia [#]_:
|
||||
|
||||
@ -55,21 +64,37 @@
|
||||
data store
|
||||
Storage system for recording data collected by ceilometer.
|
||||
|
||||
http callback
|
||||
HTTP callback is used for calling a predefined URL, whenever an
|
||||
alarm has been set off. The payload of the request contains
|
||||
all the details of why the alarm was triggered.
|
||||
|
||||
log
|
||||
Logging is one of the alarm actions that is useful mostly for debugging,
|
||||
it stores the alarms in a log file.
|
||||
|
||||
meter
|
||||
The measurements tracked for a resource. For example, an instance has
|
||||
a number of meters, such as duration of instance, CPU time used,
|
||||
number of disk io requests, etc.
|
||||
Three types of meters are defined in ceilometer:
|
||||
* Cumulative: Increasing over time (e.g. disk I/O)
|
||||
* Gauge: Discrete items (e.g. floating IPs, image uploads) and fluctuating
|
||||
values (e.g. number of Swift objects)
|
||||
* Delta: Incremental change to a counter over time (e.g. bandwidth delta)
|
||||
|
||||
* Cumulative: Increasing over time (e.g. disk I/O)
|
||||
* Gauge: Discrete items (e.g. floating IPs, image uploads) and fluctuating
|
||||
values (e.g. number of Swift objects)
|
||||
* Delta: Incremental change to a counter over time (e.g. bandwidth delta)
|
||||
|
||||
metering
|
||||
Metering is the process of collecting information about what,
|
||||
who, when and how much regarding anything that can be billed. The result of
|
||||
this is a collection of "tickets" (a.k.a. samples) which are ready to be
|
||||
processed in any way you want.
|
||||
|
||||
notification
|
||||
A message sent via an external OpenStack system (e.g Nova, Glance,
|
||||
etc) using the Oslo notification mechanism [#]_. These notifications
|
||||
are usually sent to and received by Ceilometer through the notifier
|
||||
RPC driver.
|
||||
A message sent via an external OpenStack system (e.g Nova, Glance,
|
||||
etc) using the Oslo notification mechanism [#]_. These notifications
|
||||
are usually sent to and received by Ceilometer through the notifier
|
||||
RPC driver.
|
||||
|
||||
non-repudiable
|
||||
From Wikipedia [#]_:
|
||||
@ -84,6 +109,22 @@
|
||||
project
|
||||
The OpenStack tenant or project.
|
||||
|
||||
polling agents
|
||||
The polling agent is collecting measurements by polling some API or other
|
||||
tool at a regular interval.
|
||||
|
||||
push agents
|
||||
The push agent is the only solution to fetch data within projects,
|
||||
which do not expose the required data in a remotely usable way. This
|
||||
is not the preferred method as it makes deployment a bit more
|
||||
complex having to add a component to each of the nodes that need
|
||||
to be monitored.
|
||||
|
||||
rating
|
||||
Rating is the process of analysing a series of tickets,
|
||||
according to business rules defined by marketing, in order to transform
|
||||
them into bill line items with a currency value.
|
||||
|
||||
resource
|
||||
The OpenStack entity being metered (e.g. instance, volume, image, etc).
|
||||
|
||||
|
@ -17,7 +17,7 @@
|
||||
Welcome to the Ceilometer developer documentation!
|
||||
==================================================
|
||||
|
||||
The :term:`ceilometer` project aims to deliver a unique point of
|
||||
The :term:`Ceilometer` project aims to deliver a unique point of
|
||||
contact for billing systems to acquire all of the measurements they
|
||||
need to establish customer billing, across all current OpenStack core
|
||||
components with work underway to support future OpenStack components.
|
||||
@ -37,7 +37,7 @@ What is the purpose of the project and vision for it?
|
||||
users through a REST API.
|
||||
* The metering messages are signed and :term:`non-repudiable`.
|
||||
|
||||
This documentation offers information on how ceilometer works and how to
|
||||
This documentation offers information on how Ceilometer works and how to
|
||||
contribute to the project.
|
||||
|
||||
Table of contents
|
||||
@ -55,26 +55,7 @@ Table of contents
|
||||
contributing/index
|
||||
releasenotes/index
|
||||
glossary
|
||||
|
||||
.. - installation
|
||||
.. - devstack
|
||||
.. - take content from "initial setup"
|
||||
.. - configuration
|
||||
.. - talk about copying nova config file
|
||||
.. - running the services
|
||||
.. - agent on compute node
|
||||
.. - collector on controller (non-compute) node
|
||||
.. - contributing
|
||||
.. - joining the project (take this from another set of docs?)
|
||||
.. - reporting bugs
|
||||
.. - running tests
|
||||
.. - submitting patches for review
|
||||
.. - writing plugins
|
||||
.. - general plugin-based architecture information
|
||||
.. - reference to setuptools entry points docs
|
||||
.. - pollsters
|
||||
.. - notifications
|
||||
.. - database engine
|
||||
sourcecode/autoindex
|
||||
|
||||
.. update index
|
||||
|
||||
@ -84,8 +65,3 @@ Indices and tables
|
||||
* :ref:`genindex`
|
||||
* :ref:`modindex`
|
||||
* :ref:`search`
|
||||
|
||||
To Do
|
||||
=====
|
||||
|
||||
.. todolist::
|
||||
|
@ -43,7 +43,7 @@ work with a copy of ceilometer installed via devstack.
|
||||
conflicts with Horizon's default configuration.
|
||||
|
||||
3. Modify the ``WSGIDaemonProcess`` directive to set the
|
||||
``user`` and ``group`` values to a user available on your server.
|
||||
``user`` and ``group`` values to a user available on your server.
|
||||
|
||||
4. Modify the ``APACHE_RUN_USER`` and ``APACHE_RUN_GROUP`` values to
|
||||
the name of a user and group available on your server.
|
||||
|
@ -114,11 +114,9 @@ or complete the existing ones.
|
||||
|
||||
The meters below are related to the host machine.
|
||||
|
||||
.. note::
|
||||
|
||||
By default, Nova will not collect the following meters related to the host
|
||||
compute node machine. Nova option 'compute_monitors = ComputeDriverCPUMonitor'
|
||||
should be set in nova.conf to enable meters.
|
||||
.. note:: By default, Nova will not collect the following meters related to the host
|
||||
compute node machine. Nova option 'compute_monitors = ComputeDriverCPUMonitor'
|
||||
should be set in nova.conf to enable meters.
|
||||
|
||||
=============================== ========== ========= ======== ============ ========================
|
||||
Name Type Unit Resource Origin Note
|
||||
|
@ -13,12 +13,14 @@
|
||||
License for the specific language governing permissions and limitations
|
||||
under the License.
|
||||
|
||||
.. _folsom:
|
||||
|
||||
====================
|
||||
Version 0.1 (Folsom)
|
||||
Folsom
|
||||
====================
|
||||
|
||||
This is the first release of ceilometer. Please take all appropriate caution
|
||||
in using it, as it is a technology preview at this time.
|
||||
This is the first release (Version 0.1) of Ceilometer. Please take all appropriate
|
||||
caution in using it, as it is a technology preview at this time.
|
||||
|
||||
Version of OpenStack
|
||||
It is curently tested to work with OpenStack 2012.2 Folsom. Due to its use of
|
||||
|
@ -18,5 +18,13 @@
|
||||
============================
|
||||
|
||||
.. toctree::
|
||||
:hidden:
|
||||
|
||||
folsom
|
||||
|
||||
* :ref:`folsom`
|
||||
* `Havana`_
|
||||
* `Icehouse`_
|
||||
|
||||
.. _Havana: https://wiki.openstack.org/wiki/ReleaseNotes/Havana#OpenStack_Metering_.28Ceilometer.29
|
||||
.. _IceHouse: https://wiki.openstack.org/wiki/ReleaseNotes/Icehouse#Ceilometer
|
||||
|
Loading…
Reference in New Issue
Block a user