4.10 Setting up Ceilometer

Ceilometer is a telemetry service that collects, normalizes and transforms data produced by OpenStack services. Ceilometer is disabled by default.

Ceilometer requires a database to operate. Oracle recommends that you use a separate database for Ceilometer. The choice of database system, and how it is configured, is up to you. A database must be created and available on the network. Oracle recommends using MySQL for this purpose. For information on installing MySQL see:

http://dev.mysql.com/doc/refman/5.7/en/installing.html

To set up Ceilometer:

If you do not have a dedicated database for Ceilometer, create the database. For example, using MySQL you could use the following MySQL commands to create the database and user:
```
mysql> create database ceilometer;
mysql> grant all privileges on ceilometer.* to 'ceilometer'@'%' identified by 'password';
```
In this example, the database is named ceilometer, with a user named ceilometer. These are the default settings for the deployment property settings.
Use the kollacli property set command to set the Ceilometer database deployment properties. These properties are used to create the Ceilometer database connection string.
ceilometer_database_backend
The database type, either mysql or mongodb. The default is mysql.
ceilometer_database_address
The fully qualified host name or IP address of the database host.
If you do not have a dedicated database for Ceilometer, the default MySQL Cluster database on the first controller node should be used. In this case, set this value to be the host name or IP address of the first controller node.
The default is the value of the kolla_internal_address property. If you leave it as the default, it is highly likely that Ceilometer will fail to collect all data and will not produce correct or expected results.
ceilometer_database_port
The database port, usually 3306 for MySQL or 27017 for MongoDB. The default is 3306.
ceilometer_database_name
The name of the Ceilometer database. The default is ceilometer.
ceilometer_database_user
The name of the Ceilometer database user. The default is ceilometer.
In this example, MySQL is used as the Ceilometer database. A MySQL database has been created named ceilometer, with a database user named ceilometer, and MySQL is available on port 3306 on ceilometerdbhost.example.com. As the database is set up using the defaults for the Ceilometer database deployment property settings, all that is required is to set the host on which the database is running:
```
$ kollacli property set ceilometer_database_address ceilometerdbhost.example.com
```
Add the password for the Ceilometer database user:
```
$ kollacli password set ceilometer_database_password
```
You are prompted to enter and confirm the password. The password value is not displayed on screen. You might want to use a strong password generator to generate the passwords.

Enable the Ceilometer service:

$ kollacli property set enable_ceilometer yes