b33f32b714
This adds ceilometer-specific contents of the OpenStack Installation Guide in the ceilometer repo per [1]. A separate change will remove the ceilometer contents from the OpenStack Installation Guide for Newton per [2]. The ceilometer install-guide structure is based on Install Guide Cookiecutter [3]. Also adds tox.ini environment for install-guide and adds openstackdocs-theme to test-requirements.txt. [1] http://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html [2] http://specs.openstack.org/openstack/docs-specs/specs/newton/installguide.html [3] https://review.openstack.org/#/c/314229/ Partially-Implements: blueprint projectspecificinstallguide Change-Id: Iffc5d7243e9eeb74c9dd7b559ef3de7123269293
71 lines
3.5 KiB
ReStructuredText
71 lines
3.5 KiB
ReStructuredText
.. _verify:
|
|
|
|
Verify operation
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
Verify operation of the Telemetry service. These steps only include the
|
|
Image service meters to reduce clutter. Environments with ceilometer
|
|
integration for additional services contain more meters.
|
|
|
|
.. note::
|
|
|
|
Perform these steps on the controller node.
|
|
|
|
#. Source the ``admin`` credentials to gain access to
|
|
admin-only CLI commands:
|
|
|
|
.. code-block:: console
|
|
|
|
$ . admin-openrc
|
|
|
|
#. List available meters:
|
|
|
|
.. code-block:: console
|
|
|
|
$ ceilometer meter-list
|
|
+--------------+-------+-------+--------------------------------------+---------+------------+
|
|
| Name | Type | Unit | Resource ID | User ID | Project ID |
|
|
+--------------+-------+-------+--------------------------------------+---------+------------+
|
|
| image | gauge | image | acafc7c0-40aa-4026-9673-b879898e1fc2 | None | cf12a15... |
|
|
| image.size | gauge | B | acafc7c0-40aa-4026-9673-b879898e1fc2 | None | cf12a15... |
|
|
+--------------+-------+-------+--------------------------------------+---------+------------+
|
|
|
|
#. Download the CirrOS image from the Image service:
|
|
|
|
.. code-block:: console
|
|
|
|
$ IMAGE_ID=$(glance image-list | grep 'cirros' | awk '{ print $2 }')
|
|
$ glance image-download $IMAGE_ID > /tmp/cirros.img
|
|
|
|
#. List available meters again to validate detection of the image
|
|
download:
|
|
|
|
.. code-block:: console
|
|
|
|
$ ceilometer meter-list
|
|
+----------------+-------+-------+--------------------------------------+---------+------------+
|
|
| Name | Type | Unit | Resource ID | User ID | Project ID |
|
|
+----------------+-------+-------+--------------------------------------+---------+------------+
|
|
| image | gauge | image | acafc7c0-40aa-4026-9673-b879898e1fc2 | None | cf12a15... |
|
|
| image.download | delta | B | acafc7c0-40aa-4026-9673-b879898e1fc2 | None | cf12a15... |
|
|
| image.serve | delta | B | acafc7c0-40aa-4026-9673-b879898e1fc2 | None | cf12a15... |
|
|
| image.size | gauge | B | acafc7c0-40aa-4026-9673-b879898e1fc2 | None | cf12a15... |
|
|
+----------------+-------+-------+--------------------------------------+---------+------------+
|
|
|
|
#. Retrieve usage statistics from the ``image.download`` meter:
|
|
|
|
.. code-block:: console
|
|
|
|
$ ceilometer statistics -m image.download -p 60
|
|
+--------+---------------------+---------------------+------------+------------+------------+------------+-------+----------+----------------------------+----------------------------+
|
|
| Period | Period Start | Period End | Max | Min | Avg | Sum | Count | Duration | Duration Start | Duration End |
|
|
+--------+---------------------+---------------------+------------+------------+------------+------------+-------+----------+----------------------------+----------------------------+
|
|
| 60 | 2015-04-21T12:21:45 | 2015-04-21T12:22:45 | 13200896.0 | 13200896.0 | 13200896.0 | 13200896.0 | 1 | 0.0 | 2015-04-21T12:22:12.983000 | 2015-04-21T12:22:12.983000 |
|
|
+--------+---------------------+---------------------+------------+------------+------------+------------+-------+----------+----------------------------+----------------------------+
|
|
|
|
#. Remove the previously downloaded image file ``/tmp/cirros.img``:
|
|
|
|
.. code-block:: console
|
|
|
|
$ rm /tmp/cirros.img
|