deb-ceilometer/install-guide/source/verify.rst
Ildiko Vancsa b33f32b714 Add install-guide for ceilometer
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
2016-06-24 15:34:51 +02:00

3.5 KiB

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.

  1. Source the admin credentials to gain access to admin-only CLI commands:

    $ . admin-openrc
  2. List available meters:

    $ 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... |
    +--------------+-------+-------+--------------------------------------+---------+------------+
  3. Download the CirrOS image from the Image service:

    $ IMAGE_ID=$(glance image-list | grep 'cirros' | awk '{ print $2 }')
    $ glance image-download $IMAGE_ID > /tmp/cirros.img
  4. List available meters again to validate detection of the image download:

    $ 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... |
    +----------------+-------+-------+--------------------------------------+---------+------------+
  5. Retrieve usage statistics from the image.download meter:

    $ 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 |
    +--------+---------------------+---------------------+------------+------------+------------+------------+-------+----------+----------------------------+----------------------------+
  6. Remove the previously downloaded image file /tmp/cirros.img:

    $ rm /tmp/cirros.img