Forge Home


Puppet module for OpenStack Ceilometer


9,239 latest version

3.1 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 5.2.0 (latest)
  • 5.1.0
  • 5.0.0
released Oct 2nd 2015
This version is compatible with:
  • Puppet Enterprise 3.x
  • Puppet 3.x
  • , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'stackforge-ceilometer', '5.2.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add stackforge-ceilometer
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install stackforge-ceilometer --version 5.2.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



stackforge/ceilometer — version 5.2.0 Oct 2nd 2015


5.2.0 - 2014.2 - Juno

Table of Contents

  1. Overview - What is the ceilometer module?
  2. Module Description - What does the module do?
  3. Setup - The basics of getting started with ceilometer
  4. Implementation - An under-the-hood peek at what the module is doing
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module
  7. Contributors - Those with commits
  8. Release Notes - Notes on the most recent updates to the module


The ceilometer module is part of Stackforge, an effort by the OpenStack infrastructure team to provice continuous integration testing and code review for OpenStack and OpenStack community projects not part of the core software. The module itself is used to flexibly configure and manage the metering service for OpenStack.

Module Description

The ceilometer module is an attempt to make Puppet capable of managing the entirety of ceilometer. This includes manifests to provision the ceilometer api, agents, and database stores. A ceilometer_config type is supplied to assist in the manipulation of configuration files.


What the ceilometer module affects

  • ceilometer, the metering service for OpenStack

Installing ceilometer

example% puppet module install puppetlabs/ceilometer

Beginning with ceilometer



ceilometer is a combination of Puppet manifests and Ruby code to deliver configuration and extra functionality through types and providers.


  • The ceilometer modules have only been tested on RedHat and Ubuntu family systems.


Developer documentation for the entire puppet-openstack project


This is the ceilometer module.

Release Notes


  • Add an ability to manage use_stderr parameter


  • Add support for configuring coordination/backend_url
  • crontab: ensure the script is run with shell
  • Implement Ceilometer-API as a WSGI process support
  • Switch to TLSv1
  • Pin puppetlabs-concat to 1.2.1 in fixtures
  • Change default MySQL collate to utf8_general_ci
  • Update .gitreview file for project rename
  • spec: updates for rspec-puppet 2.x and rspec 3.x


  • Stable Juno release
  • Added package_ensure parameters to various classes to control package installation
  • Added ceilometer::policy to control policy.json
  • Updated validate_re expressions for Puppet 3.7
  • Bumped stdlib dependency to >=4.0.0
  • Added manage_service parameters to various classes to control whether the service was managed, as well as added enabled parameters where not already present
  • Added parameters to control whether to configure keystone users
  • Added the ability to override the keystone service name in ceilometer::keystone::auth
  • Migrated the ceilometer::db::mysql class to use openstacklib::db::mysql and deprecated the mysql_module parameter
  • Fixed ceilometer-notification package name for RHEL
  • Removed deprecation notices for sectionless ceilometer_config types for Juno release
  • Added ability to hide secrets from puppet logs


  • Fixed dependency on nova-common package
  • Added new class for extended logging options
  • Fixed ssl parameter requirements for kombu and rabbit
  • Fixed mysql_grant call
  • Fixed ceilometer-collecter service relationships when service is disabled


  • Added RabbitMQ SSL Support.
  • Fixed dependency cycle bug.
  • Fixed agent_notification_service_name.
  • Changed default mysql charset to UTF8.
  • Pinned major gems.


  • Stable Icehouse release.
  • Added ability to override notification topics.
  • Implemented notification agent service.
  • Fixed region name configuration.
  • Fixed ensure packages bug.
  • Added support for puppetlabs-mysql 2.2 and greater.
  • Introduced ceilometer::config to handle additional custom options.


  • Removed enforcement of glance_control_exchange.
  • Fixed user reference in db.pp.
  • Allow db fields configuration without need for dbsync for better replicaset support.
  • Fixed alarm package parameters Debian/Ubuntu.


  • Fixed package ceilometer-alarm type error on Debian.
  • Remove log_dir from params and make logs configurable in init.
  • Removed glance_notifications from notification_topic.
  • Don't match commented [DEFAULT] section.


  • Initial release of the puppet-ceilometer module.


Apache License 2.0

Copyright 2012 eNovance

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.