130 lines
3.2 KiB
ReStructuredText
130 lines
3.2 KiB
ReStructuredText
Enable Object Storage meters
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Telemetry uses a combination of polling and notifications to collect
|
|
Object Storage meters.
|
|
|
|
.. note::
|
|
|
|
Your environment must include the Object Storage service.
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
The Telemetry service requires access to the Object Storage service
|
|
using the ``ResellerAdmin`` role. Perform these steps on the controller
|
|
node.
|
|
|
|
#. Source the ``admin`` credentials to gain access to admin-only
|
|
CLI commands.
|
|
|
|
.. code-block:: console
|
|
|
|
$ . admin-openrc
|
|
|
|
#. Create the ``ResellerAdmin`` role:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack role create ResellerAdmin
|
|
+-----------+----------------------------------+
|
|
| Field | Value |
|
|
+-----------+----------------------------------+
|
|
| domain_id | None |
|
|
| id | 462fa46c13fd4798a95a3bfbe27b5e54 |
|
|
| name | ResellerAdmin |
|
|
+-----------+----------------------------------+
|
|
|
|
#. Add the ``ResellerAdmin`` role to the ``ceilometer`` user:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack role add --project service --user ceilometer ResellerAdmin
|
|
|
|
.. note::
|
|
|
|
This command provides no output.
|
|
|
|
Install components
|
|
------------------
|
|
|
|
* Install the packages:
|
|
|
|
.. only:: ubuntu or debian
|
|
|
|
.. code-block:: console
|
|
|
|
# apt-get install python-ceilometermiddleware
|
|
|
|
.. only:: rdo
|
|
|
|
.. code-block:: console
|
|
|
|
# yum install python-ceilometermiddleware
|
|
|
|
.. only:: obs
|
|
|
|
.. code-block:: console
|
|
|
|
# zypper install python-ceilometermiddleware
|
|
|
|
Configure Object Storage to use Telemetry
|
|
-----------------------------------------
|
|
|
|
Perform these steps on the controller and any other nodes that
|
|
run the Object Storage proxy service.
|
|
|
|
* Edit the ``/etc/swift/proxy-server.conf`` file
|
|
and complete the following actions:
|
|
|
|
* In the ``[filter:keystoneauth]`` section, add the
|
|
``ResellerAdmin`` role:
|
|
|
|
.. code-block:: ini
|
|
|
|
[filter:keystoneauth]
|
|
...
|
|
operator_roles = admin, user, ResellerAdmin
|
|
|
|
* In the ``[pipeline:main]`` section, add ``ceilometer``:
|
|
|
|
.. code-block:: ini
|
|
|
|
[pipeline:main]
|
|
pipeline = ceilometer catch_errors gatekeeper healthcheck proxy-logging cache container_sync bulk ratelimit authtoken keystoneauth container-quotas account-quotas slo dlo versioned_writes proxy-logging proxy-server
|
|
|
|
* In the ``[filter:ceilometer]`` section, configure notifications:
|
|
|
|
.. code-block:: ini
|
|
|
|
[filter:ceilometer]
|
|
paste.filter_factory = ceilometermiddleware.swift:filter_factory
|
|
...
|
|
control_exchange = swift
|
|
url = rabbit://openstack:RABBIT_PASS@controller:5672/
|
|
driver = messagingv2
|
|
topic = notifications
|
|
log_level = WARN
|
|
|
|
Replace ``RABBIT_PASS`` with the password you chose for the
|
|
``openstack`` account in ``RabbitMQ``.
|
|
|
|
Finalize installation
|
|
---------------------
|
|
|
|
.. only:: rdo or obs
|
|
|
|
* Restart the Object Storage proxy service:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl restart openstack-swift-proxy.service
|
|
|
|
.. only:: ubuntu or debian
|
|
|
|
* Restart the Object Storage proxy service:
|
|
|
|
.. code-block:: console
|
|
|
|
# service swift-proxy restart
|