---
title: Charmhub | Deploy Ceilometer using Charmhub - The Open Operator Collection
description: Deploy the latest version of Ceilometer on any cloud.
url: https://charmhub.io/ceilometer/configurations
---

# Ceilometer

[OpenStack Charmers](https://charmhub.io/publisher/openstack-charmers "View all packages from OpenStack Charmers")

* [OpenStack Charmers](https://charmhub.io/publisher/openstack-charmers "View all packages from OpenStack Charmers")
* [Cloud](https://charmhub.io/?filter=cloud)
* [Logging Tracing](https://charmhub.io/?filter=logging-tracing)

Platform:

24.04

23.10

23.04

22.10

22.04

20.04

18.04

14.04

12.04

yoga/stable 631

```
juju deploy ceilometer --channel yoga/stable
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

* [action-managed-upgrade](https://charmhub.io/ceilometer/configurations#action-managed-upgrade)
* [debug](https://charmhub.io/ceilometer/configurations#debug)
* [dns-ha](https://charmhub.io/ceilometer/configurations#dns-ha)
* [enable-all-pollsters](https://charmhub.io/ceilometer/configurations#enable-all-pollsters)
* [event-time-to-live](https://charmhub.io/ceilometer/configurations#event-time-to-live)
* [events-publisher](https://charmhub.io/ceilometer/configurations#events-publisher)
* [gnocchi-archive-policy](https://charmhub.io/ceilometer/configurations#gnocchi-archive-policy)
* [ha-bindiface](https://charmhub.io/ceilometer/configurations#ha-bindiface)
* [ha-mcastport](https://charmhub.io/ceilometer/configurations#ha-mcastport)
* [haproxy-client-timeout](https://charmhub.io/ceilometer/configurations#haproxy-client-timeout)
* [haproxy-connect-timeout](https://charmhub.io/ceilometer/configurations#haproxy-connect-timeout)
* [haproxy-queue-timeout](https://charmhub.io/ceilometer/configurations#haproxy-queue-timeout)
* [haproxy-server-timeout](https://charmhub.io/ceilometer/configurations#haproxy-server-timeout)
* [harden](https://charmhub.io/ceilometer/configurations#harden)
* [metering-time-to-live](https://charmhub.io/ceilometer/configurations#metering-time-to-live)
* [nagios\_context](https://charmhub.io/ceilometer/configurations#nagios_context)
* [nagios\_servicegroups](https://charmhub.io/ceilometer/configurations#nagios_servicegroups)
* [openstack-origin](https://charmhub.io/ceilometer/configurations#openstack-origin)
* [os-admin-hostname](https://charmhub.io/ceilometer/configurations#os-admin-hostname)
* [os-admin-network](https://charmhub.io/ceilometer/configurations#os-admin-network)
* [os-internal-hostname](https://charmhub.io/ceilometer/configurations#os-internal-hostname)
* [os-internal-network](https://charmhub.io/ceilometer/configurations#os-internal-network)
* [os-public-hostname](https://charmhub.io/ceilometer/configurations#os-public-hostname)
* [os-public-network](https://charmhub.io/ceilometer/configurations#os-public-network)
* [pipeline-yaml](https://charmhub.io/ceilometer/configurations#pipeline-yaml)
* [polling-batch-size](https://charmhub.io/ceilometer/configurations#polling-batch-size)
* [polling-interval](https://charmhub.io/ceilometer/configurations#polling-interval)
* [rabbit-user](https://charmhub.io/ceilometer/configurations#rabbit-user)
* [rabbit-vhost](https://charmhub.io/ceilometer/configurations#rabbit-vhost)
* [region](https://charmhub.io/ceilometer/configurations#region)
* [remote-sink](https://charmhub.io/ceilometer/configurations#remote-sink)
* [ssl\_ca](https://charmhub.io/ceilometer/configurations#ssl_ca)
* [ssl\_cert](https://charmhub.io/ceilometer/configurations#ssl_cert)
* [ssl\_key](https://charmhub.io/ceilometer/configurations#ssl_key)
* [use-internal-endpoints](https://charmhub.io/ceilometer/configurations#use-internal-endpoints)
* [use-syslog](https://charmhub.io/ceilometer/configurations#use-syslog)
* [verbose](https://charmhub.io/ceilometer/configurations#verbose)
* [vip](https://charmhub.io/ceilometer/configurations#vip)
* [worker-multiplier](https://charmhub.io/ceilometer/configurations#worker-multiplier)
* [wsgi-socket-rotation](https://charmhub.io/ceilometer/configurations#wsgi-socket-rotation)

[Learn about configurations >](https://juju.is/docs/juju/configuration#heading--application-configuration)

* action-managed-upgrade | boolean

  If True enables openstack upgrades for this charm via juju actions.
  You will still need to set openstack-origin to the new repository but
  instead of an upgrade running automatically across all units, it will
  wait for you to execute the openstack-upgrade action for this charm on
  each unit. If False it will revert to existing behavior of upgrading
  all units on config change.
* debug | boolean

  Enable debug logging.
* dns-ha | boolean

  Use DNS HA with MAAS 2.0. Note if this is set do not set vip settings
  below.
* enable-all-pollsters | boolean

  From Pike onwards, the default ceilometer pollster collection runs a
  limited set of pollsters. Enable this to run all the available pollsters.
  This setting only takes effect from Queens onwards.
* event-time-to-live | int

  Default: -1

  Number of seconds that events are kept in the database for (<= 0 means
  infinite).
* events-publisher | string

  Default: aodh

  As of the Queens release ceilometer no longer consumes events on the
  event.sample queue. Valid options here include "aodh" or "gnocchi" and
  if you want to disable publishing events you can specify an empty string
  "". The default is set to aodh for backwards compatibility. Note this
  setting has no impact on the remote-sink option and is ignored prior to
  Queens.
* gnocchi-archive-policy | string

  Default: low

  Archive retention policy to use when Ceilometer is deployed with
  Gnocchi for resource, metric and measures storage.
* ha-bindiface | string

  Default: eth0

  Default network interface on which HA cluster will bind to communication
  with the other members of the HA Cluster.
* ha-mcastport | int

  Default: 5403

  Default multicast port number that will be used to communicate between
  HA Cluster nodes.
* haproxy-client-timeout | int

  Client timeout configuration in ms for haproxy, used in HA
  configurations. If not provided, default value of 90000ms is used.
* haproxy-connect-timeout | int

  Connect timeout configuration in ms for haproxy, used in HA
  configurations. If not provided, default value of 9000ms is used.
* haproxy-queue-timeout | int

  Queue timeout configuration in ms for haproxy, used in HA
  configurations. If not provided, default value of 9000ms is used.
* haproxy-server-timeout | int

  Server timeout configuration in ms for haproxy, used in HA
  configurations. If not provided, default value of 90000ms is used.
* harden | string

  Apply system hardening. Supports a space-delimited list of modules
  to run. Supported modules currently include os, ssh, apache and mysql.
* metering-time-to-live | int

  Default: -1

  Number of seconds that samples are kept in the database for (<= 0 means
  infinite).
* nagios\_context | string

  Default: juju

  Used by the nrpe-external-master subordinate charm. A string that will
  be prepended to instance name to set the host name in nagios. So for
  instance the hostname would be something like 'juju-myservice-0'. If
  you are running multiple environments with the same services in them
  this allows you to differentiate between them.
* nagios\_servicegroups | string

  A comma-separated list of nagios service groups.
  If left empty, the nagios\_context will be used as the servicegroup
* openstack-origin | string

  Default: yoga

  Repository from which to install. May be one of the following:
  distro (default), ppa:somecustom/ppa, a deb url sources entry,
  or a supported Ubuntu Cloud Archive e.g.
  .
  cloud:<series>-<openstack-release>
  cloud:<series>-<openstack-release>/updates
  cloud:<series>-<openstack-release>/staging
  cloud:<series>-<openstack-release>/proposed
  .
  See https://wiki.ubuntu.com/OpenStack/CloudArchive for info on which
  cloud archives are available and supported.
  .
  NOTE: updating this setting to a source that is known to provide
  a later version of OpenStack will trigger a software upgrade unless
  action-managed-upgrade is set to True.
* os-admin-hostname | string

  The hostname or address of the admin endpoints created for ceilometer
  in the keystone identity provider.
  .
  This value will be used for admin endpoints. For example, an
  os-admin-hostname set to 'ceilometer.admin.example.com' with ssl enabled
  will create the following admin endpoints for ceilometer:
  .
  https://ceilometer.admin.example.com:8777/
* os-admin-network | string

  The IP address and netmask of the OpenStack Admin network (e.g.
  192.168.0.0/24)
  .
  This network will be used for admin endpoints.
* os-internal-hostname | string

  The hostname or address of the internal endpoints created for ceilometer
  in the keystone identity provider.
  .
  This value will be used for internal endpoints. For example, an
  os-internal-hostname set to 'ceilometer.internal.example.com' with ssl
  enabled will create the following internal endpoints for ceilometer:
  .
  https://ceilometer.internal.example.com:8777/
* os-internal-network | string

  The IP address and netmask of the OpenStack Internal network (e.g.
  192.168.0.0/24)
  .
  This network will be used for internal endpoints.
* os-public-hostname | string

  The hostname or address of the public endpoints created for ceilometer
  in the keystone identity provider.
  .
  This value will be used for public endpoints. For example, an
  os-public-hostname set to 'ceilometer.example.com' with ssl enabled will
  create the following public endpoints for ceilometer:
  .
  https://ceilometer.example.com:8777/
* os-public-network | string

  The IP address and netmask of the OpenStack Public network (e.g.
  192.168.0.0/24)

  This network will be used for public endpoints.
* pipeline-yaml | string

  When set the content is written to /etc/ceilometer/pipeline.yaml, by
  default the package's file is used.
* polling-batch-size | int

  Default: 50

  The number of measures from same pollster to batch together for sending
  to the notification agent and then to the publisher. Set to 0 to disable.
  This config is only effective for OpenStack release Rocky or newer.
* polling-interval | int

  Default: 300

  Number of seconds between Ceilometer central agent pollster collections.
  This setting only takes effect from Queens onwards.
* rabbit-user | string

  Default: ceilometer

  Username to request access on rabbitmq-server.
* rabbit-vhost | string

  Default: openstack

  RabbitMQ virtual host to request access on rabbitmq-server.
* region | string

  Default: RegionOne

  OpenStack region name.
* remote-sink | string

  Space delimited list of remote consumers of Ceilometer event reporting
  which reside outside of the deployed model. Only supported for Mitaka
  and later clouds. e.g.
  .
  'udp://<host>:<port>/'
  'prometheus://pushgateway-host:9091/metrics/job/openstack-telemetry'
* ssl\_ca | string

  SSL CA to use with the certificate and key provided - this is only
  required if you are providing a privately signed ssl\_cert and ssl\_key.
* ssl\_cert | string

  SSL certificate to install and use for API ports. Setting this value
  and ssl\_key will enable reverse proxying, point Ceilometer's entry in the
  Keystone catalog to use https, and override any certificate and key
  issued by Keystone (if it is configured to do so).
* ssl\_key | string

  SSL key to use with certificate specified as ssl\_cert.
* use-internal-endpoints | boolean

  OpenStack mostly defaults to using public endpoints for
  internal communication between services. If set to True this option
  will configure services to use internal endpoints where possible.
* use-syslog | boolean

  Setting this to True will allow supporting services to log to syslog.
* verbose | boolean

  Enable verbose logging.
* vip | string

  Virtual IP(s) to use to front API services in HA configuration.
  .
  If multiple networks are being used, a VIP should be provided for each
  network, separated by spaces.
* worker-multiplier | float

  The CPU core multiplier to use when configuring worker processes for
  this service. By default, the number of workers for each daemon is set
  to twice the number of CPU cores a service unit has. This default
  value will be capped to 4 workers unless this configuration option
  is set.
* wsgi-socket-rotation | boolean

  Default: True

  Allow users to disable Apache wsgi socket rotation. If not configured,
  this option sets True as the default value, which is consistent with the
  default value 'WSGISocketRotation On' in Apache. This option should be
  used with caution. Please read the Apache doc page for more information.
