doc/source/api.rst


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

The :mod:`ceilometerclient` Python API
======================================

.. module:: ceilometerclient
   :synopsis: A client for the OpenStack Ceilometer API.

.. currentmodule:: ceilometerclient

Usage
-----

First create a client instance with your credentials::

    >>> import ceilometerclient.client
    >>> cclient = ceilometerclient.client.get_client(VERSION, username=USERNAME, password=PASSWORD, tenant_name=PROJECT_NAME, auth_url=AUTH_URL)

Here ``VERSION`` can be: ``1`` and ``2``.

Then call methods on its managers::

    >>> cclient.meters.list()
    [<Meter ...>, ...]

    >>> cclient.samples.list()
    [<Sample ...>, ...]

V2 client tips
++++++++++++++

Use queries to narrow your search (more info at `Ceilometer V2 API reference`__)::

    >>> query = [dict(field='resource_id', op='eq', value='5a301761-f78b-46e2-8900-8b4f6fe6675a')]
    >>> ceilometer.samples.list(meter_name='cpu_util', limit=10, q=query)
    [<Sample ...>, ...]

__  http://docs.openstack.org/developer/ceilometer/webapi/v2.html#Query

Reference
---------

For more information, see the reference:

.. toctree::
   :maxdepth: 2

   ref/index
   ref/v1/index
   ref/v2/index