Jump to: navigation, search


OpenStack Telemetry

Project Mission

To reliably collect data on the utilization of the physical and virtual resources comprising deployed clouds, persist these data for subsequent retrieval and analysis, and trigger actions when defined criteria are met.


The telemetry requirements of an OpenStack environment are vast and varied, they include use cases such as metering, monitoring, and alarming to name a few. The scope of these uses cases is diverse and beyond the scope of a single project and team. Currently, the telemetry project provides a set of functionality split across multiple projects; each project designed to provide a discrete service in the telemetry space.


The current set of projects are managed by the telemetry team are:

Specs https://github.com/openstack/ceilometer-specs
Admin doc http://docs.openstack.org/admin-guide-cloud/telemetry.html
Meetings https://etherpad.openstack.org/p/telemetry-meeting-agenda


Aodh's goal is to enable the ability to trigger actions based on defined rules against sample or event data collected by Ceilometer

Source code https://github.com/openstack/aodh
Bug tracker https://bugs.launchpad.net/aodh
Docs https://docs.openstack.org/aodh/latest/
Tarballs http://tarballs.openstack.org/aodh/


Ceilometer's goal is to efficiently collect, normalize and transform data produced by OpenStack services. The data it collects is intended to be used to create different views and help solve various telemetry use cases. Aodh and Gnocchi are two examples of services extending Ceilometer data.

Source code https://github.com/openstack/ceilometer
Bug tracker https://bugs.launchpad.net/ceilometer
Docs https://docs.openstack.org/ceilometer/latest/
Tarballs http://tarballs.openstack.org/ceilometer/

Externally Managed (Non-OpenStack)


Gnocchi's goal is to provide a time-series resource indexing, metric storage service which enables users to capture OpenStack resources and the metrics associated with them. Using rolling aggregation set by user-defined archival policies, it's aim is to provide a scalable means of storing both short and long term data and provide a statistical view based on the input data (ie. Ceilometer)

Source code https://github.com/gnocchixyz/gnocchi
Bug tracker https://github.com/gnocchixyz/gnocchi/issues
Docs http://gnocchi.xyz
Tarballs https://pypi.python.org/pypi/gnocchi

Externally Managed

  • Heat - Orchestration service which provides autoscaling capabilities using Ceilometer data.
  • Horizon - UI service which allows interaction with Aodh data.
  • PowerVM - PowerVM pollster plugin. Owners: thorst and efried. IRC: #openstack-powervm
  • CloudKitty - OpenStack Rating as a Service component and usage reporting.
  • Graphite Publisher - Ceilometer publisher to connect to Graphite.
  • Watcher - Resource optimization service.
  • Cyclops - Rating-Charging-Billing Solution for Cloud providers.
  • Collectd-openstack-plugins - A Collectd writer plugin to publish telemetry to Ceilometer, Aodh and Gnocchi.
  • Collectd-gnocchi - A Collectd writer plugin to publish telemetry to Gnocchi.

Road Map

The future direction and plans of the project can be found https://etherpad.openstack.org/p/telemetry-train-roadmap. Feel free to pick up a task if something interests you. Anyone is free to propose their own ideas in a patch as well.

Contributing to Telemetry

The developer documentation can be found in each projects respective documentation page.

The telemetry project team hangs out on Freenode in the #openstack-telemetry channel, feel free to drop by and stay as long as you want. We use the OpenStack Developers List for our email discussions. If you want to make a post relevant to multiple projects in telemetry space, please tag the subject with [telemetry]. If you have a post regarding a single project, please tag the subject with the appropriate tag: [aodh] or [ceilometer].


Ping one of the contributors listed here on the IRC #openstack-telemetry channel on OFTC or email the openstack-discuss@lists.openstack.org mailing list with the prefix [telemetry]

  • Matthias Runge, mrunge on IRC, <mrunge@redhat.com> - PTL
  • Lingxian Kong (lxkong) - core reviewer
  • Rong Zhu (zhurong) - core reviewer


  • Adrian Turjak (adriant)
  • Florian Engelmann (engel75)
  • Joseph Davis (joadavis)
  • Rafael Weingärtner (rafaelweingartne)
  • Shaoman Zhang (shaoman)