Mahmoud Abouzeid 40323f7428 doc: Warn that aggregation_method must match the archive policy

The gnocchi collector's aggregation_method defaults to "max", but the
archive policies Ceilometer creates by default (e.g. ceilometer-low)
only compute mean/rate:mean. With that combination Gnocchi 404s every
measures query and CloudKitty silently skips the metric, so a
first-time deployment rates nothing and gives no error. Document the
constraint next to the option so operators align metrics.yml with
their archive policies.
Closes-Bug: #2160102
"default/documented aggregation_method: max incompatible with
Ceilometer default archive policies — silent no-rating"; no existing
report found 2026-07-07)
Change-Id: Ida01f5af62aca46f16b0fdf03d621b67781d52b1
Signed-off-by: Mahmoud Abouzeid <abouzeid@momentumx.cloud>

2026-07-08 09:41:31 +03:00

2026-01-06 19:31:43 +09:00

2026-07-06 09:15:28 +00:00

2025-05-30 12:00:50 +09:00

2026-04-22 07:42:31 +02:00

2026-07-08 09:41:31 +03:00

2026-05-12 19:17:43 +00:00

2026-05-04 20:00:03 +00:00

2026-01-06 21:14:18 +09:00

2019-04-19 19:29:58 +00:00

2018-07-18 08:00:06 +07:00

2026-05-18 19:48:25 +09:00

2021-05-18 10:03:01 +02:00

2026-01-09 14:12:23 +00:00

2014-06-07 09:14:06 +02:00

2026-05-04 20:00:03 +00:00

2025-04-29 22:54:15 +00:00

2026-03-31 10:12:25 +00:00

2026-05-03 08:24:22 +02:00

2026-01-28 14:10:07 +00:00

2026-03-31 00:28:19 +09:00

2026-04-21 14:59:37 +02:00

Rating as a Service component

Goal

CloudKitty aims at filling the gap between metrics collection systems like ceilometer and a billing system.

Every metrics are collected, aggregated and processed through different rating modules. You can then query CloudKitty's storage to retrieve processed data and easily generate reports.

Most parts of CloudKitty are modular so you can easily extend the base code to address your particular use case.

You can find more information on its architecture in the documentation, architecture section.

Status

CloudKitty has been successfully deployed in production on different OpenStack systems.

You can find the latest documentation on documentation.

Contributing

We are welcoming new contributors, if you've got new ideas, suggestions or want to contribute contact us.

You can reach us thought IRC (#cloudkitty @ oftc.net), or on the official OpenStack mailing list openstack-discuss@lists.openstack.org.

A storyboard is available if you need to report bugs.

Additional components

We're providing an OpenStack dashboard (Horizon) integration, you can find the files in the cloudkitty-dashboard repository.

A CLI is available too in the python-cloudkittyclient repository.

Trying it

CloudKitty can be deployed with DevStack, more information can be found in the devstack section of the documentation.

Deploying it in production

CloudKitty can be deployed in production on OpenStack environments, for more information check the installation section of the documentation.

Getting release notes

Release notes can be found in the release notes section of the documentation.

Contributing to CloudKitty

For information on how to contribute to CloudKitty, please see the contents of the CONTRIBUTING.rst.

Any new code must follow the development guidelines detailed in the HACKING.rst file, and pass all unit tests.