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

Verify the Telemetry installation

This section describes how to verify operation of the Telemetry module.

Note

Perform these steps on the controller node.

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

   $ source admin-openrc.sh

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... |
   | image.update | delta | image | acafc7c0-40aa-4026-9673-b879898e1fc2 | None    | cf12a15... |
   | image.upload | delta | image | acafc7c0-40aa-4026-9673-b879898e1fc2 | None    | cf12a15... |
   +--------------+-------+-------+--------------------------------------+---------+------------+

3. Download an 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... |
   | image.update   | delta | image | acafc7c0-40aa-4026-9673-b879898e1fc2 | None    | cf12a15... |
   | image.upload   | delta | image | 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