6dfd57faf7
Included section 'Metering' in the CLI chapter with some basic commands for listing alarms, meters, statistics etc. Also included the list of commands, optional arguments in the Appendix-Command Reference. Made minor updates according to review comments. Partial-Bug: #1201459 Change-Id: I42b18fea1f8eec2df8d78cb1dd55f4cb03766feb
74 lines
7.1 KiB
XML
74 lines
7.1 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:svg="http://www.w3.org/2000/svg"
|
|
xmlns:html="http://www.w3.org/1999/xhtml" version="5.0"
|
|
xml:id="ceilometer_cli_commands">
|
|
<title>Metering</title>
|
|
<para>Metering is the service that measures cloud resources within OpenStack. It collects information about what, who, when and how much regarding anything that can be billed. For Havana, metering is available to the user using only the CLI.</para>
|
|
<para>As an example, we create a heat autoscaling stack and see some of the ceilometer command outputs.</para>
|
|
<procedure>
|
|
<step><para>Create a heat autoscaling stack, using the following command:</para>
|
|
<screen><prompt>$</prompt> <userinput><?db-font-size 75%?>heat stack-create -f cfn/F17/AutoScalingCeilometer.yaml -P "KeyName=heat_key"</userinput></screen>
|
|
</step>
|
|
<step><para>To see the list of heat resources created, run the following command:</para>
|
|
<screen><prompt>$</prompt> <userinput><?db-font-size 75%?>heat resource-list</userinput></screen>
|
|
<screen><computeroutput><?db-font-size 65%?>
|
|
+--------------------------+-----------------------------------------+-----------------+----------------------+
|
|
| resource_name | resource_type |resource_status | updated_time |
|
|
+--------------------------+-----------------------------------------+-----------------+----------------------+
|
|
| CfnUser | AWS::IAM::User |CREATE_COMPLETE | 2013-10-02T05:53:41Z |
|
|
| WebServerKeys | AWS::IAM::AccessKey |CREATE_COMPLETE | 2013-10-02T05:53:42Z |
|
|
| LaunchConfig | AWS::AutoScaling::LaunchConfiguration |CREATE_COMPLETE | 2013-10-02T05:53:43Z |
|
|
| ElasticLoadBalancer | AWS::ElasticLoadBalancing::LoadBalancer |UPDATE_COMPLETE | 2013-10-02T05:55:58Z |
|
|
| WebServerGroup | AWS::AutoScaling::AutoScalingGroup |CREATE_COMPLETE | 2013-10-02T05:55:58Z |
|
|
| WebServerScaleDownPolicy | AWS::AutoScaling::ScalingPolicy |CREATE_COMPLETE | 2013-10-02T05:56:00Z |
|
|
| WebServerScaleUpPolicy | AWS::AutoScaling::ScalingPolicy |CREATE_COMPLETE | 2013-10-02T05:56:00Z |
|
|
| CPUAlarmHigh | OS::Ceilometer::Alarm |CREATE_COMPLETE | 2013-10-02T05:56:02Z |
|
|
| CPUAlarmLow | OS::Ceilometer::Alarm |CREATE_COMPLETE | 2013-10-02T05:56:02Z |
|
|
+--------------------------+-----------------------------------------+-----------------+----------------------+</computeroutput></screen>
|
|
</step>
|
|
<step><para>To see the list of alarms set, run the following command:</para>
|
|
<screen><prompt>$</prompt> <userinput><?db-font-size 75%?>ceilometer alarm-list</userinput></screen>
|
|
<screen><computeroutput><?db-font-size 65%?>
|
|
+--------------------------------------+------------------------------+-------------------+---------+------------+-------------------------------+
|
|
| Alarm ID | Name | State | Enabled | Continuous | Alarm condition |
|
|
+--------------------------------------+------------------------------+-------------------+---------+------------+-------------------------------+
|
|
| 4f896b40-0859-460b-9c6a-b0d329814496 | as-CPUAlarmLow-i6qqgkf2fubs | insufficient data | True | False | cpu_util < 15.0 during 1x 60s |
|
|
| 75d8ecf7-afc5-4bdc-95ff-19ed9ba22920 | as-CPUAlarmHigh-sf4muyfruy5m | insufficient data | True | False | cpu_util > 50.0 during 1x 60s |
|
|
+--------------------------------------+------------------------------+-------------------+---------+------------+-----------------------------+</computeroutput></screen>
|
|
</step>
|
|
<step><para>To see the list of meters set, run the following command:</para>
|
|
<screen><prompt>$</prompt> <userinput><?db-font-size 75%?>ceilometer meter-list</userinput></screen>
|
|
|
|
<screen><computeroutput><?db-font-size 65%?>
|
|
+--------------------------+------------+----------+-----------------------------------------------------------------------+------------------------------------+
|
|
| Name | Type | Unit | Resource ID | User ID | Project ID |
|
|
+--------------------------+------------+----------+-----------------------------------------------------------------------+------------------------------------+
|
|
| cpu | cumulative | ns | 3965b41b-81b0-4386-bea5-6ec37c8841c1 | d1a2996d3b1f4e0e8645ba9650308011 | bf03bf32e3884d489004ac995ff7a61c |
|
|
| cpu | cumulative | ns | 62520a83-73c7-4084-be54-275fe770ef2c | d1a2996d3b1f4e0e8645ba9650308011 | bf03bf32e3884d489004ac995ff7a61c |
|
|
| cpu_util | gauge | % | 3965b41b-81b0-4386-bea5-6ec37c8841c1 | d1a2996d3b1f4e0e8645ba9650308011 | bf03bf32e3884d489004ac995ff7a61c |
|
|
+--------------------------+------------+----------+-----------------------------------------------------------------------+------------------------------------+</computeroutput></screen>
|
|
</step>
|
|
<step><para>To see the list of samples, run the following command:</para>
|
|
<screen><prompt>$</prompt> <userinput><?db-font-size 75%?>ceilometer sample-list -m cpu_util</userinput></screen>
|
|
<screen><computeroutput><?db-font-size 65%?>
|
|
+--------------------------------------+----------+-------+---------------+------+---------------------+
|
|
| Resource ID | Name | Type | Volume | Unit | Timestamp |
|
|
+--------------------------------------+----------+-------+---------------+------+---------------------+
|
|
| 3965b41b-81b0-4386-bea5-6ec37c8841c1 | cpu_util | gauge | 3.98333333333 | % | 2013-10-02T10:50:12 |
|
|
+--------------------------------------+----------+-------+---------------+------+---------------------+</computeroutput></screen>
|
|
</step>
|
|
<step><para>To see the statistics, run the following command:</para>
|
|
<screen><prompt>$</prompt> <userinput><?db-font-size 75%?>ceilometer statistics -m cpu_util</userinput></screen>
|
|
|
|
<screen><computeroutput><?db-font-size 65%?>
|
|
+--------+---------------------+---------------------+-------+---------------+---------------+---------------+---------------+----------+---------------------+---------------------+
|
|
| Period | Period Start | Period End | Count | Min | Max | Sum | Avg | Duration | Duration Start | Duration End |
|
|
+--------+---------------------+---------------------+-------+---------------+---------------+---------------+---------------+----------+---------------------+---------------------+
|
|
| 0 | 2013-10-02T10:50:12 | 2013-10-02T10:50:12 | 1 | 3.98333333333 | 3.98333333333 | 3.98333333333 | 3.98333333333 | 0.0 | 2013-10-02T10:50:12 | 2013-10-02T10:50:12 |
|
|
+--------+---------------------+---------------------+-------+---------------+---------------+---------------+---------------+----------+---------------------+---------------------+</computeroutput></screen>
|
|
</step>
|
|
</procedure>
|
|
</section> |