openstack-manuals/doc/install-guide/source/ceilometer-nova.rst

Enable Compute service meters

Telemetry uses a combination of notifications and an agent to collect Compute meters. Perform these steps on each compute node.

Install and configure components

obs

1. Install the packages:

   # zypper install openstack-ceilometer-agent-compute

rdo

1. Install the packages:

   # yum install openstack-ceilometer-compute python-ceilometerclient python-pecan

ubuntu or debian

1. Install the packages:

   # apt-get install ceilometer-agent-compute

2. Edit the /etc/ceilometer/ceilometer.conf file and complete the following actions:

   • In the [DEFAULT] and [oslo_messaging_rabbit] sections, configure RabbitMQ message queue access:

     [DEFAULT]
     ...
     rpc_backend = rabbit
     
     [oslo_messaging_rabbit]
     ...
     rabbit_host = controller
     rabbit_userid = openstack
     rabbit_password = RABBIT_PASS

     Replace RABBIT_PASS with the password you chose for the openstack account in RabbitMQ.

   • In the [DEFAULT] and [keystone_authtoken] sections, configure Identity service access:

     [DEFAULT]
     ...
     auth_strategy = keystone
     
     [keystone_authtoken]
     ...
     auth_uri = http://controller:5000
     auth_url = http://controller:35357
     memcached_servers = controller:11211
     auth_type = password
     project_domain_name = default
     user_domain_name = default
     project_name = service
     username = ceilometer
     password = CEILOMETER_PASS

     Replace CEILOMETER_PASS with the password you chose for the Telemetry service database.

   • In the [service_credentials] section, configure service credentials:

     [service_credentials]
     ...
     os_auth_url = http://controller:5000/v2.0
     os_username = ceilometer
     os_tenant_name = service
     os_password = CEILOMETER_PASS
     interface = internalURL
     region_name = RegionOne

     Replace CEILOMETER_PASS with the password you chose for the ceilometer user in the Identity service.

Configure Compute to use Telemetry

• Edit the /etc/nova/nova.conf file and configure notifications in the [DEFAULT] section:

  [DEFAULT]
  ...
  instance_usage_audit = True
  instance_usage_audit_period = hour
  notify_on_state_change = vm_and_task_state
  notification_driver = messagingv2

Finalize installation

obs

1. Start the agent and configure it to start when the system boots:

   # systemctl enable openstack-ceilometer-agent-compute.service
   # systemctl start openstack-ceilometer-agent-compute.service

rdo

1. Start the agent and configure it to start when the system boots:

   # systemctl enable openstack-ceilometer-compute.service
   # systemctl start openstack-ceilometer-compute.service

obs or rdo

2. Restart the Compute service:

   # systemctl restart openstack-nova-compute.service

ubuntu or debian

1. Restart the agent:

   # service ceilometer-agent-compute restart

2. Restart the Compute service:

   # service nova-compute restart